查询视频任务

GET

https://aiapi.gway.dev/v1/videos/{task_id}

保存并使用创建响应中的本站公开任务ID。queued/in_progress时继续轮询，completed/failed停止。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

返回响应

🟢200

application/json

成功；任务创建不代表完成。

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠429

🔴500

🔴502

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://aiapi.gway.dev/v1/videos/' \
--header 'Authorization: Bearer <token>'

响应示例

200 - 示例 1

{
    "id": "video-abc123",
    "task_id": "string",
    "object": "video",
    "model": "sora",
    "status": "queued",
    "progress": 100,
    "created_at": 0,
    "completed_at": 0,
    "expires_at": 0,
    "seconds": "string",
    "size": "string",
    "remixed_from_video_id": "string",
    "error": {
        "message": "string",
        "code": "string"
    },
    "metadata": {
        "url": "string",
        "property1": "string",
        "property2": "string"
    }
}

修改于 2026-11-10 11:05:01

创建视频任务（兼容入口）

读取视频内容