视频模型
MiniMax H3
支持文生视频、首尾帧和多模态参考，输出 768p 或 2K 视频。
POST
/api/v1/jobs/createTask将 model 设为 hailuo-h3。支持 5 至 15 秒的视频，输出分辨率为 768p 或 2K。任务异步执行，保存返回的 taskId 后查询结果，也可以设置客户回调。
请求示例
curl -X POST https://api.xbaiapi.com/api/v1/jobs/createTask \
-H "Authorization: Bearer xb-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo-h3",
"input": {
"prompt": "一只橘猫在阳光照进的窗台上伸懒腰",
"resolution": "768p",
"duration": 5,
"ratio": "16:9"
},
"callBackUrl": "https://your-server.com/webhook"
}'参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 固定为 hailuo-h3 |
input.prompt | string | 条件必填 | 视频描述，首尾帧模式可省略 |
input.resolution | string | 否 | 768p 或 2K，不区分大小写，默认 2K |
input.duration | number | 否 | 5 至 15 的整数秒，默认 5 |
input.ratio | string | 否 | adaptive、16:9、9:16、1:1、4:3、3:4、21:9。默认 adaptive，纯文生视频自动使用 16:9 |
input.firstFrameUrl | string | 否 | 首帧图片，不能与参考素材列表混用 |
input.lastFrameUrl | string | 否 | 尾帧图片，需要同时提供首帧 |
input.imageUrls | string[] | 否 | 最多 9 张参考图片 |
input.videoUrls | string[] | 否 | 最多 3 个 MP4/MOV 参考视频，每个 50 MB 以内 |
input.audioUrls | string[] | 否 | 最多 3 个参考音频，输入音频免费 |
callBackUrl | string | 否 | 客户接收任务终态的 HTTP(S) 地址 |
素材使用公开可访问的 HTTP(S) URL。参考视频须为非分片的 MP4 或 MOV 文件，地址必须是 https 域名，直接返回文件（HTTP 200、不跳转）并带 Content-Length，每个不超过 50 MB。服务端会把参考视频复制到 xbaiapi 的存储后交给上游，按文件里记录的最长时长（含实际帧时长）计费。无法下载或读不出时长时在扣费前返回 422，不使用客户端上报的时长计算费用。首尾帧模式不能同时提供图片、视频或音频参考列表。
计费
| 分辨率 | 输入和输出视频秒价 | 美元秒价 |
|---|---|---|
| 768p | 6.4 credits | $0.032 |
| 2K | 10.4 credits | $0.052 |
总费用 = 秒价 ×（输出视频秒数 + 输入视频秒数）+ 额外图片费用。
输入视频总时长向上取整到秒。前 5 张图片免费，第 6 张起每张 3.2 credits（$0.016），输入音频免费。无论文生视频、首尾帧还是多模态参考，使用相同分辨率秒价。
例如：768p 输出 5 秒，参考视频共 3 秒，参考图片 7 张，费用为 6.4 × (5 + 3) + 3.2 × 2 = 57.6 credits，即 $0.288。任务失败自动全额退款。
响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "xb_a1b2c3d4e5f6...",
"creditsCharged": 32
}
}结果通过定时同步更新，通常每 2 分钟查询一次生成状态。任务成功后，查询响应中的 resultJson.resultUrls 提供视频地址，文件保留 30 天。