生成视频

接口参考来自当前平台公开协议。具体模型的模式和规格请在模型详情中确认。

POST/v1/media/generations

身份认证

bearerAuth

认证方式Bearer <token>

传入位置: header

请求头参数

X-Client-Request-Id?string

可选客户端关联值，只能包含可见 ASCII，最多 512 字节；不能替代服务端 requestId。

长度length <= 512

Idempotency-Key?string

强烈建议提供稳定业务幂等键，以便在结果未知时安全重放。同键用于不同规范请求会发生冲突。

公开视频接口使用顶层字段，不使用正式应用的 params/mediaSpec 包装。H3 必须提供 generationMode、resolutionTier、orientation、seconds，支持 544p/768p、六种受控画布和 5～15 秒，提示词最多 7000 字符。t2v 不传素材；i2v 传首图；首尾帧传两张图；全能参考传分类素材。其他模型的条件必填和合法组合由 mediaSpecContract 声明；不要向 H3 传 fps、frames、width、height、steps 或运行时设置。

aspectRatio?string

H3 受控画面比例，例如 21:9、16:9、4:3、1:1、3:4、9:16；需与 outputSizeCode 配套。

characterMode?string

Wan2.2 Animate 专用：动作迁移或角色替换；需要人物图和驱动视频，不传 prompt。其他视频模型不使用本字段。

可选值

"motion_transfer"
"character_replace"

enableRife?boolean

仅部分普通 Wan 视频服务支持的插帧选项；H3、Wan Animate 和 X-Dub 不接受。须先确认所选服务能力。

end_image_asset_id?string

已上传的尾帧图片；仅用于 H3 首尾帧等明确支持尾帧的模式。

end_image_url?string

可选：与 end_image_asset_id 并列的外部来源，二选一。只接受公网 HTTPS（443 端口），另接受 data:image/png|jpeg|webp;base64, 图片数据；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

generationMode?string

H3 必填，可选 t2v、i2v、first_last_frame_video、universal_reference_video；其他模型使用各自公布的模式。

input_audio_asset_id?string

明确支持音频输入的模型所需素材；不是 H3 全能参考的独立顶层字段。

input_audio_url?string

可选：与 input_audio_asset_id 并列的外部来源，二选一。只接受公网 HTTPS（443 端口）；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

input_image_asset_id?string

已上传的输入图片；H3 用于图生和首尾帧，Wan Animate 用于人物图；其他模型按服务合同使用。

input_image_asset_ids?array<string>

有序输入图片 ID；Bernini r2v 使用 1～5 张，rv2v 使用恰好 1 张。不是 H3 全能参考字段；仅按当前模型能力使用。

input_image_url?string

可选：与 input_image_asset_id 并列的外部来源，二选一。只接受公网 HTTPS（443 端口），另接受 data:image/png|jpeg|webp;base64, 图片数据；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

input_image_urls?array<string>

有序 URL 数组，按位置改写为 input_image_asset_ids。可选：与 input_image_asset_ids 并列的外部来源，二选一。只接受公网 HTTPS（443 端口），另接受 data:image/png|jpeg|webp;base64, 图片数据；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

input_video_asset_id?string

明确支持视频输入的模型所需素材；不是 H3 全能参考的独立顶层字段。

input_video_url?string

可选：与 input_video_asset_id 并列的外部来源，二选一。只接受公网 HTTPS（443 端口）；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

model*string

GET /v1/services 返回的公开模型别名；不能使用部署名或工作负载名。

optimizePrompt?boolean

仅公开 Account API Key H3 四模式生成缺省开启。部署未激活时，缺省或 true 返回 503 prompt_optimization_capability_unavailable；查询 automaticPromptOptimization.available 获取编排可用性，它不代表模型实时健康。显式 false 完全跳过优化且不收优化费；已手动优化的 prompt 应传 false。其他模型不会自动优化，true 返回参数错误。后台准备最多两次常规优化，每次完整超长候选最多压缩一次，最多四次模型调用按实际 token 单独计费。两次失败则 Job 返回 prompt_optimization_failed，不回退原 prompt；未知结果恢复原 attempt，不新发模型调用。

orientation?string

画幅方向，合法值按模型规格选择。

可选值

"landscape"
"portrait"

outputSizeCode?string

H3 受控画布代码；服务能力合同返回的六种 544p 或六种 768p 代码之一。

prompt?string

生成提示词；H3 去除首尾空白后为 1～7000 个 Unicode 字符。Wan Animate、X-Dub 等无提示词模式不传。

referenceInputs?array<>

H3 全能参考：无视频最多 9 图，有 1 个视频时最多 8 图；最多 3 段音频，总计不超过 12 项且至少一项视觉素材。同类型顺序决定编号；素材 ID 不可重复，且须属于当前调用身份和模型。

数组元素items <= 12

reference_image_url?string

可选：与 reference_image_asset_id 并列的外部来源，二选一。只接受公网 HTTPS（443 端口），另接受 data:image/png|jpeg|webp;base64, 图片数据；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

reference_image_urls?array<string>

有序 URL 数组，按位置改写为 reference_image_asset_ids。可选：与 reference_image_asset_ids 并列的外部来源，二选一。只接受公网 HTTPS（443 端口），另接受 data:image/png|jpeg|webp;base64, 图片数据；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

resolutionTier?string

H3 支持 544p、768p；其他服务使用各自公布的清晰度。

seconds?integer

请求生成时长，单位秒。H3 为 5～15 的整数；实际产物时长和帧数另由结果确定。

seed?integer

可选随机种子，用于可重复输入；同一幂等请求重试时不得改变。

范围0 <= value <= 2147483647

source_video_url?string

可选：与 source_video_asset_id 并列的外部来源，二选一。只接受公网 HTTPS（443 端口）；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

speedMultiplier?number

Wan2.2 Animate 处理速度。720p 支持 1 或 1.5；480p 使用 1。1.5 倍按对应价格系数计费，不承诺上传和排队等总耗时同比缩短。其他模型仅在能力合同声明时使用。

可选值

storageMode?string

平台存储策略，使用顶层字段：默认 personal_30d，将本次主动上传或生成的资源保存到当前用户资源空间，自资源入库起 30 天到期，可在门户“我的资源”改为永久保存，仍占用配额。temporary_1h 自入库起 1 小时到期，仅后台已对所属用户或组织开启临时存储权限时可选；未授权时拒绝，不静默降级。生成请求不改变已引用素材的原到期时间。公网 URL 受控导入的临时输入遵循独立的 1 小时策略，不因本字段进入个人资源空间。

默认值"personal_30d"

可选值

"personal_30d"
"temporary_1h"

[key: string]?any

响应正文

`application/json`

{  "id": "job_example",  "jobId": "job_example",  "jobUrl": "https://api.example.test/v1/jobs/job_example?model=minimax-h3",  "model": "minimax-h3",  "requestId": "req_example",  "serviceKind": "video_generation",  "stage": "queued",  "status": "queued"}

身份认证

请求头参数

请求正文

响应正文

200application/json

202application/json

400application/json

401application/json

402application/json

403application/json

404application/json

409application/json

413application/json

415application/json

422application/json

429application/json

500application/json

502application/json

503application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`