跳转到主要内容
MiniMax-H3

MiniMax-H3 视频生成

MiniMax-H3 视频生成模型。支持文生视频、图生视频(首帧/尾帧/首尾帧)和多模态参考生视频。

POST
/services/aigc/video-generation/video-synthesis
curl --location 'https://maas.qianwenaiapi.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "MiniMax/MiniMax-H3",
    "input": {
        "prompt": "Epic space opera trailer: a female captain stands alone before a giant observation window, the last fleet assembles and jumps away, bright flashes, bridge shakes, she is left behind."
    },
    "parameters": {
        "resolution": "768P",
        "ratio": "16:9",
        "duration": 5,
        "watermark": true
    }
}'
{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  }
}
  • Python SDK
import dashscope
import os
from dashscope.v2 import DashScopeError

# 若没有配置环境变量,请用千问AI平台API Key将下行替换为:api_key="sk-xxx"
# 获取API Key:https://platform.qianwenai.com/home/api-keys
client = dashscope.Client(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://maas.qianwenaiapi.com/api/v1",
)

def sample_async_call():
    # 异步提交视频生成任务
    try:
        job = client.videos.jobs.create(
            model='MiniMax/MiniMax-H3',
            prompt='史诗级太空歌剧院线预告:女舰长独自站在巨大观景窗前,最后一支舰队正在集结并跃迁离去,强光爆闪、舰桥震动,她被留在原地。',
            resolution='768P',
            ratio='16:9',
            duration=5,
            watermark=True)
        print(job)
        print("task_id: %s" % job.task_id)
    except DashScopeError as e:
        print(f"HTTP返回码:{e.status_code}")
        print(f"错误码:{e.code}")
        print(f"错误信息:{e.message}")
        print("请参考文档:/api-reference/preparation/error-messages")
        return

    # 查询任务状态
    try:
        snapshot = client.videos.jobs.fetch(job.task_id)
        print(snapshot.status)
    except DashScopeError as e:
        print(f"HTTP返回码:{e.status_code}")
        print(f"错误码:{e.code}")
        print(f"错误信息:{e.message}")
        print("请参考文档:/api-reference/preparation/error-messages")

    # 等待任务完成(指数退避轮询,默认总预算24小时)
    try:
        done = client.videos.jobs.wait(job)
        print(done)
        print(done.video_url)
    except DashScopeError as e:
        print(f"HTTP返回码:{e.status_code}")
        print(f"错误码:{e.code}")
        print(f"错误信息:{e.message}")
        print("请参考文档:/api-reference/preparation/error-messages")

if __name__ == '__main__':
    sample_async_call()

鉴权

string
header
必填

千问AI平台 API Key。详见获取与配置 API Key。

Header 参数

enum<string>
必填

必须设置为 enable,表示异步提交任务。缺少此请求头将报错:"current user api does not support synchronous calls"。

enable

请求体

application/json
enum<string>
必填

模型名称。固定值:MiniMax/MiniMax-H3。

MiniMax/MiniMax-H3
MiniMax/MiniMax-H3
object
必填

输入信息。

object

视频生成参数。

响应

200-application/json
string

请求唯一标识,用于链路追踪和问题排查。

4909100c-7b5a-9f92-bfe5-xxxxxx
object