跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
Seedance 2.5 Flash 是字节跳动 Seedance 2.5 的 Flash 版本,输出 480p 和 720p。它可以根据文本提示词生成 4–30 秒、带同步音频的视频,也可以让首帧(可加尾帧)动起来,或按图片、视频、音频参考生成视频。模式由传入的素材自动决定。

模型

  • seedance-2.5-flash — 文生视频、首尾帧图生视频、多模态参考生视频,输出 480p 或 720p

功能

  • 4–30 秒视频:duration 可设为 4 到 30 之间的任意整数秒。
  • 同步音频:音频与视频同时生成。将 generate_audio 设为 false 时只生成视频。
  • 首尾帧:可以只给一张首帧,也可以同时给首帧和尾帧来决定镜头的结尾画面。
  • 多模态参考:最多 10 张参考图、5 个参考视频、5 段参考音频,共同引导视频内容。
  • 宽高比:auto、21:9、16:9、4:3、1:1、3:4 或 9:16。

输入模式

image_urls 和参考素材字段请分开在不同请求中使用。图生视频时,aspect_ratio 设为 auto 或不传。

必填参数

  • prompt (string):视频描述。参考素材按上传顺序写作 @Image1、@Video1、@Audio1。
  • duration (integer):输出时长,4 到 30 秒。

可选参数

  • resolution (string):480p 或 720p。默认 720p。
  • aspect_ratio (string):auto、21:9、16:9、4:3、1:1、3:4 或 9:16。默认 auto,由模型自动选择。传 image_urls 时,auto 会沿用首帧的宽高比。
  • generate_audio (boolean):与视频同时生成同步音频。默认 true。
  • image_urls (array of strings):一张首帧,或依次传首帧和尾帧。JPEG、PNG 或 WebP,每张不超过 30 MB。
  • reference_image_urls (array of strings):最多 10 张参考图。JPEG、PNG 或 WebP,每张不超过 30 MB。
  • reference_video_urls (array of strings):最多 5 个参考视频。MP4 或 MOV,每个 2–30 秒、不超过 200 MB。
  • reference_audio_urls (array of strings):最多 5 段参考音频,需与 reference_image_urls 或 reference_video_urls 一起使用。MP3 或 WAV,每段 2–30 秒、不超过 15 MB。

示例

文生视频

首尾帧

参考生视频

注意事项

  • 参考视频合计最长 30 秒,参考音频合计最长 30 秒,两项总时长都在提交任务时校验。
  • 参考素材编号从 1 开始,按对应输入数组的顺序排列。
  • 需要 1080p 输出时,请使用 Seedance 2.5。
  • 所有素材 URL 都必须可通过 HTTP 或 HTTPS 公开访问并可直接下载。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。

在请求头中添加:

请求体

application/json
model
enum<string>
必填

Seedance 2.5 Flash 模型标识

可用选项:
seedance-2.5-flash
input
object
必填
callback_url
string<uri>

接收结果通知的 Webhook 回调 URL

示例:

"https://your-domain.com/callback"

响应

任务提交成功

code
enum<integer>
必填

业务状态码。200 表示成功,其他值都表示请求失败。请务必检查这个字段:部分参数校验错误会以 HTTP 200 返回,响应体里的 code 为 400。

  • 200:成功
  • 400:请求参数无效
  • 401:API Key 缺失或无效
  • 402:积分不足
  • 403:没有权限
  • 404:资源不存在
  • 408:请求超时
  • 429:请求频率超限
  • 500:服务器内部错误
  • 502:上游服务错误
  • 503:服务暂不可用

详见错误码。

可用选项:
200,
400,
401,
402,
403,
404,
408,
429,
500,
502,
503
示例:

200

data
object
必填
message
string
示例:

"success"