认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key:
访问 API Key 管理页面 获取 API Key
用法:
将以下 Header 添加到请求中:
Authorization: Bearer YOUR_API_KEY
参数
model string 必需
请求使用的模型 ID
值: sora_2_pro_i2v
prompt string 必需
镜头的自然语言描述. 包括镜头类型、主题、动作、设置、照明和任何所需的相机运动, 以减少歧义. 保持单一用途, 以获得最佳遵守
size string
输出分辨率(宽度 × 高度)
可选值:
720x1280: 肖像1280x720: 景观
默认值: 720x1280
seconds string
视频时长(秒)
可选值: 4, 8, 12
默认值: 4
input_reference string
用作第一帧的视觉定位点的单个引用图像
接受的 MIME 类型: image/jpeg, image/png, image/webp. 大小必须完全匹配
remix_video_id string
先前完成的视频的 ID(例如 video_...), 用于重复使用结构、动作和取景
轮询
由于结果生成需要时间,您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息.仅在状态为 failed 时出现.
code
string错误码
error_message
string详细错误信息
output array
生成结果.仅在状态为 completed 时出现.
content
array生成内容列表
type
string资源类型,如
video、image
url
string生成内容的 URL
size
string内容尺寸
usage object
使用统计.仅在状态为 completed 时出现.
cost
string总费用 (美元)
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 003000095 | 内部生成错误 |
| 003000096 | 结果解析错误 |
| 003000097 | HTTP 错误响应 |
| 003000098 | 状态检查错误 |
| 003000099 | 任务创建错误 |