多元探索 API多元探索 API
OpenAI Format

Kling Task Status Query

Use `GET /v1/videos/{task_id}` to query Kling video task status and use `GET /v1/videos/{task_id}/content` to fetch the generated video.

GEThttps://zx1.deepwl.net/v1/videos/{task_id}
Request
curl https://zx1.deepwl.net/v1/videos/video_123 \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{
  "id": "task_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6",
  "object": "video",
  "model": "kling-3.0-omni-720p-noref-audio",
  "status": "processing",
  "progress": 50,
  "created_at": 1774494511
}

After a Kling series task is submitted, query the task status and results via GET /v1/videos/{task_id}; once completed, fetch the generated video via GET /v1/videos/{task_id}/content.

The gateway aligns with the AigcVideoTask of the upstream DescribeTaskDetail:

  • Status: upstream WAITING / PROCESSING / FINISH / ABORTED is normalized into unified task statuses (such as queued, processing, completed, failed in the responses)
  • Progress: read from AigcVideoTask.Progress
  • Error: read from ErrCode / ErrCodeExt / Message
  • Video URL: read from AigcVideoTask.Output.FileInfos[].FileUrl first, and surfaced as metadata.url and video_url in the response

Request Headers

Authorizationstring必填

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

Query Parameters

task_idstring必填

Task ID, which is the same as the id or task_id returned by the generation endpoint.

Request Examples

Response Examples

Response Fields

idstring

Task ID.

objectstring

Always video.

modelstring

Model name.

statusstring

Task status; common values include queued, processing, completed, failed, and cancelled.

progressinteger

Progress percentage (0-100).

created_atinteger

Creation time (Unix timestamp).

completed_atinteger

Completion time (Unix timestamp), returned only when the task is completed.

metadataobject

Metadata.

urlstring

Video URL (in metadata).

video_urlstring

Video URL (same as metadata.url).