认证
authorization string 必需
所有 API 都需要通过 Bearer Token 进行身份验证.
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方式:
添加到请求头:
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID.
值: vtrix-veo-3.1-generate-preview
prompt string 必需
视频生成提示词,描述期望的场景
seconds string
视频时长(秒)
选项: 8
size string
视频分辨率
选项: 1280x720, 720x1280
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
id string 必需
任务 ID
created_at integer 必需
任务创建时间戳
status string 必需
任务状态
选项: in_progress, completed, failed
model string 必需
模型 ID
progress number
进度 (0.0-1.0), 仅在 status 为 in_progress 时出现
error object
错误信息.仅在 status 为 failed 时出现.
code
string错误代码
message
string错误消息
output array
生成结果.仅在 status 为 completed 时出现.
content
array内容数组
type
string内容类型: video
url
string视频 URL
duration
integer视频时长(秒)
jobId
string远程任务 ID
usage object
使用统计信息
metadata object
元数据信息,包括时间信息
错误代码
| 错误代码 | 描述 |
|---|---|
| 002014001 | 视频生成失败 |