Seedance 2.0 Fast 怎么用?运镜提示词与 /v1/videos 异步任务接入
Seedance-2.0-Fast 走 POST /v1/videos 异步生成视频。
| 参数 | 值 |
|---|---|
| 模型 ID | Seedance-2.0-Fast |
| 类型 | 视频 |
| 调用端点 | POST /v1/videos,轮询 GET /v1/videos/{task_id} |
| 兼容协议 | OpenAI Videos API(multipart 表单) |
| 推荐客户端 | curl、Python requests |
| 计费方式 | 按次,实时价格见 定价页 |
Seedance 2.0 Fast 适合做什么,不适合做什么?
适合需要运镜控制的高清短视频和商业成片。
Seedance-2.0-Fast 是支持电影级运镜控制(Pan / Tilt / Zoom / Crane)的高清视频生成模型,动作流畅,光影质感接近商业成片。
适合的场景:
- 广告、产品展示短片
- 带推拉摇移运镜的叙事镜头
- 社交平台的高质量短视频
不太适合:需要大量试错的分镜草稿,用 Seedance-2.0-Mini 成本更低。
Seedance-2.0-Fast 的 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-Fast
怎么用 API 生成 Seedance-2.0-Fast 视频?
先 POST /v1/videos 提交任务,再轮询状态,完成后下载。
第一步,用 multipart 表单提交任务,字段为 model、prompt、seconds:
curl https://deepclub.net/v1/videos \
-H "Authorization: Bearer $DEEPCLUB_API_KEY" \
-F model=Seedance-2.0-Fast \
-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-Fast 视频任务?
用 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-Fast"),
"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 Fast 的运镜提示词怎么写?
按“镜头运动 + 主体 + 环境 + 光线”的顺序描述。
例如:镜头从低角度缓慢上摇(Tilt Up),一位穿红色风衣的女孩站在雨夜街头,霓虹灯倒映在积水中,侧逆光。一个提示词只写一种主要运镜,效果更稳定。
常用运镜词:推近(Zoom In / Dolly In)、拉远(Zoom Out)、横摇(Pan)、上下摇(Tilt)、升降(Crane)、环绕(Orbit)。
Seedance-2.0-Fast API 怎么计费?
按次计费,每成功生成一次计一次。
实时价格见 定价页。
- 计费单位:按次,价格可能调整,以 定价页 实时显示为准。
- 用量明细:在控制台 使用日志 中按请求查看消耗。
- 充值方式:支持 PayPal、Visa/Mastercard、支付宝。
调用 Seedance-2.0-Fast 报 401 怎么办?
401 表示密钥无效或缺失,先检查 Key 是否完整。
- 确认 API Key 前后没有空格或换行,且令牌未被禁用、未过期。
- 请求头格式为 Authorization: Bearer sk-...。
- 如果返回 404,检查 Base URL 是否为
https://deepclub.net/v1,模型名是否为Seedance-2.0-Fast。
用 Seedance-2.0-Fast 时请求内容会被存储或用于训练吗?
不会,深云 DeepClub 实行零留存(ZDR)政策。
深云 DeepClub 实行 Zero Data Retention (ZDR) 零留存政策:请求的输入和输出内容不做持久化存储,也不会用于模型训练,详见 隐私政策。
使用 Seedance 2.0 Fast 还有哪些常见问题?
以下问答汇总了调用时最常见的问题。
调用 Seedance-2.0-Fast 返回 401 Unauthorized 怎么办?
401 表示密钥无效或缺失,先检查 API Key 是否复制完整、前后没有空格。请求头格式为 Authorization: Bearer sk-...。
Seedance-2.0-Fast 用哪个接口生成视频?
先用 POST /v1/videos 以 multipart 表单提交 model、prompt、seconds,再轮询 GET /v1/videos/{task_id},完成后从 GET /v1/videos/{task_id}/content 下载。
Seedance-2.0-Fast API 怎么计费?
按次计费,每成功生成一次计一次。实时价格见 https://deepclub.net/pricing/Seedance-2.0-Fast。
Seedance 2.0 Fast 的运镜提示词怎么写?
按“镜头运动 + 主体 + 环境 + 光线”的顺序描述。
常见问题
- 调用 Seedance-2.0-Fast 返回 401 Unauthorized 怎么办?
- 401 表示密钥无效或缺失,先检查 API Key 是否复制完整、前后没有空格。请求头格式为 Authorization: Bearer sk-...。
- Seedance-2.0-Fast 用哪个接口生成视频?
- 先用 POST /v1/videos 以 multipart 表单提交 model、prompt、seconds,再轮询 GET /v1/videos/{task_id},完成后从 GET /v1/videos/{task_id}/content 下载。
- Seedance-2.0-Fast API 怎么计费?
- 按次计费,每成功生成一次计一次。实时价格见 https://deepclub.net/pricing/Seedance-2.0-Fast。
- Seedance 2.0 Fast 的运镜提示词怎么写?
- 按“镜头运动 + 主体 + 环境 + 光线”的顺序描述。
更新于