认证
authorization string 必填
所有 API 都需要通过 Bearer Token 进行认证
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方法:
添加到请求头:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的模型 ID
值:ultra_i2v_master
image string 必填
输入图像 URL 或 Base64 编码(image 和 image_tail 至少提供一个)
prompt string
视频生成提示词,最大 2500 字符
duration string 必填
视频时长
可选值:5 或 10 秒
mode string
生成模式
默认值:std
可选值:std(标准)、pro(专业)
aspect_ratio string
视频宽高比
可选值:16:9、9:16、1:1
camera_control object
摄像机运动控制参数。如果未指定,模型将根据输入智能匹配
image_tail string
尾帧图像 URL 或 Base64 编码(image 和 image_tail 至少提供一个)
static_mask string
静态遮罩
dynamic_masks array
动态遮罩列表
external_task_id string
外部任务 ID
错误码
| 代码 | 描述 |
|---|---|
| 401 | API key 缺失或无效 |
| 403 | 余额不足或权限被拒绝 |
| 429 | 请求频率超限 |
| 500 | 内部服务器错误 |