DragonAPI

切换主题

MiniMax H3 视频生成 ​

使用 DragonAPI 密钥和本站接口。示例中的 your-media.example 是占位地址，需替换为你自己的可访问素材或回调地址。协议、可用性与价格以当前模型说明和控制台为准。

MiniMax H3 支持文生视频、首尾帧图生视频和多模态参考生成，输出 2K 或 768p 视频。

视频任务是异步执行的。提交后请保存任务 ID 并轮询状态，排队时间可能较长，不要因为客户端超时重复提交。

认证 ​

Authorization ​

string · 必填

使用 DragonAPI Key 进行 Bearer 认证：Authorization: Bearer YOUR_DRAGONAPI_KEY。

请求参数 ​

model ​

string · 必填

固定为 MiniMax-H3。

prompt ​

string · 必填

描述主体、动作、场景、镜头和风格，最多 7000 个字符。

duration ​

integer · 可选 · 默认 5

视频时长，支持 4–15 秒。

resolution ​

string · 可选 · 默认 2K

可选 2K 或 768p。

aspect_ratio ​

string · 可选 · 默认 16:9

支持 21:9、16:9、4:3、1:1、3:4、9:16、adaptive。

image_with_roles ​

array · 可选

可选参考图。每项使用 {"url": "https://...", "role": "first_frame|last_frame|reference_image"}，最多 9 张。

video_with_roles ​

array · 可选

可选参考视频，最多 3 段，每项的 role 固定为 reference_video。

audio_with_roles ​

array · 可选

可选参考音频，最多 3 段，每项的 role 固定为 reference_audio。参考音频不能单独使用。

创建任务 ​

curl --request POST \
--url https://newapi.dragon3api.com/v1/videos \
--header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "model": "MiniMax-H3",
  "prompt": "月球基地的观景窗外出现蓝色地球，镜头缓慢推进",
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "16:9"
}'

查询任务 ​

提交成功后使用 GET /v1/videos/{task_id} 查询状态。状态为 completed 后，使用 GET /v1/videos/{task_id}/content 下载结果；失败时响应中的 error.message 会返回具体原因。

{
"id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
"object": "generation.task",
"model": "MiniMax-H3",
"status": "queued",
"progress": 0
}

模型、价格与服务规则以当前控制台为准。

DragonAPI