Kie 模型
bytedance/seedance-2-5
已核验参数页使用的统一模型标识。
fal 路由
三个明确端点
文生、图生与参考生成。
任务模式
异步队列
创建、保存任务 ID、轮询或回调。
密钥原则
仅服务器
绝不在浏览器代码暴露供应商密钥。
接入路由
Kie 与 fal 快速对比
| 维度 | Kie.ai | fal |
|---|---|---|
| 模型路由 | 统一 Seedance 2.5 模型与输入对象 | 分别提供文生、图生、参考生成模型 ID |
| 已核验分辨率字段 | 当前表单列出 480p、720p、1080p | 当前模型文档列出 480p、720p |
| 参考输入 | 首尾帧以及图片、视频、音频 URL 数组 | 按端点区分图像与参考参数 |
| 时长 | 数字时长字段,供应商页面宣传最高 30 秒 | 文生路由文档为 auto 或 4–30 秒 |
| 任务处理 | 供应商记录任务状态并支持回调 | 队列 SDK/REST 提供状态;长任务推荐队列 |
| 价格依据 | 以账户价格与计算器为准 | 基于 token 公式,并提供每秒估算 |
| 适合 | 统一的 Seedance 接入面 | 类型明确的端点和 SDK 队列 |
不要泛化供应商宣传
Kie 编辑页宣传 4K,但当前输入表单最高列到 1080p;fal 文档为 480p/720p。产品只应承诺实际调用路由能接受并返回的分辨率。
最小请求
当前 fal 文生视频请求示例
fal 公开了下方模型 ID,并建议长视频使用队列 API。B2B 接入按供应商要求发送稳定且不敏感的 end_user_id,不要直接使用邮箱等个人信息。
服务器端 JavaScript
import { fal } from '@fal-ai/client';
fal.config({ credentials: process.env.FAL_KEY });
const result = await fal.subscribe(
'bytedance/seedance-2.5/text-to-video',
{
input: {
prompt: '一位陶艺师拿起钴蓝色碗,摄影机缓慢推进。',
duration: '10',
resolution: '720p',
aspect_ratio: '16:9',
generate_audio: true,
end_user_id: internalHashedUserId
},
logs: true
}
);
const videoUrl = result.data.video.url;统一输入
需要归一化的 Kie 输入字段
Kie 的已核验表单使用统一输入对象。应用可把文本、图片和参考模式映射到该对象,未使用的数组应省略,不发送空值或互相冲突的字段。
| 字段 | 用途 | 验证 |
|---|---|---|
| prompt | 镜头描述和时间指令 | 即便供应商行为不同,产品层也应要求 |
| first_frame_url / last_frame_url | 开场与可选结尾构图 | HTTPS 地址、支持的图片类型与大小 |
| reference_image_urls | 角色、产品或风格参考 | 供应商页面当前显示最多 30 个 |
| reference_video_urls | 动作或场景参考 | 当前显示最多 10 个,同时验证总时长 |
| reference_audio_urls | 声音参考 | 当前显示最多 10 个,并验证类型、大小和权利 |
| resolution / duration / aspect_ratio | 输出与成本控制 | 服务器端白名单,不信任浏览器输入 |
| nsfw_checker | 供应商安全预检 | 保持开启,并补充自有政策和审核 |
可靠性
生产接入检查清单
- 01
先创建内部任务
调用供应商前先预扣积分并持久化自己的任务 ID。
- 02
保存供应商身份
记录实际供应商、模型 ID 和外部任务 ID,轮询时不能猜路由。
- 03
明确幂等边界
网络超时后不要自动换供应商,首次请求可能已经运行。
- 04
显式处理失败
只有确认终态失败才退款,慢队列和临时轮询错误不算失败。
- 05
持久化输出
供应商结果链接可能过期,应依据用户与供应商条款复制到受控存储。
- 06
观察成本和延迟
记录分辨率、时长、供应商、重试和终态,避免不必要地记录敏感提示词。
硬性要求
API 安全与权利检查
- Kie 与 fal 密钥只放服务器环境变量,绝不作为公开客户端变量。
- 扣费前验证 URL、MIME 类型、文件大小、数量、时长和输出白名单。
- 按账户和内部 end-user ID 限流,而不只按 IP。
- 要求用户拥有每一份图片、视频、音频和角色参考的使用权。
- 记录商业使用判断所依据的供应商条款版本。
- 在供应商安全过滤之外建设自己的审核与申诉流程。
常见问题
是否有字节跳动官方公开 Seedance 2.5 API?+
官方接入与地区可用性可能不同于第三方。本指南针对当前 Kie 与 fal 路由;把任何路由称为官方前,应单独核对字节跳动或 BytePlus 文档。
哪家 Seedance 2.5 API 更便宜?+
没有稳定统一答案。应按账户中的分辨率、画幅、时长、声音、折扣和失败政策比较;每条获批结果的成本比单次调用标价更有意义。
应该从 Kie 自动故障转移到 fal 吗?+
只有在确认任务未被接收时才可安全切换。超时或未知服务错误后不要重提,否则两家都可能生成并扣费。
能从浏览器直接调用这些 API 吗?+
不要在客户端暴露密钥。浏览器向自有服务器发送经验证请求,服务器创建内部任务后再调用供应商。
已复核资料来源
- Kie.ai — Seedance 2.5 API 表单与参数
- fal — Seedance 2.5 文生视频 API、参数与价格
- fal — Seedance 2.5 图生视频 API
- fal — Seedance 2.5 参考视频 API
端点、参数和价格具有时效性。投入生产预算前请核对官方供应商文档与账户后台。本页不宣称 SeedanceAI.dev 对外转售公共 API。
先验证产品工作流
构建自有接入前,先在浏览器中验证提示词、设置和结果处理。

