多元探索 API多元探索 API
Official Format

Query Task

Use `GET /v2/query/video_generation/{task_id}` to query the status and result of a MiniMax-H3 official-format video generation, regeneration, or H3-Context-IR task.

GEThttps://zx1.deepwl.net/v2/query/video_generation/{task_id}
Request
curl https://zx1.deepwl.net/v2/query/video_generation/426586401755526 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Response
{
  "task": {
    "id": "426586401755526",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785702855,
    "updated_at": 1785702884,
    "content": {
      "prompt": "integrated_multimodal_description: [Shot 1] Cinematic, wide shot with a slow push in on a female captain standing alone at a massive observation window. The last fleet is assembling and jumping away, with bright light flashes and bridge shaking, leaving her behind."
    },
    "duration": 5,
    "usage": {
      "total_tokens": 9090,
      "prompt_tokens": 5664,
      "completion_tokens": 3426
    },
    "ratio": "16:9",
    "task_type": "h3_context_ir",
    "modality": "text"
  }
}

Query the task status and result based on the task_id returned by Create Video (Official Format). Applies to video generation, video regeneration, and H3-Context-IR tasks.

Request Headers

Authorizationstring必填

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

Acceptstring

Response content type; may be set to application/json.

Query Parameters

task_idstring必填

Task ID, consistent with the task_id returned by the creation endpoint.

Request Examples

Response Examples

Response Fields

taskobject

Task data.

idstring

Task ID.

modelstring

Model name, e.g. MiniMax-H3.

statusstring

Task status: processing (in progress), succeeded (success), failed (failure).

created_atinteger

Task creation time, Unix timestamp (seconds).

updated_atinteger

Task update time, Unix timestamp (seconds).

contentobject

Task result content, which differs by task type:

  • h3_context_ir tasks: prompt is the enhanced multimodal description text
  • Video generation/regeneration tasks: url is a temporary signed link to the generated video (limited validity; download or save it promptly)
durationinteger

Target video duration (seconds).

usageobject

Usage statistics, which differ by task type:

  • h3_context_ir tasks: total_tokens, prompt_tokens, completion_tokens
  • Video generation/regeneration tasks: total_seconds, input_seconds, output_seconds, input_image_count
ratiostring

Aspect ratio, e.g. 16:9; returned for H3-Context-IR tasks.

resolutionstring

Output resolution, e.g. 2K; returned for video generation/regeneration tasks.

task_typestring

Task type: h3_context_ir (H3-Context-IR prompt enhancement), generation (video generation).

modalitystring

Task modality: text, video.

errorobject

Error object (returned only when status=failed), containing message and code.