跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。

模型

  • seedance-2-mini - 快速的 Seedance 2 Mini 视频生成

功能

  • 文生视频:直接根据提示词文本生成视频
  • 首尾帧控制:最多使用 2 张图片作为首帧和尾帧
  • 参考生视频:使用参考图片、视频和音频引导生成
  • 可选音频:请求在生成视频的同时生成音频

注意事项

  • prompt 为必填。
  • duration 支持 4 到 15 的整数值。
  • resolution 支持 480p 和 720p。
  • aspect_ratio 为可选。支持的值为 auto、21:9、16:9、4:3、1:1、3:4、9:16。
  • image_urls 与任何 reference_*_urls 字段互斥。
  • reference_image_urls 最多支持 9 张图片。
  • reference_video_urls 最多支持 3 个视频。
  • reference_audio_urls 最多支持 3 个音频文件,且需要至少一张参考图片或一个参考视频。
  • 图片、视频和音频参考的文件总数不得超过 12 个。
  • 所有远程 URL 都应可公开访问并可直接下载。

授权

Authorization
string
header
必填

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

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

在请求头中添加:

请求体

application/json
model
enum<string>
必填

Seedance 2 Mini 模型标识

可用选项:
seedance-2-mini
input
object
必填

生成参数

callback_url
string<uri>

用于接收结果通知的 Webhook 回调 URL。请使用你控制的、可公开访问的接口。

响应

任务提交成功

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
必填