⌘K

Sora 2 Pro - Text to Video

sora_2_pro_t2v

Vtrix Sora2 Pro 文生视频,从文本描述生成高质量专业视频,具有高级 AI 能力.

认证

authorization string 必需

所有 API 均使用 Bearer Token 鉴权

获取 API Key:

访问 API Key 管理页面 获取 API Key

用法:

将以下 Header 添加到请求中:

Authorization: Bearer YOUR_API_KEY

参数

model string 必需

请求使用的模型 ID

: sora_2_pro_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 string

错误码

error_message string

详细错误信息


output array

生成结果.仅在状态为 completed 时出现.

content array

生成内容列表

type string

资源类型,如 videoimage

url string

生成内容的 URL

size string

内容尺寸


usage object

使用统计.仅在状态为 completed 时出现.

cost string

总费用 (美元)

discount number

折扣金额


metadata object

元数据信息


错误码

错误码描述
002999095内部生成错误
002999096结果解析错误
002999097HTTP 错误响应
002999098状态检查错误
002999099任务创建错误