Query Video Task

GET

https://api.apipod.ai/v1/videos/status/{task_id}

task

Last modified:2026-04-10 12:22:35

Query the create video task status and results. This is a unified query interface that works with all images models.

This endpoint is applicable to all video generation models, including sora-2, veo3, seedance, etc., as well as any image models to be added in the future.

Task Status

Status	Description	Action
`pending`	Task is waiting to be processed	Continue polling
`processing`	Task is being processed	Continue polling
`completed`	Task execution completed	Directly obtain results from the `result` array list
`failed`	Task execution failed	Check `code` and `message` for details
`cancelled`	Task has been cancelled	Task cancelled, exit without further processing

Polling Practice

Recommended polling interval

Use callbacks instead of polling

Process completed tasks

Example: Complete polling process

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200成功

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.apipod.ai/v1/videos/status/' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "code": 200,
    "message": "success",
    "data": {
        "task_id": "2f0392df-7da1-4128-8e30-7ea3d81446b3",
        "status": "completed",
        "result": [
            "https://s.apipod.ai/videos/demo.mp4"
        ],
        "completed_at": 1775137415
    }
}

Modified at 2026-04-10 12:22:35

Sora 2 Official API

NanoBanana

Query Video Task

Task Status#

Polling Practice#

Example: Complete polling process#

Request

Responses

Task Status

Polling Practice

Example: Complete polling process