AI Studio API

タスク状態を確認

生成タスクをポーリングし、待機・実行・成功・失敗を処理します。

API Playground

このサイトへ実際のリクエストを送信し、HTTP レスポンスを確認できます。

GET

レスポンス

リクエストを送信すると、ここにレスポンスが表示されます。

タスク進行状態

待機中・生成中・完了・失敗など、現在の進行状況を示します。

queued

running

succeeded

failed

GET/api/ai-studio/tasks/{taskId}

作成後にtaskIdとstatusSupported=trueが返った場合、タスク進行状況を確認します。

Request Headers

Authorization: Bearer YOUR_API_KEY

Request Parameters

Name	Type	Required	Default	Options	Description
taskId	string	Yes	-	-	生成開始後に返るタスク ID です。

Request

curl -X GET "https://freesoragenerator.com/api/ai-studio/tasks/provider-task-id" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Example

{
  "success": true,
  "data": {
    "generationId": "b6a7f5c4-8a7c-4e2b-8cf6-6b8d9b3d8d21",
    "taskId": "provider-task-id",
    "modelId": "video:sora2-text-to-video-standard",
    "state": "running",
    "mediaUrls": [],
    "raw": {},
    "reservedCredits": 20,
    "refundedCredits": 0
  }
}

Error Example

{
  "success": false,
  "error": "Generation record not found"
}