Cómo usar Seedance 2.5 | Campos, límites y facturación
Cómo usar Seedance 2.5 con la API alojada: cada campo y sus límites, las reglas de las referencias, el polling, los segundos facturados y el error 80006.
Saber cómo usar Seedance 2.5 es sobre todo saber la forma de su petición. Una llamada lleva un prompt, cuatro ajustes de salida y hasta tres tipos de material de referencia; la plataforma devuelve un id de tarea; el video terminado se recoge consultando. Lo que cambia respecto a la versión vieja es el techo de 30 segundos, el tamaño del presupuesto de referencias, y una regla de facturación que hace que el video de referencia cueste más de lo que sugiere la tabla de tarifas.
Confirma que estás en 2.5 antes que nada
Varios proveedores dejaron Seedance 2.0 como opción por defecto cuando añadieron 2.5 al lado, así que la cadena de modelo decide lo que recibes. La build 2.5 publicada se sirve bajo un identificador que termina en -face. Los ejemplos de código antiguos citan un identificador sin ese sufijo, que ya no resuelve.
Una segunda comprobación no necesita revisar código. Envía una petición de una generación de 20 segundos. En 2.0 se rechaza en el campo de duración, antes de que exista una tarea, así que no se cobra nada.
Cómo usar Seedance 2.5 con la API alojada
Una petición de generación acepta estos campos.
| Campo | Rango | Por defecto |
|---|---|---|
prompt | hasta 20,000 caracteres | ninguno |
duration | de 4 a 30 segundos, o -1 | 5 |
resolution | 480p, 720p, 1080p | 720p |
aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive | adaptive |
generate_audio | true o false | true |
content_filter | true o false | true |
El prompt es obligatorio para texto a video y opcional en cuanto hay material de referencia. Las líneas entrecomilladas que haya dentro se generan como habla, en la misma pasada que la imagen, como una pista mono que cubre diálogo, efectos y música.
Poner duration a -1 le entrega al modelo la decisión de la duración. La reserva se toma en el tope de 30 segundos, así que presupuesta un clip de duración completa cuando lo uses.
Más allá de esos, la petición expone output_format para mp4 o mov, junto con bitrate_mode, watermark, return_last_frame, seed, image_with_roles, omni_reference_task_type y un array tools. return_last_frame es el campo que importa para encadenar, ya que el último fotograma de una generación es lo que siembra la siguiente.
Reglas del material de referencia que rechazan una petición
La validación del material de referencia es estricta y se dispara antes de que se cree una tarea, lo que hace que un rechazo sea gratis pero también hace fácil chocar con él repetidamente.
- Imágenes: hasta 30 por petición, jpeg, png, webp, bmp, tiff, gif, heic o heif, por debajo de 30 MB cada una.
- Video: hasta 10 clips, mp4 o mov, 200 MB o menos cada uno, de 2 a 30 segundos cada uno, 30 segundos combinados.
- Audio: hasta 10 pistas, wav o mp3, 15 MB o menos cada una, de 2 a 30 segundos cada una, 30 segundos combinados.
Cada uno de esos es una URL HTTP(S) pública. Los data URI se rechazan en toda la plataforma, así que aloja el archivo antes.
Las imágenes y el audio de referencia no suman nada a la factura. El video de referencia sí, de dos maneras, que es la sección siguiente.
Calcular la factura antes de enviarla
La facturación es por segundo de video terminado a una tarifa fijada por la resolución y por si se adjuntó video de referencia.
| Resolución | Solo generación | Con video de referencia |
|---|---|---|
| 480p | $0.118589 | $0.071153 |
| 720p | $0.266824 | $0.160094 |
| 1080p | $0.461856 | $0.275904 |
Los segundos facturados son el mayor de dos valores: la duración del video de referencia redondeada hacia arriba más la duración de salida, o cinco tercios de la duración de salida redondeados hacia arriba.
Dos ejemplos resueltos muestran por qué eso importa.
Una generación de diez segundos en 1080p sin clip de referencia factura diez segundos a $0.461856, que son unos $4.62.
Esa misma salida de diez segundos en 1080p con un clip de referencia de seis segundos factura el mayor entre 16 segundos y 17 segundos, así que 17 segundos a $0.275904, que son unos $4.69. La tarifa más baja queda compensada por el suelo.
Un trabajo más pequeño muestra el efecto con más nitidez. Una salida de cinco segundos en 720p con un clip de referencia de tres segundos factura nueve segundos en lugar de ocho, lo que sale por unos $1.44, mientras que esos mismos cinco segundos generados desde cero salen por algo más de $1.33.
Polling, tiempos y reembolsos
El trabajo es asíncrono. Enviarlo devuelve un id de tarea, y el video se recupera consultando esa tarea hasta que informa de que ha terminado.
La generación tarda de media de dos a cinco minutos. Consultar es gratis, así que un intervalo fijo de quince a veinte segundos es razonable y no hay ninguna ventaja en espaciar las consultas de forma agresiva.
Los trabajos fallidos se reembolsan íntegros. Las cifras de uso de una tarea fallida muestran si el importe reservado volvió, algo que conviene revisar cuando un lote se ha portado mal.
Leer un rechazo
Los rechazos por seguridad devuelven el error 80006. El error no identifica qué etapa se disparó, así que la causa puede ser el prompt, un archivo de referencia o la salida generada.
Empieza por el prompt. Las celebridades reales nombradas, la propiedad intelectual de terceros y el contenido ilegal están bloqueados dentro del modelo, y ningún ajuste del proveedor los quita. Después revisa las imágenes de referencia, ya que una cara o un logotipo en una fotografía que aportas puede disparar el mismo resultado que nombrarlo.
content_filter vale true por defecto. Ponerlo a false enruta la petición por un canal menos restrictivo y no desactiva la moderación. Es un control de enrutamiento y no un interruptor, y el alias antiguo nsfw_checker sigue validando.
Preguntas frecuentes
¿Qué cadena de modelo llamo para Seedance 2.5?
La build publicada lleva un identificador que termina en -face. Los identificadores sin ese sufijo vienen de ejemplos previos al lanzamiento y ya no resuelven.
¿Cómo genero un clip de más de 30 segundos?
Encadenando generaciones. Treinta segundos es el techo por petición, así que las piezas más largas son trabajos separados unidos en un editor, con return_last_frame dándote un punto de relevo limpio.
¿Por qué un video de referencia costó más de lo que sugería la tabla de tarifas? El clip de referencia se factura por su propia duración además de la salida, y la petición nunca se factura por menos de cinco tercios de la duración de salida, redondeados hacia arriba. El valor que sea mayor se convierte en los segundos facturados.
¿Apagar el filtro de contenido deja pasar cualquier cosa?
No. Poner content_filter a false selecciona un canal menos restrictivo y la moderación sigue aplicándose. Los bloqueos a nivel de modelo sobre celebridades reales, propiedad intelectual de terceros y contenido ilegal siguen ahí igualmente.
En resumen
Cómo usar Seedance 2.5, en orden: verifica la cadena de modelo -face, pon la duración entre 4 y 30 segundos, elige una resolución y una relación de aspecto, deja el audio encendido salvo que quieras silencio, adjunta imágenes de referencia sin reparos porque son gratis, envía, y después consulta cada quince segundos durante dos a cinco minutos. Ponle precio al trabajo por segundos facturados y no por segundos de salida siempre que haya video de referencia de por medio, y trata el error 80006 como un reembolso más una reescritura.
