Seedance 2.5
Los modelos de Seedance 2.5 se llaman a través de una API de trabajos asíncrona y unificada. Inicia una tarea con POST /api/generate y luego sondea GET /api/generate/{taskId} hasta que termine. Esta familia expone 10 endpoints.
Resumen
Todos los endpoints comparten la misma envoltura — solo cambian model y los campos input. Ejecuta cualquiera desde el playground del Mercado de modelos.
Three mutually exclusive modes — match fields to the model slug:
- image-to-video:
first_frame_urlonly;aspect_ratiomust beadaptive; setfirst_frame_portrait_kind: skipfor scenes. - first-last-frame:
first_frame_url+last_frame_url; also requiresadaptive. - omni-reference:
reference_image_urlsplus optional video/audio; mark portraitsvirtual/real, backgroundsskip; fixed ratios like16:9work.
On direct routes, only portraits are ingested to the portrait library; scenes, video, and audio stay as direct URLs. Copy the full API doc from the model API tab.
reference_image_urls with reference_portrait_kinds per slot:virtual (portrait library — real or AI; real is equivalent), skip (background/scene — default when omitted). Single-frame and first/last-frame models use first_frame_url / last_frame_url (ingested by default); set first_frame_portrait_kind to skip to keep a direct URL.Límites de medios de referencia de Seedance 2
Imágenes de referencia
- Formatos
- JPEG, PNG, WEBP, BMP, TIFF, GIF
- Ancho / alto
- 300-6000 px
- Relación de aspecto
- 0.4-2.5
- Tamaño por archivo
- < 30 MB
Vídeos de referencia
- Formatos
- MP4, MOV
- Resoluciones
- 480p, 720p
- Duración por archivo
- 2-15 s
- Cantidad / duración total
- Hasta 3 / máximo 15 s en total
- Ancho / alto
- 300-6000 px
- Píxeles totales
- 409600-927408
- Relación de aspecto
- 0.4-2.5
- Tamaño por archivo
- <= 50 MB
- Fotogramas
- 24-60 FPS
Audio de referencia
- Formatos
- WAV, MP3
- Duración por archivo
- 2-15 s
- Cantidad / duración total
- Hasta 3 / máximo 15 s en total
- Tamaño por archivo
- <= 15 MB
- Muestreo / canales
- No publicado
- Códec de audio
- No publicado
Vídeo de salida
- resolution
- 480p, 720p, 1080p, 4k
- aspect_ratio
- 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
- Dimensiones exactas
- No publicado; no se garantiza un ancho y alto fijos
Autenticación
Crea una API key en /api-keys y luego envíala como token Bearer. Las solicitudes desde el navegador con sesión iniciada también funcionan mediante la cookie de sesión.
Authorization: Bearer <YOUR_API_KEY>Crear tarea
POST https://api.lithovas.com/api/generateCuerpo: { "model": "<slug>", "input": { … } }
Respuesta: { "taskId": "<id>", "state": "waiting" }
Consultar resultado
GET https://api.lithovas.com/api/generate/<taskId>Respuesta: { "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }
state sea success o fail. Las tareas fallidas no se facturan.Endpoints
| Modelo | Tarea | 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_urlstringopcionalFirst-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstringopcionalLast-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>opcionalPortrait-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>opcionalPortrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstringobligatorioText prompt describing the video to generate (max 30000 characters).
reference_image_urlsarray<string>opcionalReference image URLs (max 30). Mutually exclusive with first/last frame fields.
reference_video_urlsarray<string>opcionalReference video URLs (max 10; total duration ≤30s).
reference_audio_urlsarray<string>opcionalReference audio URLs (max 10; total duration ≤30s).
generate_audiobooleanopcionalGenerate synchronized audio with the video.
return_last_framebooleanopcionalReturn the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>opcionalOutput video resolution.
aspect_ratioenum<string>opcionalOutput aspect ratio.
durationintegeropcionalVideo duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>opcionalVideo output format.
web_searchbooleanopcionalEnable online search for the generation.
nsfw_checkerbooleanopcionalEnable 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_urlstringopcionalFirst-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstringopcionalLast-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>opcionalPortrait-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>opcionalPortrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstringobligatorioText prompt describing the video to generate (max 30000 characters).
reference_image_urlsarray<string>opcionalReference image URLs (max 30). Mutually exclusive with first/last frame fields.
reference_video_urlsarray<string>opcionalReference video URLs (max 10; total duration ≤30s).
reference_audio_urlsarray<string>opcionalReference audio URLs (max 10; total duration ≤30s).
generate_audiobooleanopcionalGenerate synchronized audio with the video.
return_last_framebooleanopcionalReturn the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>opcionalOutput video resolution.
aspect_ratioenum<string>opcionalOutput aspect ratio.
durationintegeropcionalVideo duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>opcionalVideo output format.
web_searchbooleanopcionalEnable online search for the generation.
nsfw_checkerbooleanopcionalEnable 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_urlstringobligatorioURL of the input image to animate, or asset://{assetId} after portrait ingest.
first_frame_portrait_kindenum<string>opcionalPortrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstringobligatorioText prompt describing the video motion and style.
generate_audiobooleanopcionalGenerate synchronized audio with the video.
return_last_framebooleanopcionalReturn the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>opcionalOutput video resolution.
aspect_ratioenum<string>opcionalMust be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationintegeropcionalVideo duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>opcionalVideo output format.
web_searchbooleanopcionalEnable online search for the generation.
nsfw_checkerbooleanopcionalEnable 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_urlstringobligatorioURL of the input image to animate, or asset://{assetId} after portrait ingest.
first_frame_portrait_kindenum<string>opcionalPortrait-library route: ingest hint for first_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstringobligatorioText prompt describing the video motion and style.
generate_audiobooleanopcionalGenerate synchronized audio with the video.
return_last_framebooleanopcionalReturn the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>opcionalOutput video resolution.
aspect_ratioenum<string>opcionalMust be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationintegeropcionalVideo duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>opcionalVideo output format.
web_searchbooleanopcionalEnable online search for the generation.
nsfw_checkerbooleanopcionalEnable 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_urlstringobligatorioFirst-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstringobligatorioLast-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>opcionalPortrait-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>opcionalPortrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstringobligatorioText prompt describing the transition and motion.
generate_audiobooleanopcionalGenerate synchronized audio with the video.
return_last_framebooleanopcionalReturn the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>opcionalOutput video resolution.
aspect_ratioenum<string>opcionalMust be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationintegeropcionalVideo duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>opcionalVideo output format.
web_searchbooleanopcionalEnable online search for the generation.
nsfw_checkerbooleanopcionalEnable 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_urlstringobligatorioFirst-frame image URL or asset://{assetId}. Mutually exclusive with reference_* fields.
last_frame_urlstringobligatorioLast-frame image URL or asset://{assetId}. Requires first_frame_url.
first_frame_portrait_kindenum<string>opcionalPortrait-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>opcionalPortrait-library route: ingest hint for last_frame_url. Default skip (direct URL). Use virtual/real to upload portraits to the asset library.
promptstringobligatorioText prompt describing the transition and motion.
generate_audiobooleanopcionalGenerate synchronized audio with the video.
return_last_framebooleanopcionalReturn the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>opcionalOutput video resolution.
aspect_ratioenum<string>opcionalMust be adaptive — the direct route follows the input image aspect ratio for keyframe-driven tasks.
durationintegeropcionalVideo duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>opcionalVideo output format.
web_searchbooleanopcionalEnable online search for the generation.
nsfw_checkerbooleanopcionalEnable 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-referencepromptstringobligatorioPrompt describing the target video, style, dynamics, and atmosphere.
reference_image_urlsarray<string>opcionalReference image URLs (max 30). Scene/background images stay as URLs unless marked for portrait ingest.
reference_portrait_kindsarray<string>opcionalPer-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>opcionalStructured reference images: [{ url, portrait: "virtual"|"real"|"skip" }]. Alternative to reference_image_urls + reference_portrait_kinds.
virtual_portraitsarray<string>opcionalPortrait URLs always uploaded to the virtual portrait library before generation.
real_portraitsarray<string>opcionalPortrait URLs (including real-person photos) uploaded to the virtual portrait library before generation.
reference_video_urlsarray<string>opcionalReference video URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
reference_audio_urlsarray<string>opcionalReference audio URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
generate_audiobooleanopcionalGenerate synchronized audio with the video.
return_last_framebooleanopcionalReturn the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>opcionalOutput video resolution.
aspect_ratioenum<string>opcionalOutput aspect ratio.
durationintegeropcionalVideo duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>opcionalVideo output format.
web_searchbooleanopcionalEnable online search for the generation.
nsfw_checkerbooleanopcionalEnable 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-480ppromptstringobligatorioPrompt describing the target video, style, dynamics, and atmosphere.
reference_image_urlsarray<string>opcionalReference image URLs (max 30). Scene/background images stay as URLs unless marked for portrait ingest.
reference_portrait_kindsarray<string>opcionalPer-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>opcionalStructured reference images: [{ url, portrait: "virtual"|"real"|"skip" }]. Alternative to reference_image_urls + reference_portrait_kinds.
virtual_portraitsarray<string>opcionalPortrait URLs always uploaded to the virtual portrait library before generation.
real_portraitsarray<string>opcionalPortrait URLs (including real-person photos) uploaded to the virtual portrait library before generation.
reference_video_urlsarray<string>opcionalReference video URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
reference_audio_urlsarray<string>opcionalReference audio URLs (max 10; total duration ≤30s). Never uploaded to the asset library.
generate_audiobooleanopcionalGenerate synchronized audio with the video.
return_last_framebooleanopcionalReturn the generated video's last frame. Cannot be true when draft=true.
resolutionenum<string>opcionalOutput video resolution.
aspect_ratioenum<string>opcionalOutput aspect ratio.
durationintegeropcionalVideo duration from 4 to 30 seconds, or -1 for automatic selection.
output_formatenum<string>opcionalVideo output format.
web_searchbooleanopcionalEnable online search for the generation.
nsfw_checkerbooleanopcionalEnable 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-videopromptstringobligatorioText prompt describing the video motion and style. Spicy mode favors bolder, higher-contrast results.
durationintegeropcionalVideo length in seconds (4-16).
resolutionenum<string>opcionalOutput video resolution.
aspect_ratioenum<string>opcionalOutput video aspect ratio.
camera_fixedbooleanopcionalWhether to keep the camera fixed.
generate_audiobooleanopcionalWhether 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-videopromptstringobligatorioText prompt describing the video motion and style. Spicy mode favors bolder, higher-contrast results.
image_urlstringobligatorioURL of the input image to animate.
last_imagestringopcionalOptional closing image. Together with image_url, this selects strict first/last-frame keyframe generation.
durationintegeropcionalNormal mode: 4-16 seconds. Two-image keyframe mode: 4-30 seconds.
resolutionenum<string>opcionalNormal mode supports its listed tiers. Two-image keyframe mode supports 480p, 720p, or 1080p.
aspect_ratioenum<string>opcionalNormal mode uses a selected ratio. Two-image keyframe mode requires adaptive and follows the opening image ratio.
camera_fixedbooleanopcionalWhether to keep the camera fixed.
generate_audiobooleanopcionalWhether to generate synchronized audio.
watermarkbooleanopcionalFor 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"
}
}'