APIMPAPIMP
ユーザーガイドAI API画像 API動画 API公開 API

sora-2

sora-2 / sora-2-pro の非同期動画生成タスクを送信します。task_id が返るので、状態取得エンドポイントでポーリングしてください。

POST
/api/generate/submit

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

Sora 模型名

Value in"sora-2" | "sora-2-pro"
input*object
prompt*string

视频描述（必填，非空）

size?string

视频分辨率，WxH 格式。常用 720x1280、1280x720、1024x1792、1792x1024。缺省 720x1280

seconds?string

视频时长（秒），字符串数字。与 duration 二选一；优先 seconds。缺省 4

duration?integer

视频时长（秒）。与 seconds 等价，二选一

image?string

首帧参考图 URL（image-to-video）

images?array<string>

首帧参考图 URL 列表

metadata?object

模型专属参数。除已列出的字段外，其它键完全透传到上游 Sora API。

input_reference?string

Sora 首帧参考图字段（与 image 互通）

[key: string]?any
[key: string]?never

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/generate/submit" \  -H "Content-Type: application/json" \  -d '{    "model": "sora-2",    "input": {      "prompt": "A red panda riding a skateboard, cinematic lighting"    }  }'
{
  "code": 200,
  "data": {
    "task_id": "task_2BvCWmHzG6sJxK4tQpAr8M9nZyYfRdLs",
    "status": "not_started",
    "created_time": "2026-06-18T09:21:26",
    "error_message": null
  }
}

{
  "code": 400,
  "error": {
    "message": "input.prompt is required",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

このガイドはいかがですか？

最終更新