H3 Context-IR

CAPABILITIES

能力与限制

支持模式

提示词增强首帧尾帧首尾帧参考素材

使用前需了解

返回文本而非视频。时长字段描述目标视频节奏，不限制输出 Token；输入、输出 Token 分别计价。

规格与默认值
参数	支持值 / 默认
分辨率	不适用
目标视频节奏（输出文本）	4–15 秒
画幅	21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive
提示词限制	7000 Unicode 码点
定义默认值（以模式规则为准）	duration: 5 · aspect_ratio: 16:9
参考素材上限	9 图片 / 3 视频 / 3 音频

素材上限不表示所有模式可以组合使用。具体大小、格式与互斥规则见完整字段说明。

查看完整请求字段与限制（中文）↗

字段	字段含义	类型	是否必选	默认值	可选值 / 范围	备注说明（模式与素材限制）	模型专用特殊字段
`model`	调用型号的接口标识	string	是	无	minimax-h3-context-ir	固定调用名称，按示例精确填写	否
`prompt`	描述内容、动作、镜头或编辑意图的提示词	string	是	无	1～7000 Unicode码点	原始创作想法	否
`duration`	目标视频节奏，单位秒；本次输出文本	integer	否	5	4～15秒	目标视频节奏，不是本次输出视频时长	否
`aspect_ratio`	输出画幅宽高比	string	纯文本是	素材adaptive	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive	纯文本增强必须明确具体比例；首尾帧省略或adaptive；参考可用具体比例或adaptive	否
`first_frame_image`	约束视频开始画面的图片地址	string	首帧／首尾帧模式需提供；可用角色替代	无	HTTPS URL	首帧最多1张，与参考素材互斥；图片规格见image_with_roles[].url	否
`last_frame_image`	约束视频结束画面的图片地址	string	尾帧／首尾帧模式需提供；可用角色替代	无	HTTPS URL	尾帧最多1张，与参考素材互斥；图片规格见image_with_roles[].url	否
`image_with_roles`	明确指定图片用途的数组	object[]	否	无	每项 {url, role}	按role选择首帧、尾帧或参考模式；首尾帧与参考素材互斥，不重复首尾角色	否
`image_with_roles[].url`	数组内单张图片的地址	string	数组内是	无	HTTPS URL	所有图片字段统一要求：PNG / JPEG / WebP；单文件≤30MiB；宽、高均256～5760像素；宽高比0.4～2.5	否
`image_with_roles[].role`	数组内图片的用途	string	数组内是	无	first_frame / last_frame / reference_image	首尾角色各≤1张；reference_image与image_urls合计≤9张；两类模式互斥	否
`image_urls`	图片地址数组	string[]	否	无	参考图 HTTPS URL	一律参考图，与reference_image角色合计≤9张；参考模式须至少有图片或视频，音频不能单独输入	否
`video_urls`	参考视频地址数组	string[]	否	无	≤3段	MP4 / MOV；单文件≤50MiB；单段2～15秒；视频合计≤15秒；宽、高均256～5760像素；宽高比0.4～2.5；23.976～60fps	否
`audio_urls`	参考音频地址数组	string[]	否	无	≤3段	PCM WAV / MP3（含Xing/Info）；单文件≤15MiB；单段2～15秒；音频合计≤15秒；需搭配参考图片或视频	否
`nsfw_check`	额外审核选项，本版仅接受false	boolean	否	false	仅false	不接受true	是 · 除Vidu与Regeneration外的型号

目录展示已实现的适配能力，不代表所有型号或规格均向当前账户开放。实际启用状态、权限与默认值以本人 /v1/models 为准。

查看完整请求字段与限制（中文）↗

CREATIVE WORKFLOWS

适用场景

将创作想法整理成更完整的提示词。
为后续独立的视频生成请求准备描述。
结合参考素材增强创作方向；纯文本增强须明确画幅比例。

本型号暂无经过验证的公开生成样例。以下请求示例来自公开接入契约，仅用于说明调用方式。

PRICING / USD

按所选规格计费。

售价为 USD。参考价格带采集日期；缺价不代表免费。历史任务仍按创建时的价格快照结算。

正在读取当前价格…

模型价格 ↗

API INTEGRATION

接入示例

在自己的服务端使用 HTTP 接入，选择模型与参数；先由服务方配置账户、Key 和逐模型权限。

202 表示已受理。保存任务编号，按 next_poll_after_seconds 查询；生成状态、产物可用性与费用状态分别判断。

HTTP / cURL

curl --request POST 'https://bytesota-api.businessmodelcraft.com/v1/videos/generations' \
  --header 'Authorization: Bearer YOUR_PLATFORM_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example-ir-text-001' \
  --data-raw '{
    "model": "minimax-h3-context-ir",
    "prompt": "小猫沿花园小径向前走，镜头缓缓跟随。",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

查询结果

HTTP / cURL

curl 'https://bytesota-api.businessmodelcraft.com/v1/tasks/vid_ABCDEFGHIJKLMNOP' \
  --header 'Authorization: Bearer YOUR_PLATFORM_API_KEY'

示例仅供复制，不会在网页中执行；凭证为占位符。

规格与示例来源：模型定义及公开 API 接入指南。

阅读完整 API 文档（中文）↗