Seedance 豆包文生视频 API 接口
📡 接口地址
- 提交视频任务:
https://www.dmxapi.cn/v1/videos - 查询视频结果:
https://www.dmxapi.cn/v1/videos/{id}
🎯 模型名称
doubao-seedance-1-0-pro-250528doubao-seedance-1-0-pro-fast-251015doubao-seedance-1-0-lite-t2v-250428
⚙️ 支持参数
全部参数
💻 提交视频任务 python 示例代码
python
"""
╔══════════════════════════════════════════════════════════════════════════════╗
║ DMX API - 即梦文生视频示例 ║
╠══════════════════════════════════════════════════════════════════════════════╣
║ 功能说明：通过 HTTP 请求调用 DMX API 生成 AI 视频 ║
║ 使用步骤：配置接口地址 → 设置认证信息 → 编写提示词 → 发送请求 ║
║ 环境依赖：pip install requests ║
╚══════════════════════════════════════════════════════════════════════════════╝
"""
import requests
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# 接口配置
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# DMXAPI 接口地址
url = "https://www.dmxapi.cn/v1/videos"
# 认证头部（请替换为你自己的 API Key）
# ⚠️ 安全提示：请勿将真实密钥提交到公共仓库或分享给他人
headers = {
"Authorization": "Bearer sk-*****************************************"
}
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# 模型与提示词配置
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# 使用的模型名称（可根据平台支持的模型列表进行替换）
model = "doubao-seedance-1-0-pro-fast-251015"
# 视频生成提示词（文字描述 + 参数配置）
# 💡 建议：从简单提示词开始，逐步添加参数进行微调
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 格式的表单数据
files = {
"prompt": (None, prompt), # 视频生成提示词
"model": (None, model) # 使用的模型名称
}
# 发送 POST 请求并获取响应
response = requests.post(url, headers=headers, files=files)
# 输出响应结果（用于调试和排查问题）
print("━" * 80)
print(f"📡 HTTP 状态码: {response.status_code}")
print("━" * 80)
print(f"📄 响应内容:{response.text}")
print("━" * 80)返回示例
json
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📡 HTTP 状态码: 200
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📄 响应内容:{"id":"cgt-20251110170625-bwf78","object":"video","model":"doubao-seedance-1-0-pro-fast-251015","created_at":1762765518}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━📤查询视频结果 python示例代码
python
"""
视频查询接口测试脚本
功能：通过视频ID查询视频生成任务的状态和结果
"""
import requests
import json
# ========== 配置参数 ==========
# 视频任务ID
id = "cgt-20251110170625-bwf78"
# 构建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)返回示例
json
{
"id": "cgt-20251110170625-bwf78",
"object": "video",
"model": "doubao-seedance-1-0-pro-fast-251015",
"status": "completed",
"progress": 100,
"created_at": 1762765518,
"completed_at": 1762765567,
"meta_data": {
"url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-1-0-pro-fast/02176276558580900000000000000000000ffffac183380bdc6b6.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20251110%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20251110T090713Z&X-Tos-Expires=86400&X-Tos-Signature=a5908610b98bb1f53089efd673b455d90df71da9b5ec0c308d0b89c500af46a9&X-Tos-SignedHeaders=host"
},
"video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-1-0-pro-fast/02176276558580900000000000000000000ffffac183380bdc6b6.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20251110%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20251110T090713Z&X-Tos-Expires=86400&X-Tos-Signature=a5908610b98bb1f53089efd673b455d90df71da9b5ec0c308d0b89c500af46a9&X-Tos-SignedHeaders=host"
}© 2025 DMXAPI Seedance...