Mage API · 视频模型
Seedance API
Seedance,内容过滤严格
POST https://api.mage.space/v1/seedance/generate一览
Seedance API 通过 Mage 在 POST https://api.mage.space/v1/seedance/generate 运行 Seedance 2.5 及另外 3 个版本。使用默认设置的一次请求花费 618 Gems(约 0.618 美元),无需订阅。Seedance 支持在提示词中通过 @handle 调用已保存的角色、参考素材和音频参考。
- 视频输出
- 4变体
- 618每段视频消耗的 Gems(默认)
- $0.618约合美元
概览
Seedance API 能做什么
字节跳动的 Seedance,从适合出草稿的 Seedance 2.0 Mini 到 Seedance 2.5,支持最长 30 秒的片段、多个参考素材或 Characters,以及基于源视频的编辑。严格过滤:适用提供方的内容过滤规则。
字节跳动的 Seedance 视频系列,具备电影级的运动效果,并支持音频:Seedance 2.0 Mini、Seedance 2.0 Fast、Seedance 2.0 和功能最强大的 Seedance 2.5,最长可生成 30 秒的视频片段。严格过滤:服务提供方的内容过滤器会检查提示词、输入的媒体和生成的成片;若请求被拒绝,将返回 `content_blocked` 及原因而失败,并会退还费用。
支持的输入包括 image、additional_images、videos。
快速开始
调用 Seedance API
设置 MAGE_API_KEY,向 /seedance/generate 提交请求,然后轮询 status_url,直到请求完成。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedance/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "seedance-2.5"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('seedance', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'seedance-2.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("seedance", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "seedance-2.5",
})
print(request["result"]["url"])模型
Seedance 的 model_id 值
传入 model_id 即可选择变体。未指定时将使用默认变体。
| model_id | 名称 | 默认 |
|---|---|---|
| seedance-2.0-mini | Seedance 2.0 Mini | |
| seedance-2.0-fast | Seedance 2.0 Fast | |
| seedance-2.0 | Seedance 2.0 | |
| seedance-2.5 | Seedance 2.5 | 是 |
选项
Seedance 参数
以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。
| 字段 | 取值 |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
输入
Seedance 接受的媒体输入
可通过 https 链接、data URL 或不超过 100 MB 的上传文件发送。
| 字段 | 用途 |
|---|---|
| image | 参考图片。 |
| additional_images | 额外的参考图片。 |
| videos | 源视频。 |
规则
Seedance API 的限制
- 视频编辑需要且只能有一个源视频:`seedance-2.5` 支持 4 到 30 秒,其他模型支持 2 到 15 秒。
- 在 `seedance-2.5` 上,编辑会保留源视频的时长和宽高比:`duration` 和 `aspect_ratio` 会被忽略,价格按视频时长计算。
更多视频模型
Mage 上的其他视频生成 API
Wan 3.0 API
Wan 3.0,内容过滤严格
Wan Video v2.2 API
开放权重视频模型,含 Lightning 版本
Berry API
忠实还原你的参考内容的视频
Blueberry API
锁定首帧和尾帧
Cherry API
我们的旗舰视频系列
Grok Video API
动起来的 Grok Imagine
常见问题
常见问题解答
Seedance API 的费用是多少?
Seedance API 的端点是什么?
可以调用哪些 Seedance 模型?
Seedance 支持参考图片或角色吗?
可以在 Claude 或 ChatGPT 中使用 Seedance 吗?
Seedance 的生成结果会保存多久?
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。