Seedance 2.5
Seedance 2.5 模型通过一个统一的异步任务 API 调用。用 POST /api/generate 发起任务,再轮询 GET /api/generate/{taskId} 直到完成。本系列提供 10 个端点。
概览
每个端点共享相同的外层结构 —— 只有 model 和 input 字段不同。可在模型市场的 playground 中运行任意一个。
三种模式互斥,请按模型 slug 选择对应字段:
- image-to-video:仅
first_frame_url,aspect_ratio必须adaptive;场景图设first_frame_portrait_kind: skip。 - first-last-frame:
first_frame_url+last_frame_url,同样必须adaptive。 - omni-reference:
reference_image_urls+ 可选视频/音频;人像标virtual/real,背景标skip;可用固定画幅如16:9。
直连路由:只有人像需先上传到人像库;场景、视频、音频保持公网 URL 直传。API 标签可一键复制完整说明。
reference_image_urls 旁用 reference_portrait_kinds 逐张标记:virtual(人像入库,含真人/AI;real 等效)、skip(背景/场景,不入库;未标记时默认 skip)。 单图/首尾帧模型用 first_frame_url / last_frame_url,默认会入库;也可设 first_frame_portrait_kind 为 skip 保持直链。Seedance 2 参考媒体限制
参考图片
- 支持格式
- JPEG, PNG, WEBP, BMP, TIFF, GIF
- 宽度 / 高度
- 300-6000 px
- 宽高比
- 0.4-2.5
- 单个文件
- < 30 MB
参考视频
- 支持格式
- MP4, MOV
- 分辨率档位
- 480p, 720p
- 单个时长
- 2-15 s
- 数量 / 总时长
- 最多 3 个 / 总时长不超过 15 秒
- 宽度 / 高度
- 300-6000 px
- 总像素
- 409600-927408
- 宽高比
- 0.4-2.5
- 单个文件
- <= 50 MB
- 帧率
- 24-60 FPS
参考音频
- 支持格式
- WAV, MP3
- 单个时长
- 2-15 s
- 数量 / 总时长
- 最多 3 个 / 总时长不超过 15 秒
- 单个文件
- <= 15 MB
- 采样率 / 声道
- 尚未公开
- 音频编码 Codec
- 尚未公开
输出视频
- resolution
- 480p, 720p, 1080p, 4k
- aspect_ratio
- 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
- 精确像素尺寸
- 尚未公开,不保证固定为某一组宽高
认证
在 /api-keys 创建 API 密钥,然后作为 Bearer token 发送。已登录时从浏览器发起的请求也可通过会话 cookie 生效。
Authorization: Bearer <YOUR_API_KEY>创建任务
POST https://api.lithovas.com/api/generate请求体:{ "model": "<slug>", "input": { … } }
响应:{ "taskId": "<id>", "state": "waiting" }
查询结果
GET https://api.lithovas.com/api/generate/<taskId>响应:{ "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }
state 变为 success 或 fail。失败任务不计费。端点
| 模型 | 任务 | model slug |
|---|---|---|
| Seedance 2.5 | Text to Video | seedance-2.5-text-to-video |
| Seedance 2.5 Text to Video | Text to Video | seedance-2.5-text-to-video-480p |
| Seedance 2.5 Image to Video | Image to Video | seedance-2.5-image-to-video |
| Seedance 2.5 Image to Video | Image to Video | seedance-2.5-image-to-video-480p |
| Seedance 2.5 First & Last Frame | Image to Video | seedance-2.5-first-last-frame |
| Seedance 2.5 First & Last Frame | Image to Video | seedance-2.5-first-last-frame-480p |
| Seedance 2.5 Omni Reference | Image to Video | seedance-2.5-omni-reference |
| Seedance 2.5 Omni Reference | Image to Video | seedance-2.5-omni-reference-480p |
| Seedance 2.5 Spicy Text to Video | Text to Video | seedance-2.5-spicy-text-to-video |
| Seedance 2.5 Spicy Image to Video | Image to Video | seedance-2.5-spicy-image-to-video |
Seedance 2.5 · Text to Video
seedance-2.5-text-to-videofirst_frame_urlstring可选First-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstring可选Last-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>可选Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
last_frame_portrait_kindenum<string>可选Portrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必填Text prompt describing the video to generate (max 30000 characters).
reference_image_urlsarray<string>可选Reference image URLs (max 30). Mutually exclusive with first/last frame fields.
reference_video_urlsarray<string>可选Reference video URLs (max 10; total duration ≤30s).
reference_audio_urlsarray<string>可选Reference audio URLs (max 10; total duration ≤30s).
generate_audioboolean可选Generate synchronized audio with the video.
return_last_frameboolean可选Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>可选Output video resolution.
aspect_ratioenum<string>可选Output aspect ratio.
durationinteger可选Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>可选Video output format.
web_searchboolean可选Enable online search for the generation.
nsfw_checkerboolean可选Enable content safety checking.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-text-to-video",
"input": {
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞"
}
}'Seedance 2.5 Text to Video · Text to Video
seedance-2.5-text-to-videofirst_frame_urlstring可选First-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstring可选Last-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>可选Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
last_frame_portrait_kindenum<string>可选Portrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必填Text prompt describing the video to generate (max 30000 characters).
reference_image_urlsarray<string>可选Reference image URLs (max 30). Mutually exclusive with first/last frame fields.
reference_video_urlsarray<string>可选Reference video URLs (max 10; total duration ≤30s).
reference_audio_urlsarray<string>可选Reference audio URLs (max 10; total duration ≤30s).
generate_audioboolean可选Generate synchronized audio with the video.
return_last_frameboolean可选Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>可选Output video resolution.
aspect_ratioenum<string>可选Output aspect ratio.
durationinteger可选Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>可选Video output format.
web_searchboolean可选Enable online search for the generation.
nsfw_checkerboolean可选Enable content safety checking.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-text-to-video",
"input": {
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "480p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞"
}
}'Seedance 2.5 Image to Video · Image to Video
seedance-2.5-image-to-videofirst_frame_urlstring必填URL of the input image to animate, or asset://{assetId} after portrait ingest.
first_frame_portrait_kindenum<string>可选Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必填Text prompt describing the video motion and style.
generate_audioboolean可选Generate synchronized audio with the video.
return_last_frameboolean可选Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>可选Output video resolution.
aspect_ratioenum<string>可选Must be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationinteger可选Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>可选Video output format.
web_searchboolean可选Enable online search for the generation.
nsfw_checkerboolean可选Enable content safety checking.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-image-to-video",
"input": {
"aspect_ratio": "adaptive",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞",
"first_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"first_frame_portrait_kind": "virtual"
}
}'Seedance 2.5 Image to Video · Image to Video
seedance-2.5-image-to-video-480pfirst_frame_urlstring必填URL of the input image to animate, or asset://{assetId} after portrait ingest.
first_frame_portrait_kindenum<string>可选Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必填Text prompt describing the video motion and style.
generate_audioboolean可选Generate synchronized audio with the video.
return_last_frameboolean可选Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>可选Output video resolution.
aspect_ratioenum<string>可选Must be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationinteger可选Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>可选Video output format.
web_searchboolean可选Enable online search for the generation.
nsfw_checkerboolean可选Enable content safety checking.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-image-to-video-480p",
"input": {
"aspect_ratio": "adaptive",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "480p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞",
"first_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"first_frame_portrait_kind": "virtual"
}
}'Seedance 2.5 First & Last Frame · Image to Video
seedance-2.5-first-last-framefirst_frame_urlstring必填First-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstring必填Last-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>可选Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
last_frame_portrait_kindenum<string>可选Portrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必填Text prompt describing the transition and motion.
generate_audioboolean可选Generate synchronized audio with the video.
return_last_frameboolean可选Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>可选Output video resolution.
aspect_ratioenum<string>可选Must be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationinteger可选Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>可选Video output format.
web_searchboolean可选Enable online search for the generation.
nsfw_checkerboolean可选Enable content safety checking.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-first-last-frame",
"input": {
"aspect_ratio": "adaptive",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞",
"first_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"first_frame_portrait_kind": "virtual",
"last_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/image/20260819/fb280368-8f54-41eb-aacf-cee1c189b29b.png",
"last_frame_portrait_kind": "skip"
}
}'Seedance 2.5 First & Last Frame · Image to Video
seedance-2.5-first-last-frame-480pfirst_frame_urlstring必填First-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstring必填Last-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>可选Portrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
last_frame_portrait_kindenum<string>可选Portrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstring必填Text prompt describing the transition and motion.
generate_audioboolean可选Generate synchronized audio with the video.
return_last_frameboolean可选Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>可选Output video resolution.
aspect_ratioenum<string>可选Must be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationinteger可选Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>可选Video output format.
web_searchboolean可选Enable online search for the generation.
nsfw_checkerboolean可选Enable content safety checking.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-first-last-frame-480p",
"input": {
"aspect_ratio": "adaptive",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "480p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞",
"first_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"first_frame_portrait_kind": "virtual",
"last_frame_url": "https://frw-images.aiaipic.win/users/3514640099037941760/image/20260819/fb280368-8f54-41eb-aacf-cee1c189b29b.png",
"last_frame_portrait_kind": "skip"
}
}'Seedance 2.5 Omni Reference · Image to Video
seedance-2.5-omni-referencepromptstring必填Prompt describing the target video, style, dynamics, and atmosphere.
reference_image_urlsarray<string>可选Reference image URLs (max 30). Scene/background images stay as URLs unless marked for portrait ingest.
reference_portrait_kindsarray<string>可选Per-image ingest hint aligned with reference_image_urls: virtual (portrait library — AI or real person), real (optional alias, same as virtual), skip (direct URL; default when omitted).
reference_imagesarray<object>可选Structured reference images: [{ url, portrait: "virtual"|"real"|"skip" }]. Alternative to reference_image_urls + reference_portrait_kinds.
virtual_portraitsarray<string>可选Portrait URLs always uploaded to the virtual portrait library before generation.
real_portraitsarray<string>可选Portrait URLs (including real-person photos) uploaded to the virtual portrait library before generation.
reference_video_urlsarray<string>可选Reference video URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
reference_audio_urlsarray<string>可选Reference audio URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
generate_audioboolean可选Generate synchronized audio with the video.
return_last_frameboolean可选Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>可选Output video resolution.
aspect_ratioenum<string>可选Output aspect ratio.
durationinteger可选Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>可选Video output format.
web_searchboolean可选Enable online search for the generation.
nsfw_checkerboolean可选Enable content safety checking.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-omni-reference",
"input": {
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": " @image1与 @image2在 @image3的场景中,参考 @video1的运镜,背景音乐参考 @audio1",
"reference_image_urls": [
"https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"https://frw-images.aiaipic.win/users/3514640099037941760/image/20260819/fb280368-8f54-41eb-aacf-cee1c189b29b.png"
],
"reference_portrait_kinds": [
"virtual",
"virtual",
"skip"
],
"reference_video_urls": [
"https://frw-images.aiaipic.win/users/3492453287637028864/video/20260818/3524765235086888960.mp4"
],
"reference_audio_urls": [
"https://frw-images.aiaipic.win/users/3492453287637028864/audio/20260818/3524725649950380032.mp3"
]
}
}'Seedance 2.5 Omni Reference · Image to Video
seedance-2.5-omni-reference-480ppromptstring必填Prompt describing the target video, style, dynamics, and atmosphere.
reference_image_urlsarray<string>可选Reference image URLs (max 30). Scene/background images stay as URLs unless marked for portrait ingest.
reference_portrait_kindsarray<string>可选Per-image ingest hint aligned with reference_image_urls: virtual (portrait library — AI or real person), real (optional alias, same as virtual), skip (direct URL; default when omitted).
reference_imagesarray<object>可选Structured reference images: [{ url, portrait: "virtual"|"real"|"skip" }]. Alternative to reference_image_urls + reference_portrait_kinds.
virtual_portraitsarray<string>可选Portrait URLs always uploaded to the virtual portrait library before generation.
real_portraitsarray<string>可选Portrait URLs (including real-person photos) uploaded to the virtual portrait library before generation.
reference_video_urlsarray<string>可选Reference video URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
reference_audio_urlsarray<string>可选Reference audio URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
generate_audioboolean可选Generate synchronized audio with the video.
return_last_frameboolean可选Return the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>可选Output video resolution.
aspect_ratioenum<string>可选Output aspect ratio.
durationinteger可选Video duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>可选Video output format.
web_searchboolean可选Enable online search for the generation.
nsfw_checkerboolean可选Enable content safety checking.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-omni-reference-480p",
"input": {
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "480p",
"return_last_frame": false,
"web_search": false,
"prompt": " @image1与 @image2在 @image3的场景中,参考 @video1的运镜,背景音乐参考 @audio1",
"reference_image_urls": [
"https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"https://frw-images.aiaipic.win/users/3514640099037941760/image/20260819/fb280368-8f54-41eb-aacf-cee1c189b29b.png"
],
"reference_portrait_kinds": [
"virtual",
"virtual",
"skip"
],
"reference_video_urls": [
"https://frw-images.aiaipic.win/users/3492453287637028864/video/20260818/3524765235086888960.mp4"
],
"reference_audio_urls": [
"https://frw-images.aiaipic.win/users/3492453287637028864/audio/20260818/3524725649950380032.mp3"
]
}
}'Seedance 2.5 Spicy Text to Video · Text to Video
seedance-2.5-spicy-text-to-videopromptstring必填Text prompt describing the video motion and style. Spicy mode favors bolder, higher-contrast results.
durationinteger可选Video length in seconds (4-16).
resolutionenum<string>可选Output video resolution.
aspect_ratioenum<string>可选Output video aspect ratio.
camera_fixedboolean可选Whether to keep the camera fixed.
generate_audioboolean可选Whether to generate synchronized audio.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-spicy-text-to-video",
"input": {
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞"
}
}'Seedance 2.5 Spicy Image to Video · Image to Video
seedance-2.5-spicy-image-to-videopromptstring必填Text prompt describing the video motion and style. Spicy mode favors bolder, higher-contrast results.
image_urlstring必填URL of the input image to animate.
last_imagestring可选Optional closing image. Together with image_url, this selects strict first/last-frame keyframe generation.
durationinteger可选Normal mode: 4-16 seconds. Two-image keyframe mode: 4-30 seconds.
resolutionenum<string>可选Normal mode supports its listed tiers. Two-image keyframe mode supports 480p, 720p, or 1080p.
aspect_ratioenum<string>可选Normal mode uses a selected ratio. Two-image keyframe mode requires adaptive and follows the opening image ratio.
camera_fixedboolean可选Whether to keep the camera fixed.
generate_audioboolean可选Whether to generate synchronized audio.
watermarkboolean可选For two-image keyframe mode, add an AI-generated watermark to the output.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-spicy-image-to-video",
"input": {
"aspect_ratio": "adaptive",
"duration": 5,
"generate_audio": true,
"output_format": "mp4",
"resolution": "720p",
"return_last_frame": false,
"web_search": false,
"prompt": "在房间里跳舞",
"image_url": "https://frw-images.aiaipic.win/users/3514640099037941760/ai_generated/20260818/038f9f68-004f-4017-a09d-74b3da84e569.png",
"first_frame_portrait_kind": "virtual"
}
}'