Guia Seedance 2.5 API

Seedance 2.5 API para generacion rapida de video IA

Esta pagina de Seedance 2.5 API explica como crear un flujo ligero sobre Seedance API v2. Usa el modelo seedance-2.0 para clips compactos, previews, social video y workflows de alto volumen sin infraestructura GPU propia.

Obtener API key Leer docs v2

Duracion: 5-15s
Ruta modelo: v2
Entradas: T2V + I2V
Interfaz: REST

Request 2.5 planning

Empieza con el modelo nativo Seedance 2.0 Mini

seedance-2.0

curl -X POST 'https://seedanceapi.org/v2/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0",
    "prompt": "A cinematic product reveal with smooth dolly-in camera motion",
    "duration": 10,
    "aspect_ratio": "16:9"
  }'

Seedance API v2 expone seedance-2.0 para jobs Mini. Usa duraciones de 4-15 segundos, salida 480p o 720p y prompts enfocados para generacion ligera.

Por que usar un flujo Seedance 2.5 API?

El flujo Seedance 2.5 API sirve cuando el equipo necesita velocidad, costos previsibles e integracion REST simple mas que renders cinematicos largos.

Hecho para previews rapidos

Usa requests estilo Seedance 2.5 API para probar prompts, comparar ideas de movimiento y crear clips compactos antes de renders mayores.

Acceso simple con API key

Los developers autentican con Bearer tokens, crean jobs con POST /v2/generate y consultan GET /v2/status igual que en la API Seedance 2.0 completa.

Limites aptos para produccion

Duracion corta, aspect ratios claros y polling async facilitan encajar Seedance 2.5 API en colas de producto y moderacion.

Capacidades Seedance 2.5 API

El flujo 2.5 API se centra en las funciones de Seedance 2.0 API que importan para apps de video ligeras y previews automaticos.

Modelo Mini nativo

Define model como seedance-2.0 cuando quieras comportamiento Seedance 2.5 API para iteracion rapida y jobs pequenos.

Clips text-to-video

Envia un prompt conciso, aspect ratio, resolution y duration para generar assets cortos para apps, social media y pruebas creativas.

Movimiento image-to-video

Proporciona una a cuatro image URLs, o reference video URLs compatibles con Mini, manteniendo un payload Seedance 2.5 API compacto.

Duraciones cortas

Usa cualquier duracion entera de 4 a 15 segundos; 8 segundos es un inicio practico para previews 2.5 API.

Polling async de estado

Cada request devuelve task id, para que tu app consulte estado, actualice UI y obtenga la URL final.

Base v2 compartida

El flujo Seedance 2.5 API usa la misma authentication, billing y response shape v2 que la API Seedance 2.0 amplia.

Como usar Seedance 2.5 API

Empieza con los endpoints Seedance API v2 existentes y ajusta el request para output compacto.

Crea una API key

Inicia sesion, abre API Keys y copia una key para uso server-side. No pongas la key en browser code ni repos publicos.

Envia un job Mini

Llama POST /v2/generate con model seedance-2.0, prompt enfocado, duration 8, resolution 720p y el aspect ratio necesario.

Consulta y renderiza

Usa GET /v2/status con task_id. Cuando status sea SUCCESS, lee data.response[0] y muestra o guarda la URL del video.

Patron de request Seedance 2.5 API

El flujo 2.5 API se mantiene pequeno: autenticar, crear una tarea y consultar hasta completar.

POST /v2/generate

Crea una tarea Seedance 2.0 Mini. Usa text prompts para text-to-video, images para image-to-video o reference_video_urls para video input.

GET /v2/status

Devuelve estado de procesamiento, detalles de fallo o response final con la URL del video generado.

Callback URL opcional

Para sistemas async, incluye callback_url publico si la integracion lo soporta. No uses localhost URLs.

Parametros recomendados 2.5 API

Parametro	Valor recomendado
model	Usa seedance-2.0 para el flujo 2.5 API.
prompt	Mantenlo enfocado y especifico; maximo 2000 caracteres.
duration	Usa cualquier entero de 4 a 15 segundos.
resolution	Usa 480p o 720p para output Mini.
aspect_ratio	Usa 16:9, 9:16, 4:3, 3:4, 1:1, 21:9 o adaptive para text-to-video.
images	Usa una a cuatro image URLs HTTPS para image-to-video.
reference_video_urls	Reference video URLs opcionales compatibles con Mini para generacion guiada por video.
reference_audio_urls	Reference audio URLs opcionales para generacion compatible con Mini.
callback_url	Webhook URL publico opcional para notificaciones async.

Para la referencia completa, usa la documentacion Seedance 2.0 API v2. Esta pagina reduce la misma API a una implementacion 2.5 planning.

Mejores casos de uso Seedance 2.5 API

Los workflows 2.5 API son ideales cuando se necesitan previews de movimiento rapidos o video generado ligero dentro de un producto existente.

Social video previews

Genera clips verticales compactos para feed previews, ideas de anuncios y herramientas de creadores.

Pruebas de movimiento de producto

Anima product shots o visuales de campana con requests image-to-video cortos antes de aprobar el creativo final.

Herramientas de prompt iteration

Permite probar muchas variantes de prompt, comparar resultados y promover el mejor prompt a un render mayor.

Automatizacion de alto volumen

Usa short fast jobs para batch previews, content pipelines y apps que necesitan throughput previsible.

Notas de integracion en produccion

Un flujo Seedance 2.5 API necesita el mismo cuidado operativo que cualquier integracion video API en produccion.

Ejecuta llamadas desde backend

Guarda API keys en tu servidor, llama Seedance API desde backend y expone a clientes solo tus endpoints seguros.

Usa cola y retry

Usa una queue para gestionar concurrencia, reintentar fallos transitorios y mantener la UI responsive.

Controla credits y status

Monitorea credit usage, task status y error responses para mantener previsible el flujo 2.5 API al escalar.

Seedance 2.5 API vs uso v2 standard

2.5 API es una eleccion de workflow sobre Seedance API v2. Usalo para clips rapidos y cambia a standard cuando importen calidad o duracion.

2.5 API prioriza velocidad

Usa fast routing, durations cortas y prompts enfocados cuando necesites feedback rapido.

Standard v2 prioriza calidad

Usa el camino standard Seedance 2.0 cuando cinematic quality y escenas ricas sean prioridad.

Ambos comparten la misma API base

Authentication, billing, status polling y response parsing se mantienen consistentes entre 2.5 planning y uso v2 standard.

Capacidad	2.5 planning	Uso v2 standard
Model hint	seedance-2.0	seedance-2.0
Mejor duracion	4-15 segundos	5, 10 o 15 segundos
Mejor uso	Previews, batches, iteracion rapida	Creativo final, storytelling mas rico
Forma API	Mismos /v2/generate y /v2/status	Mismos /v2/generate y /v2/status

FAQ Seedance 2.5 API

Respuestas para developers que evaluan una integracion estilo Seedance 2.5 API.

Hay un endpoint separado Seedance 2.5 API?

Si. Usa Seedance API v2 con model seedance-2.0. La ruta publica actual es POST /v2/generate y luego GET /v2/status.

Para que es mejor Seedance 2.5 API?

Short previews, social video tests, borradores product motion y high-volume prompt iteration.

Puedo usar image-to-video?

Si. Envia una a cuatro image URLs en images y manten el prompt enfocado en el movimiento deseado.

Con que duration debo empezar?

Mini admite cualquier duracion entera de 4 a 15 segundos. Empieza con 8 segundos para previews rapidos y aumenta la duracion para una escena mas completa.

Que aspect ratios soporta?

Para text-to-video, Mini acepta 16:9, 9:16, 4:3, 3:4, 1:1, 21:9 y adaptive. Elige el ratio que coincida con tu placement.

Como autentico requests?

Pasa Authorization: Bearer YOUR_API_KEY en cada request. Guarda esa key en tu backend.

Como obtengo la URL final?

Consulta GET /v2/status con task_id. Cuando status sea SUCCESS, lee la primera URL en data.response[0].

Funciona con cualquier lenguaje?

Si. Usa HTTPS y JSON estandar, por lo que funciona con cURL, Python, Node.js, Go, Java y otros HTTP clients.

Debo llamar la API desde el browser?

No. Usa backend o BFF para proteger API keys, validar prompts, aplicar rate limits y manejar retries.

Como funciona billing?

Seedance API usa credits. El costo depende de model y duration, por eso short fast jobs son mas faciles de prever.

Puedo pasar de 2.5 planning a standard Seedance 2.0?

Si. Mantén el endpoint y cambia model hint, duration y prompt strategy cuando necesites renders de mayor calidad.

Donde esta la documentacion completa?

Abre la documentacion Seedance 2.0 API v2 para request schema, response examples, pricing tables y error codes.

Crea tu primer job Seedance 2.5 API

Crea una API key, envia un request Mini corto e integra lightweight AI video generation en tu producto.

Empezar con API key Abrir documentacion API Abrir documentacion API