curl -X POST https://zx1.deepwl.net/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "一个男孩在海边打篮球"
}
],
"metadata": {
"duration": 5,
"resolution": "2K",
"ratio": "16:9",
"aigc_watermark": false
}
}'
curl -X POST https://zx1.deepwl.net/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "一个男孩在海边打篮球"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/first-frame.jpg"
},
"role": "first_frame"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/last-frame.jpg"
},
"role": "last_frame"
}
],
"metadata": {
"duration": 5,
"resolution": "2K",
"ratio": "adaptive",
"aigc_watermark": false
}
}'
curl -X POST https://zx1.deepwl.net/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "一个男孩在海边打篮球"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/reference.png"
},
"role": "reference_image"
},
{
"type": "video_url",
"video_url": {
"url": "https://example.com/reference.mp4"
},
"role": "reference_video"
},
{
"type": "audio_url",
"audio_url": {
"url": "https://example.com/bgm.wav"
},
"role": "reference_audio"
}
],
"metadata": {
"duration": 5,
"resolution": "2K",
"ratio": "adaptive",
"aigc_watermark": false
}
}'
{
"task_id": "424010985738629"
}
{
"error": {
"code": "InvalidParameter",
"message": "content must contain a non-empty text item (2013)",
"type": "new_api_error"
}
}
{
"error": {
"code": "Unauthorized",
"message": "Invalid API key provided",
"type": "new_api_error"
}
}
{
"error": {
"code": "Forbidden",
"message": "access denied",
"type": "new_api_error"
}
}
{
"error": {
"code": "UnprocessableEntity",
"message": "video description contains sensitive content (1026)",
"type": "new_api_error"
}
}
{
"error": {
"code": "RateLimitExceeded",
"message": "当前请求频率过高,请稍后再试",
"type": "new_api_error"
}
}
{
"error": {
"code": "InternalError",
"message": "internal server error",
"type": "new_api_error"
}
}
官方格式
创建视频(官方格式)
使用 POST /v1/video/generations 提交 MiniMax-H3 多模态视频生成任务。
POST
https://zx1.deepwl.net
/
v1
/
video
/
generations
curl -X POST https://zx1.deepwl.net/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "一个男孩在海边打篮球"
}
],
"metadata": {
"duration": 5,
"resolution": "2K",
"ratio": "16:9",
"aigc_watermark": false
}
}'
curl -X POST https://zx1.deepwl.net/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "一个男孩在海边打篮球"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/first-frame.jpg"
},
"role": "first_frame"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/last-frame.jpg"
},
"role": "last_frame"
}
],
"metadata": {
"duration": 5,
"resolution": "2K",
"ratio": "adaptive",
"aigc_watermark": false
}
}'
curl -X POST https://zx1.deepwl.net/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "一个男孩在海边打篮球"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/reference.png"
},
"role": "reference_image"
},
{
"type": "video_url",
"video_url": {
"url": "https://example.com/reference.mp4"
},
"role": "reference_video"
},
{
"type": "audio_url",
"audio_url": {
"url": "https://example.com/bgm.wav"
},
"role": "reference_audio"
}
],
"metadata": {
"duration": 5,
"resolution": "2K",
"ratio": "adaptive",
"aigc_watermark": false
}
}'
{
"task_id": "424010985738629"
}
{
"error": {
"code": "InvalidParameter",
"message": "content must contain a non-empty text item (2013)",
"type": "new_api_error"
}
}
{
"error": {
"code": "Unauthorized",
"message": "Invalid API key provided",
"type": "new_api_error"
}
}
{
"error": {
"code": "Forbidden",
"message": "access denied",
"type": "new_api_error"
}
}
{
"error": {
"code": "UnprocessableEntity",
"message": "video description contains sensitive content (1026)",
"type": "new_api_error"
}
}
{
"error": {
"code": "RateLimitExceeded",
"message": "当前请求频率过高,请稍后再试",
"type": "new_api_error"
}
}
{
"error": {
"code": "InternalError",
"message": "internal server error",
"type": "new_api_error"
}
}
创建视频(官方格式)
提交 MiniMax-H3 视频生成任务,支持文生视频、首帧/首尾帧、参考图/视频/音频等模式。方法与路径
POST /v1/video/generations
请求示例
curl -X POST https://zx1.deepwl.net/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "一个男孩在海边打篮球"
}
],
"metadata": {
"duration": 5,
"resolution": "2K",
"ratio": "16:9",
"aigc_watermark": false
}
}'
curl -X POST https://zx1.deepwl.net/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "一个男孩在海边打篮球"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/first-frame.jpg"
},
"role": "first_frame"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/last-frame.jpg"
},
"role": "last_frame"
}
],
"metadata": {
"duration": 5,
"resolution": "2K",
"ratio": "adaptive",
"aigc_watermark": false
}
}'
curl -X POST https://zx1.deepwl.net/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "一个男孩在海边打篮球"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/reference.png"
},
"role": "reference_image"
},
{
"type": "video_url",
"video_url": {
"url": "https://example.com/reference.mp4"
},
"role": "reference_video"
},
{
"type": "audio_url",
"audio_url": {
"url": "https://example.com/bgm.wav"
},
"role": "reference_audio"
}
],
"metadata": {
"duration": 5,
"resolution": "2K",
"ratio": "adaptive",
"aigc_watermark": false
}
}'
响应示例
{
"task_id": "424010985738629"
}
{
"error": {
"code": "InvalidParameter",
"message": "content must contain a non-empty text item (2013)",
"type": "new_api_error"
}
}
{
"error": {
"code": "Unauthorized",
"message": "Invalid API key provided",
"type": "new_api_error"
}
}
{
"error": {
"code": "Forbidden",
"message": "access denied",
"type": "new_api_error"
}
}
{
"error": {
"code": "UnprocessableEntity",
"message": "video description contains sensitive content (1026)",
"type": "new_api_error"
}
}
{
"error": {
"code": "RateLimitExceeded",
"message": "当前请求频率过高,请稍后再试",
"type": "new_api_error"
}
}
{
"error": {
"code": "InternalError",
"message": "internal server error",
"type": "new_api_error"
}
}
task_id。
认证
Authorization: Bearer YOUR_API_KEY
Body
string
必填
模型名称,当前仅支持
MiniMax-H3。array<object>
必填
多模态输入数组,顺序影响角色分配。
string
必填
内容类型:
text、image_url、video_url、audio_url。string
当
type=text 时必填,提示词文本。object
当
type=image_url 时使用,须包含 url。string
必填
图片公网 URL。支持 JPG、JPEG、PNG、WEBP、HEIC、HEIF;单文件不超过 30 MB;宽高范围为 256~5760 px;长宽比范围为 0.4~2.5。首帧 ≤ 1 张、尾帧 ≤ 1 张、参考图 ≤ 9 张。
object
当
type=video_url 时使用,须包含 url。string
必填
参考视频公网 URL。支持 MP4、MOV,编码为 H.264/AVC、H.265/HEVC;单文件不超过 50 MB;个数 ≤ 3;单段 2~15 秒、总时长不超过 15 秒;宽高范围为 256~5760 px;长宽比范围为 0.4~2.5;帧率范围为 23.976~60。
object
当
type=audio_url 时使用,须包含 url。string
必填
参考音频公网 URL。支持 WAV、MP3;单文件不超过 15 MB;个数 ≤ 3;单段 2~15 秒、总时长不超过 15 秒。
string
媒体角色:
first_frame:首帧(图片)last_frame:尾帧(图片)reference_image:参考图reference_video:参考视频reference_audio:参考音频
object
视频生成参数,均为可选。
integer
视频时长(秒)。合法范围
[4, 15],默认 5。string
分辨率:
768P、2K,默认 2K。string
宽高比:
adaptive、21:9、16:9、4:3、1:1、3:4、9:16。文生视频默认 16:9 且不能为 adaptive;图生视频强制 adaptive。boolean
是否在生成视频中添加 AIGC 标识水印,默认
false。content 混用规则
违反以下规则可能返回400:
reference_image/reference_video/reference_audio不能与first_frame/last_frame同时出现- 每次请求必须包含一个非空
text项(prompt 必填) - 请求体总大小不得超过 64 MB,大文件请使用公网 URL,不要使用 Base64
生成模式对照
Response
string
任务 ID,用于 查询任务(官方格式)。
相关接口
⌘I