Sozdai LogoDocs
接口/Media

查询媒体任务

用任务 id 查询异步媒体任务的状态与结果。轮询此接口，直到 status 为 succeeded 或 failed。

GEThttps://api.sozdai.ai/v1/media/generations/{id}

#认证

所有请求在 Authorization 请求头携带你的密钥。

http
Authorization: Bearer sk-corr-...

#路径参数

参数类型必填说明
idstring是创建任务接口返回的任务 id。

#请求示例

bash
curl https://api.sozdai.ai/v1/media/generations/task_abc123 \
  -H "Authorization: Bearer $CORRY_KEY"

#响应

返回任务对象。常见字段如下：

字段类型说明
idstring查询媒体任务 id
statusstring任务状态：queued / submitted / succeeded / failed / timeout。
typestring媒体类型：image / video / music。
modelstring你请求的模型名。
result.urlsstring[]成功时存在，result.urls 为永久文件 URL 数组。
errorstring任务失败时的错误信息。
coststring本次任务扣费金额 —— 美元字符串（如 "0.1200"），配合 currency 字段。
响应示例
{
  "id": "task_abc123",
  "status": "running",
  "type": "image",
  "model": "gpt-image-2"
}

#status 取值

status说明
queued已入队，等待开始。
running上游正在生成。
succeeded已完成，result.urls 可用。
failed失败，见 error；冻结额度已自动退还。

succeeded

成功时存在，result.urls 为永久文件 URL 数组。

#错误码

状态码含义
401密钥无效或缺失
404请求的模型不存在或不可用
json
{
  "error": {
    "message": "Task not found",
    "type": "not_found"
  }
}