开发者指南更新于 2026 年 8 月 22 日

Seedance 2.5 API:生产环境选择 Kie 还是 fal?

两家供应商都提供 Seedance 2.5,但参数结构、模型路由和计费方式不同。选择应用能安全运营的契约,并通过自己的供应商适配层隔离差异。

需要统一 Seedance 结构和广泛参考字段时优先 Kie;重视明确的文生、图生、参考端点与队列 SDK 时优先 fal。若可用性重要,可在服务器适配层保留两者,但必须避免未知状态下重复提交。

暖色轮廓光下,潮湿黑色石面上的拉丝铝制音箱
产品光线视觉研究

本站原创运动研究 · 6 秒循环 · 非模型输出

Kie 模型

bytedance/seedance-2-5

已核验参数页使用的统一模型标识。

fal 路由

三个明确端点

文生、图生与参考生成。

任务模式

异步队列

创建、保存任务 ID、轮询或回调。

密钥原则

仅服务器

绝不在浏览器代码暴露供应商密钥。

01

接入路由

Kie 与 fal 快速对比

维度Kie.aifal
模型路由统一 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。产品只应承诺实际调用路由能接受并返回的分辨率。

02

最小请求

当前 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;
03

统一输入

需要归一化的 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供应商安全预检保持开启,并补充自有政策和审核
04

可靠性

生产接入检查清单

  1. 01

    先创建内部任务

    调用供应商前先预扣积分并持久化自己的任务 ID。

  2. 02

    保存供应商身份

    记录实际供应商、模型 ID 和外部任务 ID,轮询时不能猜路由。

  3. 03

    明确幂等边界

    网络超时后不要自动换供应商,首次请求可能已经运行。

  4. 04

    显式处理失败

    只有确认终态失败才退款,慢队列和临时轮询错误不算失败。

  5. 05

    持久化输出

    供应商结果链接可能过期,应依据用户与供应商条款复制到受控存储。

  6. 06

    观察成本和延迟

    记录分辨率、时长、供应商、重试和终态,避免不必要地记录敏感提示词。

05

硬性要求

API 安全与权利检查

  • Kie 与 fal 密钥只放服务器环境变量,绝不作为公开客户端变量。
  • 扣费前验证 URL、MIME 类型、文件大小、数量、时长和输出白名单。
  • 按账户和内部 end-user ID 限流,而不只按 IP。
  • 要求用户拥有每一份图片、视频、音频和角色参考的使用权。
  • 记录商业使用判断所依据的供应商条款版本。
  • 在供应商安全过滤之外建设自己的审核与申诉流程。
FAQ

常见问题

是否有字节跳动官方公开 Seedance 2.5 API?+

官方接入与地区可用性可能不同于第三方。本指南针对当前 Kie 与 fal 路由;把任何路由称为官方前,应单独核对字节跳动或 BytePlus 文档。

哪家 Seedance 2.5 API 更便宜?+

没有稳定统一答案。应按账户中的分辨率、画幅、时长、声音、折扣和失败政策比较;每条获批结果的成本比单次调用标价更有意义。

应该从 Kie 自动故障转移到 fal 吗?+

只有在确认任务未被接收时才可安全切换。超时或未知服务错误后不要重提,否则两家都可能生成并扣费。

能从浏览器直接调用这些 API 吗?+

不要在客户端暴露密钥。浏览器向自有服务器发送经验证请求,服务器创建内部任务后再调用供应商。

已复核资料来源

端点、参数和价格具有时效性。投入生产预算前请核对官方供应商文档与账户后台。本页不宣称 SeedanceAI.dev 对外转售公共 API。

先验证产品工作流

构建自有接入前,先在浏览器中验证提示词、设置和结果处理。

打开生成器