curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic drone shot flying over a neon city after rain, reflections shimmering on the streets",
"aspect_ratio": "16:9",
"resolution": "4k",
"duration": 5,
"generate_audio": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-04-04T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Seedance
Seedance 2
Seedance 2 API 可根据文本、最多两帧图片，或图片、视频和音频参考生成 4–15 秒的视频。更快的变体仅支持 480p 和 720p。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic drone shot flying over a neon city after rain, reflections shimmering on the streets",
"aspect_ratio": "16:9",
"resolution": "4k",
"duration": 5,
"generate_audio": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-04-04T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- seedance-2 - 标准 Seedance 2 视频生成模型
- seedance-2-fast - 更快、成本更低的 Seedance 2 变体
功能
- 文生视频：直接根据提示词文本生成视频
- 首尾帧控制：最多使用 2 张图片作为首帧和尾帧
- 多模态参考：使用参考图片、视频和音频引导生成
- 可选音频：请求在生成视频的同时生成音频
注意事项
-
seedance-2是默认的标准质量变体 -
seedance-2支持480p、720p、1080p和4k -
seedance-2-fast使用相同的输入结构，但针对更低延迟进行了优化，仅支持480p和720p -
prompt长度必须在 3 到 20,000 个字符之间。 -
image_urls用于图生视频模式，最多仅支持 2 张图片： 索引0对应起始帧，索引1对应可选的结束帧。 -
image_urls支持 JPG、JPEG、PNG、WebP、GIF 和 AVIF 图片。每张图片应可公开访问，且不超过 30 MB。 -
image_urls与任何reference_*_urls字段互斥，不能在同一请求中同时使用。 -
reference_image_urls用于参考生视频模式，最多支持 9 张图片。支持的格式为 JPG、JPEG、PNG 和 WebP，每张图片不超过 30 MB。 -
reference_video_urls最多支持 3 个 MP4 或 MOV 文件。参考视频总时长应为 2 到 15 秒，视频总大小应小于 50 MB，每个视频应为 480p 到 720p。 -
reference_audio_urls最多支持 3 个 MP3 或 WAV 文件。参考音频总时长不应超过 15 秒，每个音频文件不超过 15 MB。音频参考需要至少一张参考图片或一个参考视频。 -
参考生视频模式下，
reference_image_urls、reference_video_urls和reference_audio_urls中的文件总数不得超过 12 个。 -
可在提示词中按顺序引用参考素材，例如
@Image1、@Video1和@Audio1。 -
aspect_ratio为可选。提供时，支持的值为auto、21:9、16:9、4:3、1:1、3:4、9:16。 -
duration支持4到15的整数值。 -
resolution中的1080p和4k仅seedance-2支持。seedance-2-fast仍仅限480p和720p。 - 所有远程 URL 都应可公开访问并可直接下载。
授权
所有 API 接口都需要 Bearer Token 认证。
创建 API Key：登录 PoYo，进入 仪表盘 → API 密钥（poyo.ai/zh/dashboard/api-key），点击创建 Key。
在请求头中添加：
Authorization: Bearer YOUR_API_KEY
请求体
application/json
响应
任务提交成功
Show child attributes
Show child attributes