跳到导航

Get Video Task

Returns the current status of a video task (generation or editing). Tasks belong to the API key that created them; querying another key’s task returns 403. Task records are kept for 24 hours and return 404 afterwards. Poll every 3~10 seconds until the task reaches a terminal state (completed / failed). When the upstream query is temporarily unreachable, the gateway returns the cached status without blocking task progress. On failure, pre-deducted fees are automatically refunded.

身份验证

AuthorizationBearer

Use Authorization: Bearer $JOY_TOKEN_API_KEY.

路径参数

task_idstring必需
The task id returned by the creation endpoint.

响应

Current task status.
task_idstring
Task id.
statusenum

Task state; stop polling once completed or failed.

允许的值:
modelstring
The actually selected model name.
progressinteger0-100

Progress percentage, 0~100.

createdlong

Unix timestamp (seconds) of task creation.

result_urlstring可选格式: "uri"

Present when completed. Upstream result URL, time-limited; download promptly or use GET /openai/v1/videos/{task_id}/content.

durationdouble可选

Present when completed. Actual video length in seconds (may be fractional).

completed_atlong可选

Present when completed. Unix timestamp (seconds) of task completion.

errorobject可选

错误

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
405
Method Not Allowed Error
503
Service Unavailable Error