MiniMax H3（全能参考视频）

任务进度与结果查询见 使用说明。

说明

异步任务接口，用于提交 MiniMax H3 全能参考视频任务。支持图片、视频和音频参考素材，具体生成进度与结果请通过任务查询接口获取。

请求地址

POST /open/v1/ai_creation/task/submit

Header

access_token: {{access_token}}
Content-Type: application/json

请求参数 Body

{
  "ref_resources": [
    {
      "url": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref.jpg",
      "file_type": "image"
    },
    {
      "url": "https://res.chanjing.cc/chanjing/res/aigc_creation/video/ref.mp4",
      "file_type": "video"
    }
  ],
  "ref_prompt": "保持参考素材中的主体特征和运动节奏，生成电影感品牌短片",
  "creation_type": 4,
  "aspect_ratio": "16:9",
  "clarity": 768,
  "resolution_mode": "native",
  "video_duration": 5,
  "number_of_images": 1,
  "model_code": "minmax-h3-r2v"
}

参数说明

字段	类型	是否必传	示例	说明
ref_resources	array<object>	条件必传	[{"url":"https://.../ref.mp4","file_type":"video"}]	参考素材列表；与 ref_img_url 至少传一种，且图片或视频至少有一种
ref_resources.url	string	是	https://res.chanjing.cc/chanjing/res/aigc_creation/video/ref.mp4	参考素材 URL
ref_resources.file_type	string	是	video	参考素材类型，支持 image、video、audio
ref_img_url	array<string>	否	["https://.../ref.jpg"]	兼容旧版参考图字段；仅传图片时可替代 ref_resources
ref_prompt	string	是	保持参考素材中的主体特征和运动节奏	视频生成提示词，最多 7000 个字符
creation_type	int	是	4	创作类型，视频生成为 4
aspect_ratio	string	是	16:9	输出视频宽高比，支持 16:9、4:3、1:1、3:4、9:16、21:9
clarity	int/string	否	768	支持 480、768、1440 或字符串 2K；不传默认 1440（2K 官方生成）
resolution_mode	string	否	native	分辨率模式：native 表示加速版，direct 表示官方生成
video_duration	int	是	5	视频时长（秒），支持 5-15
number_of_images	int	否	1	生成数量，固定为 1；不传按 1 处理
model_code	string	是	minmax-h3-r2v	模型编码，固定为 minmax-h3-r2v

支持的分辨率组合：

输出规格	clarity	resolution_mode	说明
480P 加速	480	native，可省略	ComfyUI 加速生成
768P 加速	768	native，可省略	ComfyUI 加速生成
768P 官方生成	768	direct	MiniMax H3 官方生成
2K 官方生成	1440 或 2K	direct，可省略	默认兼容模式，使用 MiniMax H3 官方生成

clarity 和 resolution_mode 都不传时，默认使用 1440 + direct。参考图片最多 9 张，参考视频最多 3 个，参考音频最多 3 个；单个视频或音频时长为 2-15 秒，同类型素材总时长最多 15 秒。音频通过 file_type=audio 独立传入，但不能作为唯一参考素材。该模式不支持 aspect_ratio=auto，且不使用 quality_mode。

响应示例

{
  "trace_id": "96afa792520b0e6a86d72e89435bc0a7",
  "code": 0,
  "msg": "success",
  "data": "a60747d7-dc05-4afc-b2ef-ee4370ed53c6"
}

响应字段说明

字段	说明
code	响应状态码
msg	响应信息
trace_id	请求链路追踪 ID
data	创作任务唯一 ID（unique_id）

响应状态码说明

code	说明
0	响应成功
400	传入参数格式错误
10400	AccessToken 验证失败
40000	参数错误
40001	超出 QPS 限制
50000	系统内部错误

示例代码

cURL

curl --location --request POST 'https://open-api.chanjing.cc/open/v1/ai_creation/task/submit' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "ref_resources": [
    {"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref.jpg", "file_type": "image"},
    {"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/video/ref.mp4", "file_type": "video"}
  ],
  "ref_prompt": "保持参考素材中的主体特征和运动节奏，生成电影感品牌短片",
  "creation_type": 4,
  "aspect_ratio": "16:9",
  "clarity": 768,
  "resolution_mode": "native",
  "video_duration": 5,
  "number_of_images": 1,
  "model_code": "minmax-h3-r2v"
}'

Go

payload := strings.NewReader(`{
  "ref_resources": [
    {"url":"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref.jpg","file_type":"image"},
    {"url":"https://res.chanjing.cc/chanjing/res/aigc_creation/video/ref.mp4","file_type":"video"}
  ],
  "ref_prompt": "保持参考素材中的主体特征和运动节奏，生成电影感品牌短片",
  "creation_type": 4,
  "aspect_ratio": "16:9",
  "clarity": 768,
  "resolution_mode": "native",
  "video_duration": 5,
  "number_of_images": 1,
  "model_code": "minmax-h3-r2v"
}`)

Java

RequestBody body = RequestBody.create(mediaType, "{\n  \"ref_resources\": [{\"url\":\"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref.jpg\",\"file_type\":\"image\"},{\"url\":\"https://res.chanjing.cc/chanjing/res/aigc_creation/video/ref.mp4\",\"file_type\":\"video\"}],\n  \"ref_prompt\": \"保持参考素材中的主体特征和运动节奏，生成电影感品牌短片\",\n  \"creation_type\": 4,\n  \"aspect_ratio\": \"16:9\",\n  \"clarity\": 768,\n  \"resolution_mode\": \"native\",\n  \"video_duration\": 5,\n  \"number_of_images\": 1,\n  \"model_code\": \"minmax-h3-r2v\"\n}");

Python

payload = json.dumps({
  "ref_resources": [
    {"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref.jpg", "file_type": "image"},
    {"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/video/ref.mp4", "file_type": "video"}
  ],
  "ref_prompt": "保持参考素材中的主体特征和运动节奏，生成电影感品牌短片",
  "creation_type": 4,
  "aspect_ratio": "16:9",
  "clarity": 768,
  "resolution_mode": "native",
  "video_duration": 5,
  "number_of_images": 1,
  "model_code": "minmax-h3-r2v"
})