获取视频任务状态

查询 OpenAI/Sora 兼容视频任务的本地状态。任务 ID 来自 创建视频 响应中的 id。

Try It

GET/v1/videos/{task_id}https://api-platform.ope.ai

端点

端点	鉴权	用途
GET /v1/videos/{task_id}	Authorization: Bearer <api-key>	API Key 查询自己的视频任务
GET /api/videos/{task_id}	token: <jwt>	前台令牌代理查询

普通前台 JWT 推荐放在 token 请求头；管理员 JWT 可使用 Authorization: Bearer <jwt>。

认证

使用 Bearer Token 认证。

• Header：Authorization: Bearer <api-key>
• 示例：Authorization: Bearer sk-xxxxxx

Path 参数

参数	类型	必填	说明
task_id	string	是	视频任务 ID

请求示例

cURL

curl -X GET "https://api-platform.ope.ai/v1/videos/{task_id}" \
  -H "Authorization: Bearer $OPEAI_API_KEY"

JavaScript

const taskId = "video_690d9b52e2b081908a05ded32cbfc629";
const res = await fetch(`https://api-platform.ope.ai/v1/videos/${taskId}`, {
  headers: {Authorization: `Bearer ${process.env.OPEAI_API_KEY}`},
});

console.log(await res.json());

Python

import os
import requests

resp = requests.get(
    "https://api-platform.ope.ai/v1/videos/video_690d9b52e2b081908a05ded32cbfc629",
    headers={"Authorization": f"Bearer {os.environ['OPEAI_API_KEY']}"},
    timeout=60,
)

print(resp.json())

响应示例

任务状态来自平台任务表，常见值包括 NOT_START、SUBMITTED、QUEUED、IN_PROGRESS、SUCCESS、FAILURE、UNKNOWN。当状态为 SUCCESS 时，可以继续请求视频内容。

200

{
  "id": "video_690d9b52e2b081908a05ded32cbfc629",
  "status": "SUCCESS",
  "model": "sora-2",
  "created_at": 1762499410,
  "object": "video",
  "prompt": "生成展示 AI 视频生成能力的短片，科技感，高清。",
  "size": "720x1280"
}

404

{
  "error": {
    "message": "video not found",
    "type": "NotFound",
    "param": "",
    "code": "ResourceNotFound"
  }
}