长叙事、精细参考控制或编辑可先试 Seedance 2.5,多模态音视频可先试 2.0。TTAPI 同时提供独立优惠的 Fast 和 Mini。上线前请用同一任务对比成片和费用。
Seedance 2.5 与 2.0:先试哪个版本
TTAPI 列出四个 Seedance 模型 ID。字节跳动将 2.5 面向更长的音视频叙事、精细参考控制与编辑,将 2.0 面向文本、图像、音频和视频的多模态参考及同步声音。Fast 和 Mini 是目录中的独立档位。
先明确任务是可控运镜、多模态片段还是低成本草稿。横向对比时固定提示词、输入素材、时长、分辨率及验收要求。
| 模型 | 模型 ID | 计费规则 |
|---|---|---|
| Seedance 2.5 | doubao-seedance-2-5-260628 | 官方定价 |
| Seedance 2.0 | doubao-seedance-2-0-260128 | 官方定价 |
| Seedance 2.0 Fast | doubao-seedance-2-0-fast-260128 | 比官方价低 35% |
| Seedance 2.0 Mini | doubao-seedance-2-0-mini-260615 | 比官方价低 45% |
目录列出该系列的计费规则。提交前请查看当前价格和控制台账单,再估算任务成本。
Seedance 2.5 示例:微缩定格场景
Seedance 2.5 侧重叙事片段、参考理解和编辑。官方示例用毛毡世界、小动物、柔光和定格动作呈现一段故事,可观察运动和材质能否连续保持一致。
上游介绍提到最长 30 秒;TTAPI 当前文生视频接口的 duration 可设 4 至 15 秒,或用 -1 智能选择。实际请求应按对应接口填写。
Generate a 10-second warm and healing stop-motion-style video of small animals. The scene is a handmade miniature grassland set, with soft morning sunlight falling on a small meadow full of wildflowers. The little rabbit and squirrel in the frame have an adorable handmade felt / wool-felt toy texture, fluffy yet with clearly visible handcrafted fibers, and their movements show a subtle frame-by-frame stop-motion feel.
Seedance 2.0 示例:同时看画面与声音
Seedance 2.0 支持同步声音及多模态参考。披萨店公开视频适合同时评审动作、声音,以及前景与背景的关系。
文生视频、图生视频、全模态参考、编辑与续写在 TTAPI 中各有请求结构,即使提交地址相同也要按所选操作查文档。编辑和续写说明明确提到 Seedance 2.5,应用到 2.0 系列前请确认支持。
Single continuous cinematic shot, no music. From outside the glass window, the dim camera slowly pushes inward into a pizza shop. A bearded white male employee is baking pizza. He removes the pizza from the oven with a metal tray, places it into a red takeaway box, closes the lid, then hands it to a customer with a warm smile. Final shot: over-the-shoulder perspective.
用 TTAPI 提交 Seedance 视频任务
文生视频要求 model 和 content,每个 content 项含 type=text 及文字提示词。示例请求 720p、16:9、10 秒的 Seedance 2.5 视频,并启用 generate_audio。填写 ratio 时必须显式指定,接口不接受 adaptive。密钥应保存在服务端。
提交成功后返回异步任务 id,请先保存。查询接口用 POST,并将 id 放在路径中,状态包括 queued、running、succeeded、failed、cancelled 和 expired。TTAPI 文档列出的查询期为 7 天,生成视频网址有效期为 24 小时,请尽快下载。
curl --request POST \
--url 'https://api.ttapi.io/sd/api/v3/contents/generations/tasks' \
--header "TT-API-KEY: $TTAPI_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-2-5-260628",
"content": [
{
"type": "text",
"text": "A handmade felt rabbit crosses a miniature meadow at sunrise. Slow camera push, visible wool fibers, gentle frame-by-frame motion."
}
],
"ratio": "16:9",
"duration": 10,
"resolution": "720p",
"generate_audio": true
}'- 使用文档中的模型 ID
- 提交成功后保存任务 ID
- 发布前核对画面动作与声音
- 确认所选模型和操作的当前费用
按任务 ID 取回视频
使用提交返回的 id 查询原任务。succeeded 时,视频位于 content.video_url;如果提交时启用了 return_last_frame,还可能有 content.last_frame_url。只有 queued 或 running 时继续等待,对失败、取消和过期应单独处理,避免自动发起新的付费任务。
将示例中的 $TASK_ID 换成服务端保存的任务 id。下载要使用的视频,返回链接有有效期。
curl --request POST \
--url "https://api.ttapi.io/sd/api/v3/contents/generations/tasks/$TASK_ID" \
--header "TT-API-KEY: $TTAPI_KEY"