Skip to main content
POST
cURL
必须至少提供一种参考素材;图片、视频和音频的数量上限以 API 参数定义为准。

素材与场景限制

Seedance 2.5 特价版参考素材生视频为满血版本,自带素材库,无面部畸变,真人通过率 100%,长期稳定。特价计费,仅成功任务收费——实时单价以定价页为准。
  • 文本提示词:中文建议不超过 500 字符;英文建议不超过 1000 单词。
  • 图片输入:支持 jpeg、png、webp、bmp、tiff、gif、heic、heif 格式;单张图片小于 30 MB,宽高比范围 (0.4, 2.5),宽高取值范围 (300px, 6000px)。
  • 图片数量:不超过 30 张。
  • 视频输入:单个视频时长 [2, 30] 秒;最多支持 10 条参考视频;全部视频总时长不得超过 30 秒。
  • 音频输入:单段音频时长 [2, 30] 秒;最多支持 10 段参考音频;全部音频总时长不得超过 30 秒。
  • 音频输入限制:音频不可单独输入,必须同时至少提供一张参考图片或一条参考视频。
  • 分辨率:仅支持 720p——不支持 480p、1080p、2K、4K。
  • 单条时长:4–30 秒(默认 4 秒)。
🔸注意🔸:启用带视频输入时,因计费计算公式不同,单价更低:无视频 = 单价 × 输出时长;带视频 = 单价 ×(输入时长 + 输出时长)。

真人素材送审(real_person)

请求携带参考素材时,通过 real_person 布尔字段控制素材是否先经人脸素材送审:
  • real_person: true(默认):素材先经素材服务送审,通过后以 assetId://{assetId} 引用提交任务;送审期间任务等待,审核拒绝时报错。
  • real_person: false:跳过送审,素材 URL 直接透传提交任务。
仅在确认素材不含真人/人脸时才设置为 false 以省去送审等待;含真人素材保持默认 true 即可。

素材库引用

除可公开访问的 URL 外,image_url / image_urlsvideo_urlsaudio_url / audio_urls 字段还支持素材库引用,格式为 assetId://{assetId}。素材 ID 为全平台共享标识:任何账号都可以引用已知的 assetId,不限提交者,与公开 URL 的共享语义一致。仅 ACTIVE 状态的素材可通过校验。素材的提交与状态查询见素材提交素材详情

授权

Authorization
string
header
必填

使用你的 APIPod API Key 作为 Authorization 请求头中的 Bearer token。

请求体

application/json
model
string
必填

APIPod 公开模型 ID。

Allowed value: "seedance-2.5-lite-r2v"
prompt
string
必填

生成或编辑指令,最长 30000 字符。建议提示词不超过 500 个汉字或 1000 个英文单词;过长的文本会导致信息分散,模型可能忽略细节、只关注重点,导致生成的视频缺少元素。

Maximum string length: 30000
image_urls
string[]

参考图 URL。最多支持 30 张;单张图片小于 30 MB。

Maximum array length: 30
video_urls
string[]

参考视频 URL。最多支持 10 个;单个视频时长 2-30 秒,所有视频总时长不超过 30 秒。

Maximum array length: 10
audio_urls
string[]

参考音频 URL。最多支持 10 段;单个音频时长 2-30 秒,所有音频总时长不超过 30 秒。注意音频不能单独上传,需至少包含一个参考图或参考视频。

Maximum array length: 10
duration
enum<integer>
默认值:4

视频时长,单位为秒。 最小值:4。 最大值:30。

可用选项:
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
resolution
enum<string>
默认值:720p

输出分辨率档位。

可用选项:
720p
aspect_ratio
enum<string>
默认值:adaptive

输出宽高比。

可用选项:
adaptive,
16:9,
4:3,
1:1,
3:4,
9:16,
21:9
generate_audio
boolean
默认值:true

为视频生成同步音频。

real_person
boolean
默认值:true

素材是否包含真人/人脸。默认 true:素材先经素材服务送审换取 assetId 引用再提交任务;确认素材不含真人时设置 false 跳过送审、直接透传素材 URL。

响应

200 - application/json

任务已受理

Standard response for task submission

code
integer
必填

HTTP 状态码。

data
Task Submit Data · object
必填

响应数据。

message
string
必填

响应消息。