Skip to content

PixVerse-V6-Max 文生视频 API 使用文档 ​

PixVerse V6 Max(v6-max)支持根据文字描述生成视频,可设置 1~15 秒时长、8 种画幅比例,最高输出 1080p 画质,并可开启音频生成。通过 DMXAPI 采用「提交任务 → 获取结果」两步异步模式:先提交生成任务获取 response_id,再通过 GET 轮询任务状态及视频结果。

模型名称 ​

  • v6-max

接口地址 ​

接口请求方式URL
提交任务POSThttps://www.dmxapi.cn/v1/responses
获取结果GEThttps://www.dmxapi.cn/v1/responses/{response_id}

异步调用说明

创建任务时设置 background: true,并保存响应中的顶层 id(格式为 resp_...)。查询时将它替换到 URL 的 {response_id} 位置,不保留花括号;GET 无需请求体,也无需指定查询模型。

API Key 安全

请妥善保管您的 API Key。示例中的 YOUR_DMXAPI_API_KEY 为占位值,实际使用时建议从环境变量或密钥管理服务读取,勿将真实密钥提交到公开代码仓库。

文生视频 示例代码 ​

python
import json

import requests

# ===============================================================
# 步骤1:配置 API 连接信息
# ===============================================================

url = "https://www.dmxapi.cn/v1/responses"
api_key = "YOUR_DMXAPI_API_KEY"  # 请替换为自己的 DMXAPI API Key
request_timeout = 60  # 单次请求超时时间,单位:秒

# ===============================================================
# 步骤2:配置请求头
# ===============================================================

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {api_key}",
    "Accept": "application/json",
}

# ===============================================================
# 步骤3:配置请求参数
# ===============================================================

payload = {
    # 【model】(string, 必填) 固定为 v6-max
    "model": "v6-max",

    # 【input】(string, 必填) 视频提示词,最多 5000 个字符
    "input": (
        "10秒电影级写实视频,未来厨房中,一个银白色机器人正在制作拉面。"
        "镜头从沸腾的汤锅特写开始,机器人捞起面条,热气缓缓升起。"
        "摄影机围绕料理台缓慢移动,机器人依次加入鸡蛋、葱花和海苔,"
        "最后把拉面推到镜头前。动作连贯,光影真实,保持物体数量和位置一致,"
        "无文字、无Logo。"
    ),

    # 【duration】(integer, 必填) 1~15 秒
    "duration": 10,

    # 【quality】(string, 必填) 360p / 540p / 720p / 1080p
    "quality": "1080p",

    # 【aspect_ratio】(string, 必填) 文生视频需指定画幅比例
    # 支持 16:9 / 9:16 / 4:3 / 3:4 / 1:1 / 2:3 / 3:2 / 21:9
    "aspect_ratio": "16:9",

    # 【generate_audio_switch】(boolean, 可选) 开启音频生成会增加费用
    "generate_audio_switch": True,

    # 【seed】(integer, 可选) 范围 0~2147483647;需要时取消注释
    # "seed": 12345,
}

# ===============================================================
# 步骤4:发送请求并输出结果
# ===============================================================


def main():
    if not api_key.strip() or api_key == "YOUR_DMXAPI_API_KEY":
        raise ValueError("请先配置自己的 DMXAPI API Key。")
    if payload.get("model") != "v6-max":
        raise ValueError("model 必须为 v6-max。")
    prompt = payload.get("input")
    if not isinstance(prompt, str) or not prompt.strip() or len(prompt) > 5000:
        raise ValueError("input 必须为非空字符串,且不超过 5000 个字符。")
    duration = payload.get("duration")
    if type(duration) is not int or not 1 <= duration <= 15:
        raise ValueError("duration 必须为 1~15 的整数。")
    if payload.get("quality") not in {"360p", "540p", "720p", "1080p"}:
        raise ValueError("quality 不在支持的清晰度范围内。")
    if payload.get("aspect_ratio") not in {
        "16:9", "9:16", "4:3", "3:4", "1:1", "2:3", "3:2", "21:9"
    }:
        raise ValueError("aspect_ratio 不在支持的画幅比例范围内。")

    # background 是 Responses 控制参数,固定为 True,启用异步任务。
    request_body = {**payload, "background": True}
    response = requests.post(
        url, headers=headers, json=request_body, timeout=request_timeout
    )

    print("status_code:", response.status_code)
    request_id = response.headers.get("x-request-id", "")
    if request_id:
        print("header_request_id:", request_id)

    if "text/html" in response.headers.get("Content-Type", "").lower():
        raise RuntimeError("网关返回了 HTML 页面,请检查接口地址及模型服务配置。")
    try:
        result = response.json()
    except ValueError as exc:
        print(response.text)
        raise RuntimeError("网关返回的不是有效 JSON。") from exc

    print(json.dumps(result, indent=2, ensure_ascii=False))
    if not response.ok:
        raise RuntimeError(f"创建文生视频任务失败:HTTP {response.status_code}")
    if not isinstance(result, dict):
        raise RuntimeError("创建响应必须为 JSON 对象。")

    response_id = result.get("id")
    if not isinstance(response_id, str) or not response_id.startswith("resp_") or not response_id[5:]:
        raise RuntimeError("创建响应缺少有效的网关 response_id(resp_...)。")
    if result.get("status") not in {"queued", "in_progress", "completed"}:
        raise RuntimeError(f"创建响应状态异常:{result.get('status')!r}")

    print("网关 response_id:", response_id)
    print("请将该值填入下方 GET 示例的 params['response_id']。")


if __name__ == "__main__":
    main()

返回示例 ​

以下为创建响应的公共字段结构示意,实际响应可能包含其他字段。

json
status_code: 200
{
  "background": true,
  "completed_at": null,
  "created_at": 1793963454,
  "error": null,
  "id": "resp_RrqatpEfV1pl02KEUVsLYyJR6pXGF71n",
  "incomplete_details": null,
  "metadata": {
    "retrieval_path": "/v1/responses/resp_RrqatpEfV1pl02KEUVsLYyJR6pXGF71n",
    "task_id": "task_RrqatpEfV1pl02KEUVsLYyJR6pXGF71n",
    "task_status": "queued"
  },
  "model": "v6-max",
  "object": "response",
  "output": [],
  "status": "queued",
  "usage": null
}
网关 response_id: resp_RrqatpEfV1pl02KEUVsLYyJR6pXGF71n
请将该值填入下方 GET 示例的 params['response_id']。

获取结果 示例代码 ​

python
import json
import time
from urllib.parse import quote

import requests

# ===============================================================
# 步骤1:配置 API 连接信息
# ===============================================================

url = "https://www.dmxapi.cn/v1/responses"
api_key = "YOUR_DMXAPI_API_KEY"  # 与提交任务时使用的 DMXAPI API Key 一致
poll_interval_seconds = 20
max_wait_seconds = 1800
request_timeout = 60

# ===============================================================
# 步骤2:配置请求头
# ===============================================================

headers = {
    "Authorization": f"Bearer {api_key}",
    "Accept": "application/json",
}

# ===============================================================
# 步骤3:配置路径参数
# ===============================================================

params = {
    # 填入创建任务返回的顶层 id;不要填写整数 video_id 或 x-request-id。
    "response_id": "resp_...",
}

# ===============================================================
# 步骤4:发送 GET 请求,轮询并输出结果
# ===============================================================


def print_result(result):
    if isinstance(result, (dict, list)):
        print(json.dumps(result, indent=2, ensure_ascii=False))
    else:
        print(result)


def main():
    if not api_key.strip() or api_key == "YOUR_DMXAPI_API_KEY":
        raise ValueError("请先配置自己的 DMXAPI API Key。")
    response_id = params.get("response_id")
    if (
        not isinstance(response_id, str)
        or not response_id.startswith("resp_")
        or not response_id[5:]
        or response_id == "resp_..."
    ):
        raise ValueError("response_id 必须替换为创建任务实际返回的 resp_...。")
    if min(poll_interval_seconds, max_wait_seconds, request_timeout) <= 0:
        raise ValueError("轮询间隔、等待上限和请求超时时间必须大于 0。")

    # params 是本地配置字典;response_id 拼入 URL 路径,不作为查询字符串发送。
    query_url = f"{url}/{quote(response_id, safe='')}"
    deadline = time.monotonic() + max_wait_seconds
    transient_errors = 0

    def wait_before_retry(seconds):
        remaining = deadline - time.monotonic()
        if remaining <= 0:
            raise TimeoutError("轮询等待已达到上限,请保留 response_id 稍后查询。")
        time.sleep(min(seconds, remaining))

    while True:
        remaining = deadline - time.monotonic()
        if remaining <= 0:
            raise TimeoutError("轮询等待已达到上限,请保留 response_id 稍后查询。")

        try:
            response = requests.get(
                query_url,
                headers=headers,
                timeout=min(request_timeout, remaining),
            )
        except requests.RequestException as exc:
            transient_errors += 1
            if transient_errors >= 3:
                raise RuntimeError(f"查询连续失败 3 次:{exc}") from exc
            print(f"查询网络异常({transient_errors}/3),稍后重试:{exc}")
            wait_before_retry(poll_interval_seconds)
            continue

        print("status_code:", response.status_code)
        request_id = response.headers.get("x-request-id", "")
        if request_id:
            print("header_request_id:", request_id)
        try:
            result = response.json()
        except ValueError:
            result = response.text

        if response.status_code in {429, 500, 502, 503, 504}:
            transient_errors += 1
            if transient_errors >= 3:
                print_result(result)
                raise RuntimeError(f"查询连续失败 3 次,当前 HTTP {response.status_code}。")
            retry_after = response.headers.get("Retry-After", "")
            wait_seconds = int(retry_after) if retry_after.isdigit() else poll_interval_seconds
            print(f"查询暂时失败({transient_errors}/3),{wait_seconds} 秒后重试。")
            wait_before_retry(wait_seconds)
            continue

        if "text/html" in response.headers.get("Content-Type", "").lower():
            raise RuntimeError("网关返回了 HTML 页面,请检查接口地址及模型服务配置。")
        if not response.ok:
            print_result(result)
            raise RuntimeError(f"查询失败:HTTP {response.status_code}")
        if not isinstance(result, dict):
            raise RuntimeError("查询响应必须为 JSON 对象。")
        if result.get("id") != response_id:
            raise RuntimeError("查询响应中的 id 与请求的 response_id 不一致。")
        transient_errors = 0

        status = result.get("status")
        if status == "completed":
            print("任务已完成,完整结果如下:")
            print_result(result)
            return
        if status in {"queued", "in_progress"}:
            print(f"任务处理中(status={status}),{poll_interval_seconds} 秒后继续查询。")
            wait_before_retry(poll_interval_seconds)
            continue
        if status in {"failed", "incomplete"}:
            print_result(result)
            raise RuntimeError(f"任务未成功(status={status}),请查看返回的错误信息。")

        print_result(result)
        raise RuntimeError(f"无法识别的任务状态:{status!r}")


if __name__ == "__main__":
    main()

返回示例 ​

json
status_code: 200
任务处理中(status=in_progress),20 秒后继续查询。
status_code: 200
任务处理中(status=in_progress),20 秒后继续查询。
status_code: 200
任务处理中(status=in_progress),20 秒后继续查询。
status_code: 200
任务已完成,完整结果如下:
{
  "created_at": 1793963454,
  "error": null,
  "id": "resp_RrqatpEfV1pl02KEUVsLYyJR6pXGF71n",
  "incomplete_details": null,
  "instructions": null,
  "metadata": {
    "retrieval_path": "/v1/responses/resp_RrqatpEfV1pl02KEUVsLYyJR6pXGF71n",
    "task_id": "task_RrqatpEfV1pl02KEUVsLYyJR6pXGF71n",
    "task_status": "completed",
    "vendor": "pixverse-v6-max"
  },
  "model": "v6-max",
  "object": "response",
  "output": [
    {
      "content": [
        {
          "annotations": [],
          "id": "content_task_RrqatpEfV1pl02KEUVsLYyJR6pXGF71n_0_0",
          "logprobs": [],
          "text": "<video controls src=\"https://media.pixverseai.cn/pixverse%2Fmp4%2Fmedia%2Fweb%2Fori%2F1789899a-0f37-4143-ba13-c637f9f7f27f_seed2098526161.mp4\"></video>",
          "type": "output_text"
        }
      ],
      "id": "item_task_RrqatpEfV1pl02KEUVsLYyJR6pXGF71n_0",
      "role": "assistant",
      "status": "completed",
      "type": "message"
    }
  ],
  "parallel_tool_calls": true,
  "status": "completed",
  "temperature": 1,
  "tool_choice": "auto",
  "tools": [],
  "top_p": 1,
  "usage": {
    "input_tokens": 0,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 0,
    "output_tokens_details": {
      "reasoning_tokens": 0
    },
    "total_tokens": 0,
    "cost": "¥8.21"
  }
}

© 2026 DMXAPI PixVerse-V6-Max 文生视频

一个 Key 用全球大模型