认证
authorization string 必需
所有 API 都需要通过 Bearer Token 进行身份验证
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方法:
添加到请求头:
Authorization: Bearer YOUR_API_KEY
参数
model string 必需
请求使用的模型 ID
值: sora_2_t2v
prompt string 必需
镜头的自然语言描述. 包括镜头类型、主题、动作、设置、照明和任何所需的相机运动, 以减少歧义. 保持单一用途, 以获得最佳遵守
size string
输出分辨率(宽度 × 高度)
可选值:
720x1280: 肖像1280x720: 景观
默认值: 720x1280
seconds string
视频时长(秒)
可选值: 4, 8, 12
默认值: 4
remix_video_id string
先前完成的视频的 ID(例如 video_...), 用于重复使用结构、动作和取景
轮询
由于结果生成需要时间,您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息. 仅在状态为 failed 时存在
code
integer错误码
error_message
string详细错误消息
output array
生成结果. 仅在状态为 completed 时存在
content
array生成内容列表
type
string资源类型, 如
video,imageurl
string生成内容 URL
usage object
使用统计信息. 仅在状态为 completed 时存在
cost
string总费用(美元)
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 014001095 | 内部生成错误 |
| 014001096 | 结果解析错误 |
| 014001097 | HTTP 错误响应 |
| 014001098 | 状态检查错误 |
| 014001099 | 任务创建错误 |