AI Studio API

查询任务状态

轮询生成任务，并处理排队、运行、成功和失败状态。

API Playground

直接向当前站点发送真实请求，并立即查看 HTTP 响应。

GET

响应结果

发送请求后，响应内容会显示在这里。

任务进度状态

这些状态用于判断任务是排队中、生成中、已完成还是失败。

queued

running

succeeded

failed

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

创建任务后拿到 taskId 且 statusSupported=true 时，用于查询任务进度。

请求头

Authorization: Bearer YOUR_API_KEY

请求参数

参数名	类型	必填	默认值	可选值	说明
taskId	string	是	-	-	创建任务后返回的任务 ID。

请求示例

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

响应示例

{
  "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
  }
}

错误示例

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