Get video task
Poll the status and result URLs of a single video task (and Kling and Midjourney image tasks).
/v1/video/tasks/{task_id}Poll with the task ID returned at submission, ideally every 5 seconds; polling uses no concurrency and is not billed. Seedance / Grok responses are wrapped in task, while MiniMax / Kling use top-level fields; do not read the wrong level.
A Seedance task still unfinished 24 hours after creation is automatically marked failed (not billed), with task.error.message set to The task did not finish within 24 hours and was terminated automatically. Result URLs are signed URLs under api.hop-base.com; querying again returns the same URL and does not renew it: every result link is valid for 24 hours from task completion (Seedance, Grok, Kling, MiniMax alike). Download and save results promptly. Unfinished tasks are marked failed after 24 hours (Seedance) or 2 hours (Kling, MiniMax).
Headers
Bearer sk-…: an API key created in the console under API keys; its group must include the requested model
Path parameters
Task ID returned at submission: vt… (Seedance / Grok), mmt… (MiniMax), kt… (Kling)
Returns
200Task object (including failed tasks)
Task
vt…
Model ID
Only these four values; read outputs only when completed
Valuespendingprocessingcompletedfailed
Output duration in seconds; for auto-duration tasks, read it after completion
Output URLs (array of strings, not {url} objects); signed api.hop-base.com URLs valid for 24 hours from completion, not renewed; expired URLs return 410
Optional, present only when the last frame is available; re-signed on every query
Optional; tokens, not a monetary amount
Tokens billed for this task
Total
On failure {"message": "<English failure reason>"}; links are replaced with [URL_REDACTED]
RFC 3339
null while unfinished
Present only after the task ends, and returned only to the key that created the task. 0 means it failed and was not charged
The charge for this task in CNY (the same charge as cost_usd)
The USD amount actually deducted from your balance for this task, the same as its usage record
The currency of cost, always CNY
mmt… / kt…
queued → processing → completed | failed; only the last two are terminal, treat any other value as in progress
Output URL; valid for 24 hours from completion, not renewed; expired URLs return 410
Failure reason; Kling includes a stable error.code (such as input_sensitive, generation_failed)
English description
Kling only
Billing details + amount charged
MiniMax billing tier
MiniMax billed seconds
MiniMax reference video input seconds
MiniMax reference images beyond the free allowance
The charge for this task in CNY (the same charge as cost_usd)
The USD amount actually deducted from your balance for this task, the same as its usage record
The currency of cost, always CNY
Errors
missing_api_key / invalid_api_key / api_key_expired)