⌘K

Sora 2 - Text to Video

sora_2_t2v

Sora 2 - Text to Video 使用 Microsoft 的 Sora2 模型直接从文本提示生成视频, 无需参考图像

认证

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, image

url string

生成内容 URL


usage object

使用统计信息. 仅在状态为 completed 时存在

cost string

总费用(美元)

discount number

折扣金额


metadata object

元数据信息


错误码

错误码描述
014001095内部生成错误
014001096结果解析错误
014001097HTTP 错误响应
014001098状态检查错误
014001099任务创建错误