跳转至

视频生成

视频生成 API 提供了创建、查询和删除视频生成任务的接口。

创建视频

根据给定的提示生成视频响应。

POST /v1/videos

Authorizations

参数 类型 位置 必填 说明
Authorization string header 是 身份验证标头格式为 Bearer <API_KEY>，其中 <API_KEY> 是您的API令牌。

Headers

参数 类型 必填 说明
Content-Type string 是 multipart/form-data 或 application/json

Body

支持 multipart/form-data 和 application/json 格式。

Sora 模型

参数 类型 必填 说明
model string 是 模型名称。可选值：sora-2、sora-2-pro，或使用简化模型名称（见下方说明）
prompt string 是 视频生成的提示词描述。例如："一只可爱的小猫在阳光下玩耍"
callback_url string 否 任务完成后的回调通知URL
seconds string 否 视频生成时长。逆向渠道 sora-2：10/15，sora-2-pro：10/15/25；官转渠道 sora-2：4/8/12。使用简化模型名称时无需传入此参数
size string 否 视频生成尺寸。可选值：720x1280、1280x720、1024x1792、1792x1024。使用简化模型名称时无需传入此参数
input_reference binary 否 输入参考图片
简化模型名称

为方便使用，本 API 提供了以下简化的模型名称映射。使用这些名称时，无需传入 size 和 seconds 参数，系统会自动设置对应的尺寸和时长：

模型名称 视频方向 视频时长 说明
sora2-landscape 横版（电脑） 10 秒 适合电脑端观看
sora2-landscape-15s 横版（电脑） 15 秒 适合电脑端观看，时长更长
sora2-portrait 竖版（手机） 10 秒 适合手机端观看
sora2-portrait-15s 竖版（手机） 15 秒 适合手机端观看，时长更长

命名规则

  • 名称含 landscape 代表生成横版（电脑）视频
  • 名称含 portrait 代表生成竖版（手机）视频
  • 名称含 15s 表示生成 15 秒视频，不带此后缀表示生成 10 秒视频
  • 名称含 Pro 的代表官方的 sora2-pro 模型
  • 名称含 hd 代表生成高清版视频

其他模型

提示

其他模型实际调用时可选择使用 application/json 格式。

参数 类型 必填 说明
model string 是 模型名称。例如：kling_video、luma_video、runway_video 等
prompt string 是 视频生成的提示词描述
callback_url string 否 任务完成后的回调通知URL
metadata object 否 其他参数，可将官方的参数完整放进这个对象中（会覆盖外层同名参数）

Response

200 - 成功响应

参数 类型 说明
id string 任务ID
object string 对象类型
created_at integer 创建时间
status string 任务状态

请求示例

curl --request POST \
  --url https://cdn.12ai.org/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'model=sora-2' \
  --form 'prompt=一只可爱的小猫在阳光下玩耍' \
  --form 'seconds=10' \
  --form 'size=1280x720'

# 使用简化模型名称，无需指定 size 和 seconds 参数
curl --request POST \
  --url https://cdn.12ai.org/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'model=sora2-landscape' \
  --form 'prompt=一只可爱的小猫在阳光下玩耍'

curl --request POST \
  --url https://cdn.12ai.org/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling_video",
  "prompt": "美丽的日落场景",
  "callback_url": "https://example.com/notify"
}'

响应示例

{
  "id": "task_1234567890",
  "object": "video",
  "created_at": 1759938772,
  "status": "queued"
}

查询视频

查询视频生成任务状态。

GET /v1/videos/{id}

Authorizations

参数 类型 位置 必填 说明
Authorization string header 是 身份验证标头格式为 Bearer <API_KEY>，其中 <API_KEY> 是您的API令牌。

Path Parameters

参数 类型 必填 说明
id string 是 任务ID

Response

200 - 成功响应

参数 类型 说明
id string 任务ID
object string 对象类型
created_at integer 创建时间
status string 任务状态。可选值：queued、in_progress、completed、failed
model string 模型名称
size string 视频尺寸（如 720x720）
progress integer 进度（0-100），仅在 in_progress 状态返回
video_url string 视频URL，仅在 completed 状态返回
completed_at integer 完成时间戳，仅在 completed 状态返回

请求示例

curl --request GET \
  --url https://cdn.12ai.org/v1/videos/task_1234567890 \
  --header 'Authorization: Bearer <token>'

响应示例

{
  "id": "task_1234567890",
  "object": "video",
  "created_at": 1759938772,
  "status": "in_progress",
  "model": "sora-2",
  "size": "1280x720",
  "progress": 65
}

{
  "id": "task_1234567890",
  "object": "video",
  "created_at": 1759938772,
  "status": "completed",
  "model": "sora-2",
  "size": "1280x720",
  "video_url": "https://example.com/video.mp4",
  "completed_at": 1759939000
}

删除视频

删除视频生成任务。

DELETE /v1/videos/{id}

Authorizations

参数 类型 位置 必填 说明
Authorization string header 是 身份验证标头格式为 Bearer <API_KEY>，其中 <API_KEY> 是您的API令牌。

Path Parameters

参数 类型 必填 说明
id string 是 任务ID

Response

200 - 成功响应

参数 类型 说明
message string 消息
success boolean 是否成功

400 - 任务不存在

参数 类型 说明
error.message string 错误消息

请求示例

curl --request DELETE \
  --url https://cdn.12ai.org/v1/videos/task_1234567890 \
  --header 'Authorization: Bearer <token>'

响应示例

{
  "message": "Task deleted successfully",
  "success": true
}

{
  "error": {
    "message": "Invalid request, Task not found"
  }
}