通过 API 接入 Sora 2 Pro

参数说明

• 必填。使用上述支持的模型字符串。
• 除分镜外必填。描述要生成的画面。
• 图生必填。data:image/*;base64,... 格式图像数据。
• 选填。如不传 base64 可提供公开图片 URL。
• 选填。landscape 或 portrait，默认 landscape。
• 选填。"10"/"15"/"25"（25 仅分镜）。
• 选填（Pro 文/图）。standard 或 high。
• 选填（文/图）。是否去水印，默认 true。
• 分镜必填。分镜数组，包含 scene 与 duration。
• 选填。是否公开展示，默认 true。

请求示例

curl -X POST https://sora2-api.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-text-to-video",
    "prompt": "黄昏霓虹街市的电影感跟拍镜头。",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true,
    "isPublic": true
  }'

响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_1234567890",
    "taskId": "task_1234567890"
  }
}

参数说明

• 必填。创建任务时返回的唯一标识。

请求示例

curl -X POST https://sora2-api.com/api/video-generations/check-result \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "task_1234567890"
  }'

响应示例

{
  "code": 0,
  "message": "Success",
  "data": {
    "task_id": "task_1234567890",
    "status": "running",
    "progress": 0,
    "result_url": ""
  }
}

请求示例

curl -X POST https://sora2-api.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_vip": true
  }
}