多元探索 API多元探索 API

Get Task Status

Query the execution progress and result of the unified video task interface, and learn the corresponding OpenAI video-compatible query path.

GEThttps://zx1.deepwl.net/v1/video/generations/{task_id}
Request
curl https://zx1.deepwl.net/v1/video/generations/task-video-abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task-video-abc123",
    "status": "queued",
    "url": "",
    "format": "mp4",
    "metadata": null,
    "error": null
  }
}

This endpoint is used to query the status of asynchronous tasks submitted through the unified video task entry point. The returned structure is wrapped with code, message, and data.

  • The query targets the platform-exposed task_id, not the upstream real task ID.
  • A successful response always returns code = success.
  • Suitable for use together with /v1/video/generations.
  • The same task can also be queried via /v1/videos/{task_id} in the OpenAI video object format.

Request Headers

Authorizationstring必填

Authentication header. Uses a Bearer token, e.g. Bearer YOUR_API_KEY.

Query Parameters

task_idstring必填

The public task ID returned by the unified video task entry point.

Request Examples

Response Examples

Response Fields

codestring

Business status code. Fixed as success on success.

messagestring

Error or supplementary information. Usually an empty string on success.

dataobject

Response data container.

task_idstring

Task ID.

statusstring

Task status. Common values are queued, processing, succeeded, and failed.

urlstring

Final video result URL. Some channels may return a platform proxy URL.

errorobject

Error details for failed tasks.

Use Cases

Poll Until Completion

It is recommended to poll every 5 to 10 seconds until status becomes succeeded or failed.

Switch to the OpenAI Query Structure

If the client is already parsing results according to the OpenAI video object, you can directly query:

curl https://zx1.deepwl.net/v1/videos/task-video-abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Notes

/v1/video/generations/{task_id} and /v1/videos/{task_id} query the same type of video task, but return different structures. The former is a unified task wrapper, while the latter is an OpenAI video object.