> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Minimax H3 全参数指南 > Minimax H3 全系列统一接口，通过 `model` 参数选择具体生成模式。 **3 种生成模式：** | 模式 | 模型 ID | 输入素材 | |:---|:---|:---| | Text-to-Video | `minimax-h3-text-to-video` | 仅 `prompt` | | Image-to-Video | `minimax-h3-image-to-video` | `prompt` + `image_start` 和/或 `image_end` | | Reference-to-Video | `minimax-h3-reference-to-video` | `prompt` + `image_urls` / `video_urls` / `audio_urls` | **共同能力：** - 输出时长支持 `4`–`15` 秒，当前仅支持 `2k` - 异步处理模式，使用返回的任务 ID [进行查询](/cn/api-manual/task-management/get-task-detail) - Minimax H3 任务不支持取消 - 生成的视频链接有效期为 24 小时，请尽快保存 ## OpenAPI ````yaml cn/api-manual/video-series/minimax/minimax-h3/minimax-h3-overview.json POST /v1/videos/generations openapi: 3.1.0 info: title: Minimax H3 全模型接口 description: Minimax H3 全系列 3 个模型的统一接口，涵盖文生视频、图生视频和多模态参考生视频 license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: 生产环境 security: - bearerAuth: [] tags: - name: 视频生成 description: AI视频生成相关接口 paths: /v1/videos/generations: post: tags: - 视频生成 summary: Minimax H3 视频生成（全模型） description: >- Minimax H3 全系列统一接口，通过 `model` 参数选择具体生成模式。 **3 种生成模式：** | 模式 | 模型 ID | 输入素材 | |:---|:---|:---| | Text-to-Video | `minimax-h3-text-to-video` | 仅 `prompt` | | Image-to-Video | `minimax-h3-image-to-video` | `prompt` + `image_start` 和/或 `image_end` | | Reference-to-Video | `minimax-h3-reference-to-video` | `prompt` + `image_urls` / `video_urls` / `audio_urls` | **共同能力：** - 输出时长支持 `4`–`15` 秒，当前仅支持 `2k` - 异步处理模式，使用返回的任务 ID [进行查询](/cn/api-manual/task-management/get-task-detail) - Minimax H3 任务不支持取消 - 生成的视频链接有效期为 24 小时，请尽快保存 operationId: createMinimaxH3VideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: text_to_video: summary: 文生视频 value: model: minimax-h3-text-to-video prompt: >- 史诗级太空歌剧电影预告：一名女舰长独自站在巨大的观景窗前，最后一支舰队在窗外集结。舰队跃迁时爆发出刺眼白光，舰桥剧烈震动；光芒散去后，只剩她被留在寂静的深空中。电影级布光，缓慢推镜，宏大而克制的氛围。 duration: 4 quality: 2k aspect_ratio: '16:9' image_to_video: summary: 图生视频（首帧驱动） value: model: minimax-h3-image-to-video prompt: 焦点从前景的拉面碗缓缓转移到背景人物，热气持续从碗中升起并随空气自然飘散。镜头轻微前推，保持人物身份和餐厅环境一致。 image_start: >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png duration: 4 quality: 2k reference_to_video: summary: 多模态参考（图片 + 视频 + 音频） value: model: minimax-h3-reference-to-video prompt: >- 将 Video 1 中的人物替换为 Image 1 中的角色，保持 Image 1 的面部、发型和服装；完整保留 Video 1 的动作、节奏、构图和运镜，并使用 Audio 1 的声音演绎对白，确保口型同步。 image_urls: - >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png video_urls: - >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/297573323635_00_%E8%A7%86%E9%A2%911_YnyRbxEwio_video_20260525_163755_1927e9d3.mp4 audio_urls: - >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/f463d523c5ce_01_%E9%9F%B3%E9%A2%911_RSLcbpzJPo_6%E6%9C%885%E6%97%A5(1).mp3 duration: 4 quality: 2k aspect_ratio: adaptive responses: '200': description: 视频生成任务创建成功 content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: 请求参数错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: 未认证、Token无效或过期 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: 配额不足、需要充值 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: 无权限访问 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: Token does not have access to the specified model type: invalid_request_error '429': description: 请求频率超限 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: 服务器内部错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: VideoGenerationRequest: type: object required: - model - prompt properties: model: type: string description: >- 视频生成模型名称。 | 模型 ID | 模式 | 素材参数 | |:---|:---|:---| | `minimax-h3-text-to-video` | 文生视频 | 不接受媒体素材 | | `minimax-h3-image-to-video` | 图生视频 | `image_start` 和/或 `image_end` | | `minimax-h3-reference-to-video` | 多模态参考生视频 | `image_urls` / `video_urls` / `audio_urls` | enum: - minimax-h3-text-to-video - minimax-h3-image-to-video - minimax-h3-reference-to-video example: minimax-h3-text-to-video prompt: type: string minLength: 1 maxLength: 7000 description: >- 描述期望生成的视频内容，必填且不能为空。 **提示词要求：** - 支持中文和英文 - 最长 `7000` 字符（中文和英文均按字符计） - 提示词过长时，模型可能忽略部分细节 **不同模型的用法：** - **Text-to-Video**：描述场景、主体、动作、镜头和氛围，不接受任何媒体字段 - **Image-to-Video**：描述首帧/尾帧中的主体如何运动以及镜头如何变化；使用 `image_start` 和/或 `image_end` - **Reference-to-Video**：描述如何使用参考素材；使用 `Image 1`、`Image 2`、`Video 1`、`Audio 1` 等名称引用素材，不要使用 Seedance 风格的 `@image1` 或 `@video1`。编号从 `1` 开始，并与各 URL 数组中的顺序一致 example: 电影级画面：一名宇航员站在月球基地的观景窗前，镜头缓慢推进，远处地球从地平线上升起。 image_start: type: string format: uri description: |- 首帧图片的 HTTP(S) URL。 **适用模型：** - 仅适用于 `minimax-h3-image-to-video` - 文生视频和参考生视频不支持此参数 **组合规则：** - `image_start` 与 `image_end` 至少传入一个 - 仅传 `image_start`：首帧图生视频 - 同时传入两者：首尾帧图生视频 - 首帧最多 `1` 张，本字段为单个 URL **图片要求：** - 支持格式：JPG、JPEG、PNG、WEBP、HEIC、HEIF - 单张大小：不超过 `30MB` - 图片宽度和高度：均为 `256`–`5760` px - 宽高比（宽/高）：`0.4`–`2.5` - URL 必须使用 HTTP(S)，且可由服务端直接访问 - 整个 JSON 请求体大小不超过 `64MB`；不接受 Base64 或 `mm_file://` 输入 example: >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png image_end: type: string format: uri description: |- 尾帧图片的 HTTP(S) URL。 **适用模型：** - 仅适用于 `minimax-h3-image-to-video` - 文生视频和参考生视频不支持此参数 **组合规则：** - `image_end` 与 `image_start` 至少传入一个 - 仅传 `image_end`：尾帧图生视频，模型生成自然运动并在该画面结束 - 同时传入两者：首尾帧图生视频 - 尾帧最多 `1` 张，本字段为单个 URL **图片要求：** - 支持格式：JPG、JPEG、PNG、WEBP、HEIC、HEIF - 单张大小：不超过 `30MB` - 图片宽度和高度：均为 `256`–`5760` px - 宽高比（宽/高）：`0.4`–`2.5` - URL 必须使用 HTTP(S)，且可由服务端直接访问 - 整个 JSON 请求体大小不超过 `64MB`；不接受 Base64 或 `mm_file://` 输入 example: >- https://images.unsplash.com/photo-1515003197210-e0cd71810b5f?auto=format&fit=crop&w=1920&q=85 image_urls: type: array description: |- 参考图片的 HTTP(S) URL 数组，默认为 `[]`，最多 `9` 张。 **适用模型：** - 仅适用于 `minimax-h3-reference-to-video` - 图生视频请改用 `image_start` / `image_end` - 文生视频不支持此参数 **角色与编号：** - 所有图片均作为 `reference_image` 使用 - 数组第 1 项对应提示词中的 `Image 1`，第 2 项对应 `Image 2`，依此类推 **图片要求：** - 支持格式：JPG、JPEG、PNG、WEBP、HEIC、HEIF - 单张大小：不超过 `30MB` - 图片宽度和高度：均为 `256`–`5760` px - 宽高比（宽/高）：`0.4`–`2.5` - URL 必须使用 HTTP(S)，且可由服务端直接访问 - 整个 JSON 请求体大小不超过 `64MB`；不接受 Base64 或 `mm_file://` 输入 **组合规则：** - `image_urls`、`video_urls`、`audio_urls` 至少传入其中一项 - 三类参考素材总数不超过 `12` 个（参考图片 + 参考视频 + 参考音频） - 三者全部为空会返回参数错误；纯文本生成请改用 `minimax-h3-text-to-video` default: [] maxItems: 9 items: type: string format: uri example: - >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png video_urls: type: array description: |- 参考视频的 HTTP(S) URL 数组，默认为 `[]`，最多 `3` 个。 **适用模型：** - 仅适用于 `minimax-h3-reference-to-video` - 文生视频和图生视频不支持此参数 **角色与编号：** - 所有视频均作为 `reference_video` 使用 - 数组第 1 项对应提示词中的 `Video 1`，第 2 项对应 `Video 2`，依此类推 **视频要求：** - 支持容器格式：MP4（`.mp4`）、MOV（`.mov`） - 视频编码：H.264/AVC、H.265/HEVC - 视频内音频编码：AAC、MP3 - 单个大小：不超过 `50MB` - 单个时长：`2`–`15` 秒；所有参考视频总时长不超过 `15` 秒 - 视频宽度和高度：均为 `256`–`5760` px - 宽高比（宽/高）：`0.4`–`2.5` - 帧率：`23.976`–`60` FPS - URL 必须使用 HTTP(S)，且可由服务端直接访问 - 整个 JSON 请求体大小不超过 `64MB`；不接受 Base64 或 `mm_file://` 输入 **计费说明：** - 参考视频的输入时长会计入费用 **组合规则：** - `image_urls`、`video_urls`、`audio_urls` 至少传入其中一项 - 三类参考素材总数不超过 `12` 个（参考图片 + 参考视频 + 参考音频） - 三者全部为空会返回参数错误；纯文本生成请改用 `minimax-h3-text-to-video` default: [] maxItems: 3 items: type: string format: uri example: - >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/297573323635_00_%E8%A7%86%E9%A2%911_YnyRbxEwio_video_20260525_163755_1927e9d3.mp4 audio_urls: type: array description: |- 参考音频的 HTTP(S) URL 数组，默认为 `[]`，最多 `3` 段。 **适用模型：** - 仅适用于 `minimax-h3-reference-to-video` - 文生视频和图生视频不支持此参数 **角色与编号：** - 所有音频均作为 `reference_audio` 使用 - 数组第 1 项对应提示词中的 `Audio 1`，第 2 项对应 `Audio 2`，依此类推 **音频要求：** - 支持格式：WAV、MP3 - 单段大小：不超过 `15MB` - 单段时长：`2`–`15` 秒；所有参考音频总时长不超过 `15` 秒 - URL 必须使用 HTTP(S)，且可由服务端直接访问 - 整个 JSON 请求体大小不超过 `64MB`；不接受 Base64 或 `mm_file://` 输入 **计费说明：** - 参考音频不计入计费时长 **组合规则：** - 支持仅传 `audio_urls`，无需搭配参考图片或参考视频 - 三类参考素材总数不超过 `12` 个（参考图片 + 参考视频 + 参考音频） - 三者全部为空会返回参数错误；纯文本生成请改用 `minimax-h3-text-to-video` default: [] maxItems: 3 items: type: string format: uri example: - >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/f463d523c5ce_01_%E9%9F%B3%E9%A2%911_RSLcbpzJPo_6%E6%9C%885%E6%97%A5(1).mp3 duration: type: integer description: |- 输出视频时长（秒），默认为 `4` 秒。 **适用模型：** - 适用于全部 3 个 Minimax H3 模型 **取值限制：** - 仅支持 `4`–`15` 之间的整数，包括 `4` 和 `15` - 不支持小数、数字字符串、`auto` 或 `-1` - 输出时长与计费直接相关 default: 4 minimum: 4 maximum: 15 example: 4 quality: type: string description: |- 输出视频分辨率，默认为 `2k`。 **适用模型：** - 适用于全部 3 个 Minimax H3 模型 **可选值：** - `2k`：当前唯一支持的分辨率 **注意：** - `768p` 暂未开放，传入后会返回参数错误 - 输出码率、帧率、视频编码和音频编码由平台决定，当前不提供对应请求参数 enum: - 2k default: 2k example: 2k aspect_ratio: type: string description: |- 输出视频宽高比。 **适用模型及默认值：** - `minimax-h3-text-to-video`：仅支持显式宽高比，默认为 `16:9` - `minimax-h3-reference-to-video`：支持下列全部选项，默认为 `adaptive` - `minimax-h3-image-to-video`：模型根据输入图像自动适配输出宽高比，请勿传入此参数 **可选值：** - `adaptive`：仅适用于参考生视频，模型根据参考素材和提示词自动选择合适的宽高比 - `16:9`：横屏 - `21:9`：超宽屏 - `4:3`：横向标准画幅 - `1:1`：方形 - `3:4`：纵向标准画幅 - `9:16`：竖屏 enum: - adaptive - '16:9' - '21:9' - '4:3' - '1:1' - '3:4' - '9:16' example: '16:9' callback_url: type: string description: |- 任务完成后的 HTTPS 回调地址。 **适用模型：** - 适用于全部 3 个 Minimax H3 模型 **回调时机：** - 任务完成（completed）或失败（failed）时触发 - 在计费确认完成后发送 **安全限制：** - 仅支持 HTTPS 协议 - 禁止回调到内网 IP 地址（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x 等） - URL 长度不超过 `2048` 字符 **回调机制：** - 超时时间：`10` 秒 - 失败后最多重试 `3` 次（分别在失败后 `1`/`2`/`4` 秒重试） - 回调响应体格式与任务查询接口返回格式一致 - 返回 2xx 状态码视为成功，其他状态码触发重试 format: uri example: https://your-domain.com/webhooks/video-task-completed pattern: ^https:// additionalProperties: false VideoGenerationResponse: type: object properties: created: type: integer description: 任务创建时间戳 example: 1761313744 id: type: string description: 任务ID example: task-unified-1774857405-abc123 model: type: string description: 实际使用的模型名称 example: minimax-h3-text-to-video object: type: string enum: - video.generation.task description: 任务的具体类型 progress: type: integer description: 任务进度百分比 (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: 任务状态 enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: 视频任务详细信息 type: type: string enum: - text - image - audio - video description: 任务的输出类型 example: video usage: $ref: '#/components/schemas/VideoUsage' description: 使用量和计费信息 ErrorResponse: type: object properties: error: type: object properties: code: type: string description: 错误代码标识符 message: type: string description: 错误描述信息 type: type: string description: 错误类型 VideoTaskInfo: type: object properties: can_cancel: type: boolean description: 任务是否可以取消。Minimax H3 任务不支持取消，始终为 `false`。 example: false enum: - false default: false estimated_time: type: integer description: 预估完成时间（秒） minimum: 0 example: 165 video_duration: type: integer description: 视频时长（秒） example: 4 VideoUsage: type: object description: 使用量和计费信息 properties: billing_rule: type: string description: 计费规则 enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: 预估消耗积分数 minimum: 0 example: 44.2 user_group: type: string description: 用户组类别 example: default securitySchemes: bearerAuth: type: http scheme: bearer description: |- ##所有接口均需要使用Bearer Token进行认证## **获取 API Key：** 访问 [API Key 管理页面](https://evolink.ai/dashboard/keys) 获取您的 API Key **使用时在请求头中添加：** ``` Authorization: Bearer YOUR_API_KEY ``` ````