认证
authorization string 必填
所有 API 需要通过 Bearer Token 进行身份验证
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方法:
添加到请求头:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的模型 ID
可选值: minimax_t2v_01
prompt string 必填
视频的文本描述, 长度必须在 1-2000 字符之间
duration integer
视频时长(秒), 固定为 6 秒, 不可更改
可选值: 6
默认值: 6
resolution string
视频分辨率, 固定为 720P, 不可更改
可选值: 720P
默认值: 720P
prompt_optimizer boolean
是否启用提示词优化器. 设为 false 可进行更精确的控制
默认值: true
callback_url string
接收任务状态更新通知的回调 URL. 支持通过 callback_url 参数配置回调, 以接收任务状态更新的异步通知
aigc_watermark boolean
是否在生成的视频中添加水印
默认值: false
轮询
由于结果生成需要时间,您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息, 仅在状态为 failed 时存在
code
integer错误代码
error_message
string详细错误消息
output array
生成结果, 仅在状态为 completed 时存在
content
array生成内容列表
type
string资源类型, 例如
video、imageurl
string生成内容 URL
usage object
使用统计, 仅在状态为 completed 时存在
cost
string总成本(美元)
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 010003095 | 内部生成错误 |
| 010003096 | 结果解析错误 |
| 010003097 | HTTP 错误响应 |
| 010003098 | 状态检查错误 |
| 010003099 | 任务创建错误 |