HopBase DocsGet 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: 30 days for Seedance and Grok, 6 hours for Kling and MiniMax. Download and save them before they expire. 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 30 days 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
Amount actually deducted from the balance for this task (ledger currency)
Ledger currency, currently CNY
Amount in CNY
Amount in USD (fixed 1 USD = 6.8 CNY)
mmt… / kt…
queued → processing → completed | failed; only the last two are terminal, treat any other value as in progress
Output URL; valid for 6 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
Amount actually deducted for this task
Ledger currency
Errors
missing_api_key / invalid_api_key / api_key_expired)