Seedance 2.0 Mini 怎么用?低成本批量分镜预演 API 教程
Seedance-2.0-Mini 走 POST /v1/videos 异步生成视频。
| 参数 | 值 |
|---|---|
| 模型 ID | Seedance-2.0-Mini |
| 类型 | 视频 |
| 调用端点 | POST /v1/videos,轮询 GET /v1/videos/{task_id} |
| 兼容协议 | OpenAI Videos API(multipart 表单) |
| 推荐客户端 | curl、Python requests |
| 计费方式 | 按次,实时价格见 定价页 |
Seedance 2.0 Mini 适合做什么,不适合做什么?
适合批量跑分镜头、动态草图和创意预演。
Seedance-2.0-Mini 是轻量视频生成模型,生成速度快、价格低,适合短视频创作者大批量跑分镜和验证创意。
适合的场景:
- 把分镜脚本逐镜头生成预览
- 同一创意的多版本对比
- 自媒体矩阵的大量素材
不太适合:最终交付的高质量成片,可在定稿后换用 Seedance-2.0-Fast。
Seedance-2.0-Mini 的 Base URL 和 API Key 怎么获取?
Base URL 填 deepclub.net/v1,Key 在控制台创建。
- 登录 深云 DeepClub,进入控制台的 API 令牌 页面。
- 点击 添加令牌,复制生成的
sk-开头密钥。 - 在客户端或代码中填写以下三项:
Base URL: https://deepclub.net/v1
API Key: sk-你的DeepClub密钥
Model: Seedance-2.0-Mini
怎么用 API 生成 Seedance-2.0-Mini 视频?
先 POST /v1/videos 提交任务,再轮询状态,完成后下载。
第一步,用 multipart 表单提交任务,字段为 model、prompt、seconds:
curl https://deepclub.net/v1/videos \
-H "Authorization: Bearer $DEEPCLUB_API_KEY" \
-F model=Seedance-2.0-Mini \
-F prompt="一只橘猫跳上窗台,望向窗外的雪景" \
-F seconds=5
返回 JSON 中的 id 就是任务 ID,初始 status 为 queued。
第二步,轮询任务状态,直到 status 变为 completed 或 failed:
curl https://deepclub.net/v1/videos/$TASK_ID \
-H "Authorization: Bearer $DEEPCLUB_API_KEY"
第三步,任务完成后下载视频文件:
curl -L https://deepclub.net/v1/videos/$TASK_ID/content \
-H "Authorization: Bearer $DEEPCLUB_API_KEY" \
-o output.mp4
seconds 是视频时长(秒),平台对时长设有上限,超出会返回 400。
用 Python 怎么轮询 Seedance-2.0-Mini 视频任务?
用 requests 提交表单,每隔数秒查询一次状态。
import time
import requests
BASE = "https://deepclub.net/v1"
headers = {"Authorization": "Bearer sk-你的DeepClub密钥"}
resp = requests.post(
f"{BASE}/videos",
headers=headers,
files={
"model": (None, "Seedance-2.0-Mini"),
"prompt": (None, "一只橘猫跳上窗台,望向窗外的雪景"),
"seconds": (None, "5"),
},
)
resp.raise_for_status()
task_id = resp.json()["id"]
while True:
task = requests.get(f"{BASE}/videos/{task_id}", headers=headers).json()
if task["status"] in ("completed", "failed"):
break
time.sleep(10)
if task["status"] == "completed":
video = requests.get(f"{BASE}/videos/{task_id}/content", headers=headers)
with open("output.mp4", "wb") as f:
f.write(video.content)
else:
print(task.get("error"))
Seedance 2.0 Mini 怎么批量生成分镜?
每个镜头提交一个任务,记录 task_id 后统一轮询。
把分镜脚本拆成一行一个镜头描述,循环调用 POST /v1/videos 并保存每个返回的 id。然后统一轮询,完成一个下载一个。
控制同时提交的任务数量,遇到 429 时等待后重试。每个成功生成的任务按次计费。
Seedance-2.0-Mini API 怎么计费?
按次计费,每成功生成一次计一次。
实时价格见 定价页。
- 计费单位:按次,价格可能调整,以 定价页 实时显示为准。
- 用量明细:在控制台 使用日志 中按请求查看消耗。
- 充值方式:支持 PayPal、Visa/Mastercard、支付宝。
调用 Seedance-2.0-Mini 报 401 怎么办?
401 表示密钥无效或缺失,先检查 Key 是否完整。
- 确认 API Key 前后没有空格或换行,且令牌未被禁用、未过期。
- 请求头格式为 Authorization: Bearer sk-...。
- 如果返回 404,检查 Base URL 是否为
https://deepclub.net/v1,模型名是否为Seedance-2.0-Mini。
用 Seedance-2.0-Mini 时请求内容会被存储或用于训练吗?
不会,深云 DeepClub 实行零留存(ZDR)政策。
深云 DeepClub 实行 Zero Data Retention (ZDR) 零留存政策:请求的输入和输出内容不做持久化存储,也不会用于模型训练,详见 隐私政策。
使用 Seedance 2.0 Mini 还有哪些常见问题?
以下问答汇总了调用时最常见的问题。
调用 Seedance-2.0-Mini 返回 401 Unauthorized 怎么办?
401 表示密钥无效或缺失,先检查 API Key 是否复制完整、前后没有空格。请求头格式为 Authorization: Bearer sk-...。
Seedance-2.0-Mini 用哪个接口生成视频?
先用 POST /v1/videos 以 multipart 表单提交 model、prompt、seconds,再轮询 GET /v1/videos/{task_id},完成后从 GET /v1/videos/{task_id}/content 下载。
Seedance-2.0-Mini API 怎么计费?
按次计费,每成功生成一次计一次。实时价格见 https://deepclub.net/pricing/Seedance-2.0-Mini。
Seedance 2.0 Mini 怎么批量生成分镜?
每个镜头提交一个任务,记录 task_id 后统一轮询。
常见问题
- 调用 Seedance-2.0-Mini 返回 401 Unauthorized 怎么办?
- 401 表示密钥无效或缺失,先检查 API Key 是否复制完整、前后没有空格。请求头格式为 Authorization: Bearer sk-...。
- Seedance-2.0-Mini 用哪个接口生成视频?
- 先用 POST /v1/videos 以 multipart 表单提交 model、prompt、seconds,再轮询 GET /v1/videos/{task_id},完成后从 GET /v1/videos/{task_id}/content 下载。
- Seedance-2.0-Mini API 怎么计费?
- 按次计费,每成功生成一次计一次。实时价格见 https://deepclub.net/pricing/Seedance-2.0-Mini。
- Seedance 2.0 Mini 怎么批量生成分镜?
- 每个镜头提交一个任务,记录 task_id 后统一轮询。
更新于