API
CLUB

异步任务与作品

视频模型以任务方式运行。提交得到任务 ID，轮询状态，成功后获取作品地址。

查看价格获取 API 密钥

调用流程

提交时按最大可能用量预扣费用。任务成功后按上游回传的实际用量多退少补；失败时全额退回。

步骤接口
提交任务各模型页面的提交接口
查询状态GET /v1/tasks/{task_id}
获取作品列表GET /v1/tasks/{task_id}/artifacts
下载作品GET /v1/tasks/{task_id}/artifacts/{key}/content

查询任务状态

查询
curl 'https://code.exgravity.ai/v1/tasks/TASK_ID' \
  -H "Authorization: Bearer $UIKA_API_KEY"
响应
{
  "task_id": "task_xxx",
  "platform": "doubao",
  "status": "IN_PROGRESS",
  "progress": "45%",
  "fail_reason": "",
  "created_at": 1793500000,
  "finished_at": 0
}
status含义
SUBMITTED / QUEUED已提交，等待上游处理
IN_PROGRESS生成中，progress 为进度百分比
SUCCESS已完成，可获取作品
FAILURE失败，fail_reason 为原因，预扣费用自动退回

建议每 3–5 秒查询一次，视频通常需要 1–5 分钟。请求超时不代表任务失败，请继续查询同一个任务 ID，不要重复提交。

获取作品

作品列表
curl 'https://code.exgravity.ai/v1/tasks/TASK_ID/artifacts' \
  -H "Authorization: Bearer $UIKA_API_KEY"
响应
{
  "task_id": "task_xxx",
  "artifacts": [
    {
      "key": "video",
      "type": "video",
      "mime_type": "video/mp4",
      "content_url": "/v1/tasks/task_xxx/artifacts/video/content"
    }
  ]
}

content_url 是相对路径，拼接服务地址后下载，下载时携带同一个 API 密钥。部分模型还会返回 last_frame（尾帧图片）。

下载视频
curl -L 'https://code.exgravity.ai/v1/tasks/TASK_ID/artifacts/video/content' \
  -H "Authorization: Bearer $UIKA_API_KEY" -o result.mp4