OmwAIOmwAI
API GuideAPI ReferenceProgramming Tools
Seedance Video

Query Result

Query a Seedance video generation task

After submitting any supported Seedance task, query it with GET /v1/video/generations/{task_id}. This endpoint returns a gateway task envelope, with the task details under data:

  • data.status=NOT_START: not started;
  • data.status=IN_PROGRESS: being processed;
  • data.status=SUCCESS: finished; the video URL is in data.result_url;
  • data.status=FAILURE: failed; see data.fail_reason.

The successful response has the top-level fields code, message, and data. data.data preserves the upstream task result, including upstream status, duration, resolution, usage, and the upstream video URL. Prefer the gateway-provided data.result_url for clients.

GET
/v1/video/generations/{task_id}

Authorization

BearerAuth

AuthorizationBearer <token>

使用 OmwAI API Key 认证。

In: header

Path Parameters

task_id*string

提交接口返回的任务 ID。

Response Body

application/json

curl -X GET "https://www.omwai.xyz/v1/video/generations/string"
{
  "code": "success",
  "message": "",
  "data": {
    "id": 0,
    "created_at": 0,
    "updated_at": 0,
    "task_id": "string",
    "platform": "45",
    "status": "NOT_START",
    "progress": "100%",
    "fail_reason": "string",
    "result_url": "http://example.com",
    "submit_time": 0,
    "start_time": 0,
    "finish_time": 0,
    "properties": {},
    "data": {}
  }
}
Empty

Video URL

After completion, use data.result_url. This is usually a signed temporary URL and may expire, so download or preserve the video promptly.

How is this guide?

Last updated on