Skip to content

PixVerse-C1 文生视频 API 使用文档

PixVerse-C1 是拍我 AI(PixVerse)最新一代 C1 系列文生视频模型,通过文本提示词驱动生成高质量短视频。相比前代模型,C1 支持 1~15 秒任意时长自由选择、最高 1080p 画质,覆盖 8 种画幅比例(含 21:9 超宽与 2:3/3:2 等竖屏/横屏场景),并内置可开关的 AI 配音(generate_audio_switch)能力。支持 0~2147483647 范围的 seed 随机数控制以复现结果,normal/fast 双运动模式以及特效模板(template_id)扩展,适合营销素材、短视频创意、游戏概念演示等多场景的快速视觉生产。

模型名称

  • PixVerse-C1

接口地址

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

WARNING

请妥善保管您的 API Key!严禁将密钥泄露给他人、硬编码到代码中或提交到公开的代码仓库。

文生视频 示例代码

python
import requests
import json

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

# DMXAPI 服务端点地址
url = "https://www.dmxapi.cn/v1/responses"

# DMXAPI 密钥 (请替换为您自己的密钥)
# 获取方式: 登录 DMXAPI 官网 -> 个人中心 -> API 密钥管理
api_key = "sk-******************************************"

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

headers = {
    "Content-Type": "application/json",      # 指定请求体为 JSON 格式
    "Authorization": f"{api_key}",           # token 认证方式
}

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

payload = {
    # 【model】(string, 必需) 使用的视频生成模型名称
    # 本文档仅演示 PixVerse-C1 模型;模型值由 DMXAPI 侧路由到官方 c1 系列
    "model": "PixVerse-C1",

    # 【input】(string, 必需) 文本提示词(prompt),描述希望生成的视频画面内容
    # 长度限制: 5000 Characters 以内
    "input": "可爱的小猫在海边愉快的玩耍",

    # 【duration】(integer, 必需) 视频生成时长(秒)
    # v3.5/v4/v4.5: 5/8 (v3.5 1080p 无法使用 8)
    # v5: 5/8
    # v5.5/v5.6: 5/8/10 (1080p 无法使用 10)
    # v6/c1: 1~15 任意时长
    "duration": 5,

    # 【quality】(string, 必需) 视频分辨率
    # 可选值: "360p" / "540p" / "720p" / "1080p"
    "quality": "540p",

    # 【aspect_ratio】(string, 必需) 画幅比例
    # 基础提供: "16:9","9:16","4:3","3:4","1:1"
    # v6/c1 扩展支持: "16:9","9:16","4:3","3:4","1:1","2:3","3:2","21:9"
    "aspect_ratio": "16:9",

    # 【generate_audio_switch】(boolean, 可选) 音频开关
    # 支持 v5.5 / v5.6 / v6 / c1
    # true: Audio on (开启音频)
    # false: Audio off (关闭音频)
    "generate_audio_switch": True,

    # 【seed】(integer, 可选) 随机数种子,用于复现生成结果
    # 取值范围: 0 - 2147483647
    "seed": 0,

    # 【negative_prompt】(string, 可选) 负向提示词,用于描述不希望在视频中出现的元素
    # 长度限制: 2048 Characters 以内(根据示例代码推断,官方请求参数文档未单独列出)
    "negative_prompt": "string",

    # 【motion_mode】(string, 可选) 运动模式
    # PixVerse-C1 模型仅支持 "normal"(经实测验证)
    # "fast" 模式仅适用于 v3.5 / v4 / v4.5 模型,C1 传 "fast" 将返回 HTTP 400
    # 错误码: pixverse_c1_400017 "motion_mode:fast is only supported for models v3.5, v4, and v4.5."
    "motion_mode": "normal",

    # 【template_id】(integer, 可选) 模板(特效)ID
    # 使用前需先在平台激活对应模板;传 0 表示不使用特效模板
    "template_id": 0,
}

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

# 发送 POST 请求到 API 服务器
response = requests.post(url, headers=headers, json=payload)

# 格式化输出 JSON 响应
# - indent=2: 缩进 2 空格,便于阅读
# - ensure_ascii=False: 正确显示中文字符
print(json.dumps(response.json(), indent=2, ensure_ascii=False))

返回示例

json
{
  "ErrCode": 0,
  "ErrMsg": "success",
  "Resp": {
    "video_id": 397959714188216,
    "credits": 50
  },
  "usage": {
    "total_tokens": 150000,
    "input_tokens": 0,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 150000,
    "output_tokens_details": {
      "reasoning_tokens": 0
    }
  }
}

返回的 Resp.video_id 即为异步生成任务的 ID,请保存该值并在下一步「获取结果」接口中作为 input 传入。

获取结果 示例代码

python
import requests
import json

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

# DMXAPI 服务端点地址
url = "https://www.dmxapi.cn/v1/responses"

# DMXAPI 密钥 (请替换为您自己的密钥)
# 获取方式: 登录 DMXAPI 官网 -> 个人中心 -> API 密钥管理
api_key = "sk-******************************************"

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

headers = {
    "Content-Type": "application/json",      # 指定请求体为 JSON 格式
    "Authorization": f"{api_key}",           # token 认证方式
}

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

payload = {
    # 【model】(string, 必需) 固定值 "paiwo-get",表示调用拍我 AI 视频任务查询接口
    "model": "paiwo-get",

    # 【input】(string, 必需) 上一步「提交任务」接口返回的 Resp.video_id
    # 该 ID 用于查询对应视频生成任务的最新状态与结果 URL
    "input": "398402303529744",
}

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

# 发送 POST 请求到 API 服务器
response = requests.post(url, headers=headers, json=payload)

# 格式化输出 JSON 响应
# - indent=2: 缩进 2 空格,便于阅读
# - ensure_ascii=False: 正确显示中文字符
print(json.dumps(response.json(), indent=2, ensure_ascii=False))

返回示例

json
{
  "ErrCode": 0,
  "ErrMsg": "Success",
  "Resp": {
    "id": 398402303529744,
    "prompt": "可爱的小猫在海边愉快的玩耍",
    "negative_prompt": "string",
    "url": "https://media.pixverseai.cn/pixverse%2Fmp4%2Fmedia%2Fweb%2Fori%2F5d302b9d-4d96-43d1-9729-ca3502a2af8c_seed1949340905.mp4",
    "status": 1,
    "seed": 1949340905,
    "create_time": "2026-04-20T03:12:09Z",
    "modify_time": "2026-04-20T03:12:43Z",
    "outputWidth": 1024,
    "outputHeight": 576,
    "has_audio": true,
    "credits": 50
  }
}

返回的 Resp.url 字段即为最终可下载/播放的视频链接。

© 2026 DMXAPI PixVerse-C1 文生视频

一个 Key 用全球大模型