> ## 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 Image-to-Video 图生视频 > - `image_start` 和 `image_end` 至少传一个；支持仅首帧、仅尾帧或首尾帧 - 输出时长支持 `5`–`15` 秒，当前仅支持 `2k` - 图生视频的画面比例由输入图决定，`aspect_ratio` 会按 `adaptive` 处理 - 异步处理模式，使用返回的任务 ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的视频链接有效期为 24 小时，请尽快保存 ## OpenAPI ````yaml cn/api-manual/video-series/minimax/minimax-h3-image-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: Minimax H3 Image-to-Video 接口 description: Minimax H3 图生视频接口，支持首帧、尾帧及首尾帧图生视频 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 Image-to-Video 图生视频 description: >- - `image_start` 和 `image_end` 至少传一个；支持仅首帧、仅尾帧或首尾帧 - 输出时长支持 `5`–`15` 秒，当前仅支持 `2k` - 图生视频的画面比例由输入图决定，`aspect_ratio` 会按 `adaptive` 处理 - 异步处理模式，使用返回的任务 ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的视频链接有效期为 24 小时，请尽快保存 operationId: createMinimaxH3ImageToVideo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: first_frame: 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: 5 quality: 2k last_frame: summary: 仅尾帧图生视频 value: model: minimax-h3-image-to-video prompt: 镜头从餐厅全景缓慢推进，人物自然交谈，拉面热气逐渐变得清晰，最终准确停在给定尾帧的构图和人物姿态上。 image_end: >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png duration: 5 quality: 2k first_last_frame: 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 image_end: >- https://images.unsplash.com/photo-1515003197210-e0cd71810b5f?auto=format&fit=crop&w=1920&q=85 duration: 8 quality: 2k 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 model: minimax-h3-image-to-video 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: 视频生成模型名称 enum: - minimax-h3-image-to-video default: minimax-h3-image-to-video example: minimax-h3-image-to-video prompt: type: string minLength: 1 description: |- 描述输入图片如何运动、镜头如何变化以及期望生成的视频内容。 **提示词要求：** - 必填且不能为空 - 支持中文和英文 - 建议中文不超过 `500` 字、英文不超过 `1000` 词；提示词过长时，模型可能忽略部分细节 **输入限制：** - 本模型使用 `image_start` 和/或 `image_end` 接收首尾帧 - 不支持 `image_urls`、`video_urls`、`audio_urls`；传入这些字段会返回参数错误 example: 焦点从前景的拉面碗缓缓转移到背景人物，热气持续从碗中升起并自然飘散。镜头轻微前推，保持人物身份和餐厅环境一致。 image_start: type: string format: uri description: |- 首帧图片的 HTTP(S) URL。 **组合规则：** - `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。 **组合规则：** - `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 duration: type: integer description: |- 输出视频时长（秒），默认为 `5` 秒。 **取值限制：** - 仅支持 `5`–`15` 之间的整数，包括 `5` 和 `15` - 不支持小数、数字字符串、`auto` 或 `-1` - 输出时长与计费直接相关 default: 5 minimum: 5 maximum: 15 example: 5 quality: type: string description: |- 输出视频分辨率，默认为 `2k`。 **可选值：** - `2k`：当前唯一支持的分辨率 **注意：** - `768p` 暂未开放，传入后会返回参数错误 - 输出码率、帧率、视频编码和音频编码由平台决定，当前不提供对应请求参数 enum: - 2k default: 2k example: 2k callback_url: type: string description: |- 任务完成后的 HTTPS 回调地址 **回调时机：** - 任务完成（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-image-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: 8 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: 50 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 ``` ````