Video
Seedance 2.5 Flash
根据文本、首尾帧或多模态参考素材生成 480p 或 720p、时长 4–30 秒的视频,或编辑一个源视频。
Seedance 2.5 Flash 支持文生视频、首尾帧生成、参考生成和视频编辑。使用 Default 档位的 dreamina-seedance-2-5-flash。媒体须通过无需凭据的公开 HTTP 或 HTTPS URL 发送。保存返回的任务 ID,并查询该任务以获取完成的视频。
参见 Playground 和实时价格、OpenAPI 规范和定价指南。
快速示例
此请求会创建一个四秒视频。发送前请查看当前价格;提交并成功生成会产生费用。
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "dreamina-seedance-2-5-flash",
"content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
"resolution": "480p",
"duration": 4,
"ratio": "16:9",
"generate_audio": false
}'参数
model 和 content 为必填字段。其他所有字段均为可选。显式 null 值和未知字段会被拒绝。
| 字段 | 类型 | 默认值 | 约束 |
|---|---|---|---|
model | 字符串 | 必填 | dreamina-seedance-2-5-flash |
content | 数组 | 必填 | 至少包含一个非空文本项;媒体项必须指定角色。 |
resolution | 字符串 | 720p | 480p 或 720p。 |
duration | 整数 | 5,编辑时为 -1 | 生成:4–30 秒。编辑:省略或使用 -1;输出时长与源视频一致。 |
ratio | 字符串 | 16:9,首尾帧/编辑时为 adaptive | 文本/参考生成:16:9、9:16、1:1、4:3、3:4、21:9。首尾帧和编辑:仅限 adaptive。 |
generate_audio | 布尔值 | true | 启用或禁用生成音频;不影响费率。 |
omni_reference_task_type | 字符串 | generate | generate 或 edit。编辑必须提供且仅提供一个视频。 |
content_filter | 布尔值 | true | 仅接受 true;Playground 无需提供此控件。 |
文档规定提示词最多为 10,000 tokens。未指定公开的分词器,因此不能将字符数视为准确的 token 数。
内容与模式
文本使用 {"type":"text","text":"Describe the shot"}。图片、视频和音频使用嵌套 URL 和明确指定的角色:
{
"type": "image_url",
"image_url": {"url": "https://example.com/reference.jpg"},
"role": "reference_image"
}| 模式 | 内容 | 画幅与时长 |
|---|---|---|
| 文生视频 | 仅文本 | 固定比例;4–30 秒。 |
| 首尾帧 | 文本加一张 first_frame 图片,可选一张 last_frame 图片 | adaptive;4–30 秒。提供尾帧时必须提供首帧。 |
| 参考生成 | 文本加 reference_image、reference_video 或 reference_audio 项 | 固定比例;4–30 秒。最多 10 张图片、5 个视频和 5 段音频。 |
| 视频编辑 | 文本、恰好一个 reference_video,可选参考图片/音频;任务类型为 edit | adaptive;省略时长或设为 -1。 |
视频项使用 type: "video_url"、video_url: {"url": "..."}、role: "reference_video";音频项以相同结构使用 audio_url 和 reference_audio。首尾帧不能与参考媒体混用。此集成不提供 Draft、Extend、1080p、水印、种子和尾帧输出控件。不提供回调。
媒体约束
| 媒体 | 格式 | 大小与时长 |
|---|---|---|
| 图片 | JPEG, PNG, WebP | 最大 30 MB;每边 300–6,000 px;宽高比 0.4–2.5。 |
| 视频 | MP4, MOV | 最大 200 MB;24–60 FPS;每边 300–6,000 px;比例 0.4–2.5;409,600–8,295,044 像素。参考视频:每个 2–30 秒,总时长最多 30 秒。编辑源视频:4–30 秒。 |
| 音频 | WAV, MP3 | 最大 15 MB;每段 2–30 秒,总时长最多 30 秒。 |
提交前文件必须可读取。视频时长根据媒体实测,以计算费用。请使用稳定的公开 URL。
任务响应与轮询
创建任务会返回 id、model、status 和 created_at。查询同一任务,直到完成:
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"状态为 processing、completed 或 failed。成功时读取 output.video_url,获取已存储的视频。失败时读取 error.code 和 error.message。公开响应不包含费用。轮询超时并不证明生成失败:保留任务 ID 并再次查询,不要另行提交生成。
计费
实时费率取决于分辨率以及是否提供视频。没有视频输入时,计费秒数等于输出时长。有参考视频时,计费秒数等于输出时长,加上输出时长与向上取整后的输入总时长两者中的较大值。编辑按向上取整后的源视频时长的两倍计费。音频已包含在内。失败的请求不收费。
例如,五秒输出搭配三秒参考视频,按十秒计费。编辑一个十秒源视频,按二十秒计费。将计费秒数乘以适用的实时费率。
