🎬 豆包 SeeDance 图生视频 API 接口

📡 接口地址

提交视频任务: https://www.dmxapi.cn/v1/videos
查询视频结果: https://www.dmxapi.cn/v1/videos/{id}

🤖 模型名称

模型	说明
doubao-seedance-1-0-pro-250528	专业版模型
doubao-seedance-1-0-pro-fast-251015	专业快速版模型
doubao-seedance-1-0-lite-i2v-250428	轻量级图生视频模型

💡 温馨提示

任务数据仅保留 24 小时，超时后会被自动清除。请您务必及时保存生成的视频！

📤 提交视频任务

Python 示例代码

"""
===============================================
视频生成 DMXAPI 调用示例
===============================================
功能: 使用豆包视频生成模型,通过图片+文本提示词生成视频
API: DMX API - 视频生成接口
===============================================
"""

import requests
import os

# ============================================================
# API 配置
# ============================================================

# API 端点地址
url = "https://www.dmxapi.cn/v1/videos"

# 请求头配置 - 包含授权令牌
headers = {
    "Authorization": "Bearer sk-*******************************************"
}


# ============================================================
# 请求参数配置
# ============================================================

# 模型名称 - 使用豆包 SeeDance 视频生成模型
model = "doubao-seedance-1-0-pro-fast-251015"


# 参考图片路径 - 用于图生视频的输入图片
input_reference_path = "test/i2v_foxrgirl.png"

# 从路径中提取文件名
filename = os.path.basename(input_reference_path)


# 提示词
prompt = "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动  --resolution 1080p --ratio 16:9 --frames 145 --framespersecond 24 --watermark false --seed -1 --camerafixed false"
"""
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃                            📖 参数详细说明                               ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

提示词结构：文字描述 + 参数开关（--key value 格式）
💡 使用建议：按需选择参数，避免过度堆叠导致效果不稳定

┌─────────────────────────────────────────────────────────────────────────┐
│ 1️⃣  resolution - 分辨率                                                 │
├─────────────────────────────────────────────────────────────────────────┤
│  • doubao-seedance-1-0-pro / pro-fast 默认：1080p                       │
│  • 其他模型默认：720p                                                    │
│  • 可选值：480p / 720p / 1080p                                           │
└─────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────┐
│ 2️⃣  ratio - 宽高比                                                      │
├─────────────────────────────────────────────────────────────────────────┤
│  • doubao-seedance-1-0-pro / pro-fast 默认：16:9                        │
│  • doubao-seedance-1-0-lite-i2v（图生视频）默认：adaptive                │
│  • 可选值：16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / keep_ratio / adaptive │
│  • keep_ratio：与上传图片保持一致                                        │
│  • adaptive：根据图片自动选择最合适比例                                   │
│                                                                         │
│  📊 分辨率与比例对应像素表：                                              │
│                                                                         │
│  480p:                                                                  │
│    16:9 → 864×480   |  4:3 → 736×544   |  1:1 → 640×640                 │
│    3:4 → 544×736    |  9:16 → 480×864  |  21:9 → 960×416                │
│                                                                         │
│  720p:                                                                  │
│    16:9 → 1248×704  |  4:3 → 1120×832  |  1:1 → 960×960                 │
│    3:4 → 832×1120   |  9:16 → 704×1248 |  21:9 → 1504×640               │
│                                                                         │
│  1080p（参考图场景不支持）:                                               │
│    16:9 → 1920×1088 |  4:3 → 1664×1248 |  1:1 → 1440×1440               │
│    3:4 → 1248×1664  |  9:16 → 1088×1920 |  21:9 → 2176×928              │
└─────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────┐
│ 3️⃣  frames - 视频帧数                                                   │
├─────────────────────────────────────────────────────────────────────────┤
│  • 用途：控制生成视频的总帧数，影响视频时长                                 │
│  • 计算公式：时长（秒）= frames ÷ 帧率（如 24）                            │
│  • 取值范围：[29, 289] 内满足 25 + 4n 的整数（n 为正整数）                 │
│  • 示例：目标 2.4 秒，frames≈57.6，最接近可取 57，实际时长≈2.375 秒         │
└─────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────┐
│ 4️⃣  framespersecond - 视频帧率                                          │
├─────────────────────────────────────────────────────────────────────────┤
│  • 可选值：16 / 24                                                       │
└─────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────┐
│ 5️⃣  watermark - 水印                                                    │
├─────────────────────────────────────────────────────────────────────────┤
│  • 默认值：false                                                         │
│  • true：添加水印 | false：不添加水印                                     │
└─────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────┐
│ 6️⃣  seed - 随机种子                                                     │
├─────────────────────────────────────────────────────────────────────────┤
│  • 类型：Integer                                                         │
│  • 默认值：-1                                                            │
│  • 取值范围：[-1, 2³² - 1]                                               │
└─────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────┐
│ 7️⃣  camerafixed - 是否固定摄像机                                         │
├─────────────────────────────────────────────────────────────────────────┤
│  • 类型：Boolean                                                         │
│  • 默认值：false                                                         │
│  • true：平台可能在提示词中追加固定摄像机指令（效果不保证）                  │
│  • false：不固定摄像机                                                   │
└─────────────────────────────────────────────────────────────────────────┘
"""


# ============================================================
# 发送请求
# ============================================================

# 使用 multipart/form-data 格式提交数据
# 适用于需要上传文件的场景
with open(input_reference_path, 'rb') as img_file:
    
    # 构建表单数据
    files = {
        "model": (None, model),                                              # 模型名称
        "prompt": (None, prompt),                                            # 提示词
        "input_reference": (filename, img_file, "image/png")                 # 参考图片文件(文件名自动从路径提取)
    }
    
    # 发送 POST 请求
    response = requests.post(url, headers=headers, files=files)

    # ============================================================
    # 输出结果
    # ============================================================
    
    print("=" * 50)
    print("状态码:", response.status_code)
    print("=" * 50)
    print("响应内容:", response.json())
    print("=" * 50)

✅ 返回示例

==================================================
状态码: 200
==================================================
响应内容: {'id': 'cgt-20251110205147-zf8cq', 'object': 'video', 'model': 'doubao-seedance-1-0-pro-fast-251015', 'created_at': 1762779042}
==================================================

---

🔍 查询视频结果

Python 示例代码

"""
视频查询接口测试脚本
功能：通过视频ID查询视频生成任务的状态和结果
"""

import requests
import json

# ========== 配置参数 ==========
# 视频任务ID
id = "cgt-20251110205147-zf8cq"

# 构建API请求URL
url = f"https://www.dmxapi.cn/v1/videos/{id}"

# ========== 请求设置 ==========
# 请求体（GET请求为空）
payload = {}

# 请求头配置
headers = {
    'Authorization': 'Bearer sk-*******************************************'  # API密钥
}

# ========== 发送请求 ==========
# 发送GET请求查询视频任务状态
response = requests.request("GET", url, headers=headers, data=payload)

# ========== 处理响应 ==========
# 尝试解析并格式化打印JSON响应
try:
    json_data = response.json()
    # 使用缩进格式美化输出，确保中文正常显示
    print(json.dumps(json_data, indent=2, ensure_ascii=False))
except json.JSONDecodeError:
    # 如果响应不是有效的JSON格式，直接打印原始文本
    print("响应不是有效的JSON格式:")
    print(response.text)

✅ 返回示例

{
  "id": "cgt-20251110205147-zf8cq",
  "object": "video",
  "model": "doubao-seedance-1-0-pro-fast-251015",
  "status": "completed",
  "progress": 100,
  "created_at": 1762779042,
  "completed_at": 1762779087,
  "meta_data": {
    "url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-1-0-pro-fast/02176277910930500000000000000000000ffffac183380ecf1c1.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20251110%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20251110T125229Z&X-Tos-Expires=86400&X-Tos-Signature=5c6673efad24fc1ab60bd84df102104b1f3f094fd95543bdd24d5c468c1f275a&X-Tos-SignedHeaders=host"
  },
  "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-1-0-pro-fast/02176277910930500000000000000000000ffffac183380ecf1c1.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20251110%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20251110T125229Z&X-Tos-Expires=86400&X-Tos-Signature=5c6673efad24fc1ab60bd84df102104b1f3f094fd95543bdd24d5c468c1f275a&X-Tos-SignedHeaders=host"
}

© 2025 DMXAPI 图生视频