Skip to main content
POST
cURL

关键参数与限制

Seedance 2.5 特价版图生视频将首帧图(可选尾帧图)动画化为单条 4–30 秒、音画同步的视频。它与折扣版共享同一套 2.5 契约,区别仅在计费档位与分辨率:特价计费、固定 720p 输出。
  • 图片输入:通过 image_url / image_urls 传入首帧图,可选尾帧图——单次最多 2 张图片。
  • 图片格式:支持 jpeg、png、webp、bmp、tiff、gif、heic、heif 格式;单张图片小于 30 MB,宽高比范围 (0.4, 2.5),宽高取值范围 (300px, 6000px)。
  • 文本提示词:中文建议不超过 500 字符;英文建议不超过 1000 单词。
  • 单条时长:4–30 秒(默认 4 秒)。
  • 分辨率:仅支持 720p——不支持 480p、1080p、2K、4K。
  • 宽高比adaptive(默认)、16:99:161:14:33:421:9
  • 原生音频:默认开启(generate_audio=true),与画面一起生成;不需要时可按请求关闭。
特价计费,仅成功任务收费——实时单价以定价页为准。该系列为满血版:媒体 URL 默认(real_person=true)会先经素材服务送审再提交任务;确认素材不含真人时可设置 real_person=false 跳过送审、直接透传,公网 URL 均可直接使用。

真人素材送审(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-i2v"
prompt
string
必填

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

Maximum string length: 30000
image_urls
string[]

首帧图 URL;第二张作为尾帧约束。支持 1-2 张图片。

Required array length: 1 - 2 elements
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
必填

响应消息。