Seedance 2.5 API: endpoint, parámetros y facturación real
La Seedance 2.5 API es asíncrona, se cobra por segundo y tiene tres reglas de facturación que pillan desprevenida a la gente. Todo lo que necesitas antes de escribir la primera llamada.
Desde $0.07 por segundo, 480p con un clip de referencia
Qué te da la Seedance 2.5 API
Un POST crea un trabajo, un GET consulta su estado y consultar es gratis. La Seedance 2.5 API decide el modo según qué campos de medios rellenes, no según un parámetro aparte.
Un prompt solo es texto a video. Añade imágenes y la Seedance 2.5 API ejecuta imagen a video. Añade primer y último fotograma y anima una transición. Añade un clip de origen y edita o extiende.
El POST devuelve un id de tarea al instante y la generación tarda de dos a cinco minutos. Una integración con la Seedance 2.5 API necesita un bucle de consulta o una cola, no una petición síncrona.
La plataforma lo sirve como doubao-seedance-2.5-face. Equivocarse con la cadena del modelo de la Seedance 2.5 API es el fallo más común en la primera llamada, y devuelve un error síncrono en lugar de un cargo.
Una cabecera, con ámbito de espacio de trabajo y sin id de proyecto. Una clave de la Seedance 2.5 API lleva el ámbito de facturación del espacio de trabajo que la emitió.
Todo trabajo fallido devuelve el crédito íntegro, incluidos los rechazos por moderación. La Seedance 2.5 API nunca cobra por un render que no has recibido.
Aquí no hay ningún generador. Las llamadas a la Seedance 2.5 API se ejecutan en la API alojada, y todos los parámetros y tarifas de abajo están tomados de su documentación publicada.
Los parámetros de la Seedance 2.5 API que más importan
Cuatro campos que deciden el coste y el resultado.
duration
De cuatro a treinta segundos, cinco por defecto. Pasar -1 deja que el modelo elija, pero la Seedance 2.5 API reserva crédito por el tope de 30 segundos y devuelve la diferencia, lo que puede provocar un 402 si vas justo de saldo.
resolution
480p, 720p o 1080p, con 720p por defecto. No hay 4K en la Seedance 2.5 API, y pedirlo devuelve un error en lugar de un clip a menor calidad.
content_filter
Booleano, activado por defecto. En false enruta la petición de la Seedance 2.5 API a un canal menos restrictivo y hace obligatorio el prompt. La plataforma lo documenta como enrutamiento y no como interruptor de apagado.
omni_reference_task_type
Declara edición o extensión y la Seedance 2.5 API valida las reglas al enviar, en lugar de fallar minutos después. Merece la pena ponerlo en cualquier trabajo guiado por referencias.
Cuatro pasos hasta una llamada funcional a la Seedance 2.5 API
- 1
Crea una clave
Genera una en el panel de la plataforma y envíala como bearer token. La Seedance 2.5 API rechaza cualquier otra cosa en la cabecera de autorización.
- 2
Haz el POST del trabajo
Envía el modelo, el prompt y las URLs de medios al endpoint de generación de videos. Todos los campos de medios de la Seedance 2.5 API admiten URLs públicas HTTP o HTTPS; base64 se rechaza en toda la plataforma.
- 3
Consulta la tarea
Haz GET del id de tarea hasta que el estado sea completado o fallido. Consultar el estado en la Seedance 2.5 API no cuesta nada, así que un intervalo de dos segundos va bien.
- 4
Lee el resultado
Una tarea completada de la Seedance 2.5 API trae las URLs del video, más la URL del último fotograma si lo pediste. Vuelve a alojar todo lo que quieras conservar, porque las URLs entregadas no son permanentes.
Seedance 2.5 API: respuestas
Por segundo de video facturable, de $0.071153 a $0.461856 según la resolución y según si la petición llevaba un clip de referencia. Un render de diez segundos en 1080p sale por unos $4.62. Las imágenes de referencia y el audio de referencia no suman nada a la factura.
La duración de salida, más la duración completa de cualquier video de referencia, con un mínimo de cinco tercios de la duración de salida en toda petición que incluya video. Un origen de dos segundos con una salida de cinco factura nueve segundos en lugar de siete, y eso sorprende a casi todas las primeras integraciones.
doubao-seedance-2.5-face en la API alojada. Las guías antiguas citan doubao-seedance-2.5 sin el sufijo, que es anterior al lanzamiento y no resuelve. Consulta la página del modelo en lugar de fiarte de un ejemplo de código.
Consultar el estado por sondeo es la vía documentada y es gratis, así que un bucle con intervalo corto es la integración más simple con la Seedance 2.5 API. Como la generación tarda de dos a cinco minutos, un sondeo cada dos a cinco segundos no añade carga apreciable y no necesitas infraestructura de callbacks.
Validación de esquema, y no se ha cobrado nada. Las causas habituales son una resolución no válida, un valor de tamaño combinado con primer o último fotograma, o un prompt que falta en una petición de texto a video. El error indica qué campo lo provoca.
O una regla del tipo de tarea, o la moderación. El error 80006 es un rechazo por seguridad y no indica la fase. Un desajuste de parámetros en un trabajo de edición produce un fallo distinto, y declarar omni_reference_task_type lo convierte la próxima vez en un 400 inmediato.
Hasta 30 imágenes, 10 clips de video que sumen 30 segundos y 10 pistas de audio. Los arrays de imágenes y de imágenes etiquetadas por rol son mutuamente excluyentes, así que elige uno por cada petición a la Seedance 2.5 API.
Sí, en el mismo endpoint con otro id de modelo. Seedance 2.0 se queda en 15 segundos donde 2.5 llega a 30, y la forma de la petición es lo bastante parecida como para que cambiar de versión sea básicamente cambiar una cadena.
Una clave lleva el ámbito de facturación del espacio de trabajo que la emitió, y no hay una cabecera de proyecto aparte. Los equipos que necesitan contabilidad separada crean espacios de trabajo separados en vez de claves separadas dentro de uno, porque el consumo se agrega a nivel de espacio de trabajo.
Empieza por la documentación de la Seedance 2.5 API
Parámetros publicados, tarifas por segundo actualizadas, consulta de estado gratis y reembolso automático si falla.
Relacionado: Seedance 2.5 API