Seedance API: precios, calidad y configuración para los endpoints oficiales

Seedance API: precios, calidad y configuración para los endpoints oficiales

La Seedance API es útil cuando un equipo necesita generación de video de formato corto a partir de texto, imágenes o medios de referencia, pero la decisión de integración no se reduce a "¿qué modelo se ve mejor?" También hay que elegir un endpoint, entender la unidad de precio, controlar la duración y la resolución, y medir el costo de los clips que tus editores o usuarios del producto realmente aceptan.

Esta guía se centra en las rutas oficiales de configuración que un equipo de medios o de producto puede usar hoy:

• La API oficial de tareas de generación de video de BytePlus ModelArk, que es la ruta directa del proveedor para los modelos Seedance.
• La ruta /v1/videos de Flatkey, que expone los IDs de modelo Seedance mediante una sola API key, un solo saldo y un catálogo de modelos en vivo.

La versión corta: usa Seedance 2.5 cuando necesites flujos de trabajo de video guiados por referencias más sólidos, audio opcional y salidas de 4 a 30 segundos. Usa Seedance 2.0 Pro, Fast o Mini cuando necesites una ruta de menor costo por segundo para pruebas de alto volumen y puedas mantener estricto tu criterio de aceptación. Compara siempre por costo por clip aceptado, no solo por precio por segundo.

Si todavía estás comparando la calidad de los modelos, combina esta guía de precios con el marco de evaluación de Seedance API. Si estás comparando rutas de proveedores, lee la revisión de enrutamiento y precios de Seedance vs Veo API. Si estás pasando de pruebas a operaciones, mantén abierta la lista de verificación de producción de Seedance API mientras configuras colas, reintentos y estados de revisión.

Opciones de endpoint de Seedance API

BytePlus ModelArk documenta Seedance en sus secciones de API de generación de video y precios. Su página de precios describe los modelos de generación de video como un sistema de tasa de tokens y consumo de tokens, y señala que el consumo final de tokens se devuelve después de la llamada a la API mediante campos de uso. La misma página de precios también indica el comportamiento de consumo mínimo de tokens para las series Seedance 2.0 y las solicitudes de Seedance 2.5 cuando el uso estimado cae por debajo del mínimo.

Las páginas de modelos Seedance de Flatkey presentan una unidad más simple de cara al comprador para las rutas que actualmente están en el catálogo: precio por segundo, más las opciones visibles de duración y resolución para cada página de modelo. Esto es más fácil para planificar un presupuesto de prueba creativa, pero los equipos de producción aún deberían registrar el modelo enviado, la resolución, la duración, el grupo de cuenta, el estado final y el resultado aceptado/rechazado.

Instantánea actual de precios de Seedance API en Flatkey

Los precios a continuación se verificaron en las páginas públicas de modelos de Flatkey el 13 de octubre de 2026. Trátalos como una instantánea de configuración, no como un contrato: confirma siempre la página del modelo en vivo antes del lanzamiento o de una ejecución por lotes grande.

La tabla ofrece una estimación inicial. El costo real de la campaña depende de la duración, la resolución, las repeticiones, los fallos, los rechazos por moderación, las ediciones de los usuarios y el número de clips generados que superan tu estándar de revisión.

El precio por segundo no es lo mismo que el costo creativo

Para un flujo de trabajo de generación de video, la métrica que importa es:

accepted_clip_cost =
  total_spend_for_generation_batch
  / number_of_clips_that_pass_review

Por ejemplo, una ruta que cuesta menos por segundo todavía puede ser más cara si produce muchos clips que fallan la revisión de marca, continuidad o detalle del producto. Una ruta de mayor precio puede ser más barata cuando reduce las regrabaciones y el trabajo editorial.

Usa esta hoja de cálculo simple antes de elegir una ruta de Seedance API:

Elección de configuración entre Seedance 2.5 y Seedance 2.0

Elige Seedance 2.5 cuando tu flujo de trabajo dependa de medios de referencia, control de fotogramas, audio opcional u आउटputs más largos de 4 a 30 segundos. La página de Seedance 2.5 de Flatkey enumera flujos de trabajo de texto a vídeo, imagen a vídeo y referencia a vídeo en /v1/videos, con opciones de 480p y 720p y generación de audio como opción de solicitud.

Elige Seedance 2.0 Pro cuando necesites una ruta de Seedance 2.0 con opciones de resolución visible más alta en Flatkey y estés evaluando la calidad creativa final. Elige Seedance 2.0 Fast para velocidad de iteración y pruebas más amplias. Elige Seedance 2.0 Mini para filtrado de bajo coste, triaje de prompts y exploración temprana de conceptos.

No cambies de modelo solo por el precio. Primero ejecuta un pequeño conjunto de pruebas de calidad:

1. Elige 20 prompts de briefs reales de campaña.
2. Incluye al menos cinco prompts difíciles con detalles de producto, manos, empaquetado, continuidad de movimiento o afirmaciones sensibles a la marca.
3. Genera la misma duración y resolución en las rutas candidatas cuando sea posible.
4. Revisa los clips a ciegas antes de mostrar nombres de modelo o precios.
5. Registra los clips aceptados, los clips con ediciones menores, los clips rechazados, el número de reintentos, la latencia de generación y el coste final.

Configuración de la API de Seedance en Flatkey

La ruta de Flatkey mantiene la configuración compacta porque las páginas públicas del modelo exponen juntas la ID del modelo y la ruta. Empieza con una solicitud pequeña y luego añade almacenamiento, reintentos y lógica de revisión.

export FLATKEY_API_KEY="your_flatkey_api_key"
export FLATKEY_BASE_URL="https://router.flatkey.ai"

curl -sS "$FLATKEY_BASE_URL/v1/videos" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [
      {
        "type": "text",
        "text": "A clean product reveal video on a white studio table. The camera moves slowly from left to right while the package rotates once. No text, no watermark."
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": false
  }'

Para image-to-video o reference-to-video, añade las entradas de medios compatibles desde la página del modelo o el flujo de trabajo de la consola, y luego mantén la misma disciplina de registro. Almacena el modelo enviado, el flujo de trabajo, la versión del prompt, las referencias, la resolución, la proporción, la duración, el indicador de audio, el ID de tarea o ID de respuesta, el estado final, el gasto y el resultado de la revisión.

Comprobaciones de configuración de BytePlus ModelArk

Si usas BytePlus ModelArk directamente, sigue la documentación actual de ModelArk para la creación de la clave de API, la URL base y la autenticación, la creación de tareas de generación de vídeo, la recuperación de tareas, el listado y la cancelación o eliminación. La forma exacta de la solicitud y la calculadora de precios deben comprobarse en la consola o la documentación de BytePlus en el momento del lanzamiento.

Usa esta lista de verificación antes de un lanzamiento directo del proveedor:

• Confirma que el modelo Seedance está activado en la región requerida.
• Confirma si tu flujo de trabajo es texto a vídeo, imagen a vídeo, referencia a vídeo u otro modo específico del proveedor.
• Confirma si el precio se basa en tokens, en paquetes o está sujeto a una calculadora para la cuenta actual.
• Confirma el ciclo de vida de la tarea: crear, consultar o recuperar, listar, cancelar, eliminar y estados de fallo.
• Confirma los campos de uso devueltos, especialmente el campo usado para el consumo final de tokens.
• Confirma las reglas de consumo mínimo de tokens para tu resolución, relación de aspecto, duración y modo de entrada de vídeo.
• Confirma la seguridad del contenido, la retención del almacenamiento y los requisitos de URL de medios.

La diferencia importante es operativa: ModelArk directo te da la superficie nativa del proveedor, mientras que Flatkey te da una única superficie de cuenta para muchos modelos y modalidades.

Rúbrica de calidad para pruebas de la API de Seedance

El precio solo resulta útil después de definir la calidad. Usa una rúbrica que coincida con cómo tu equipo aceptará o rechazará los clips.

Para un equipo de producción, el resultado de esta rúbrica debería ser una regla de enrutamiento. Por ejemplo:

Usa seedance-2.0-mini para un filtrado preliminar de prompts.
Usa seedance-2.0-fast para una exploración de conceptos más amplia.
Usa seedance-2.0-pro cuando importe la calidad final de 2.0.
Usa seedance-2.5 cuando se requiera control de referencia, audio o salida de 4-30 s.

Configuración de producción: qué registrar desde el primer día

No esperes a que los costes te sorprendan para añadir observabilidad. Registra estos campos desde la primera prueba de la Seedance API:

• request_id o ID de tarea
• user_id, espacio de trabajo, campaña o cuenta de cliente
• model
• workflow
• resolution
• ratio
• duration
• generate_audio
• cantidad y tipo de medios de referencia
• versión del prompt enviado
• estado de la respuesta
• código de error del proveedor o código de error de la pasarela
• latencia hasta el resultado aceptado
• importe facturado o uso devuelto
• resultado de la revisión: aceptado, editado, rechazado o fallido

Esos campos permiten a finanzas y a las operaciones creativas responder las preguntas reales: qué ruta crea clips utilizables, dónde ocurren las repeticiones y si una ruta de mayor precio es en realidad más barata para un tipo de campaña específico.

Errores comunes de configuración de la Seedance API

Los errores más caros suelen ser operativos:

• Comparar una ruta de 480p con una de 720p o 1080p y llamarlo una diferencia de calidad del modelo.
• Ignorar el comportamiento de duración mínima o consumo mínimo de tokens.
• Medir clips generados en lugar de clips aceptados.
• Cambiar a la vez el prompt, el modelo, la duración y la resolución durante las pruebas.
• Tratar texto a video y referencia a video como si fueran el mismo flujo de trabajo.
• Olvidar registrar el tiempo de revisión humana y el número de repeticiones.
• Codificar de forma rígida un único ID de modelo de Seedance sin una ruta de respaldo o revisión.

La solución es simple: congela un conjunto de prueba, ejecuta configuraciones comparables, registra la ruta y los campos de coste, y luego elige la ruta en función del resultado aceptado.

Plan de configuración recomendado

Para un equipo que empieza esta semana, usa esta secuencia:

1. Ejecuta 20 prompts en seedance-2.0-mini o seedance-2.0-fast para filtrar la estructura del prompt.
2. Promociona los mejores prompts a seedance-2.0-pro y seedance-2.5.
3. Compara la tasa de clips aceptados, no solo los favoritos visuales.
4. Usa seedance-2.5 para clips con mucho uso de referencias o con audio habilitado.
5. Usa una ruta 2.0 de menor coste para una exploración amplia cuando la tasa de aceptación siga siendo buena.
6. Mantén el mismo balance de Flatkey y la misma superficie de informes si tu flujo de trabajo también usa modelos de imagen, audio o texto.

Eso te da una configuración práctica de precios de la Seedance API: una ruta de endpoint, opciones de modelo visibles, una hoja de costes y una rúbrica de revisión que mantiene la calidad vinculada al gasto.

FAQ

¿Qué es la Seedance API?

La Seedance API es una API de generación de video para crear clips cortos a partir de prompts y, según la ruta seleccionada, medios de imagen o de referencia. En Flatkey, las páginas de modelos de Seedance exponen la ruta de video a través de /v1/videos.

¿Cómo se calcula el precio de la Seedance API?

En las páginas públicas de modelos de Flatkey, las rutas de Seedance visibles actualmente se presentan como precio por segundo, con opciones de resolución y duración específicas por modelo. La documentación de precios de BytePlus ModelArk describe el precio de la generación de video mediante tasa de tokens y consumo de tokens, con uso final sujeto a los campos de uso devueltos y reglas de consumo mínimo de tokens para algunas solicitudes de Seedance.

¿Con qué modelo de Seedance debería empezar?

Empieza con seedance-2.0-fast o seedance-2.0-mini para una exploración de bajo coste, y luego evalúa seedance-2.0-pro y seedance-2.5 en los prompts que superen la revisión. Elige seedance-2.5 cuando necesites sus controles documentados de referencia, audio y flujo de trabajo de 4-30 segundos.

¿Qué endpoint debo usar para las solicitudes de la Seedance API de Flatkey?

Usa POST /v1/videos con el ID de modelo de Seedance mostrado en la página del modelo de Flatkey. Las páginas de Seedance 2.5, 2.0 Pro, 2.0 Fast y 2.0 Mini muestran todas /v1/videos como ruta.

¿Qué debo medir en una prueba de calidad de la Seedance API?

Mide la adherencia al prompt, la continuidad del movimiento, la fidelidad de la referencia, la seguridad de marca, la editabilidad, la latencia, el número de reintentos y el costo por clip aceptado. El precio por segundo es solo un dato de entrada en la decisión.

Fuentes consultadas

• Página del modelo Flatkey Seedance 2.5: https://flatkey.ai/models/seedance-2.5
• Página del modelo Flatkey Seedance 2.0 Pro: https://flatkey.ai/models/seedance-2.0-pro
• Página del modelo Flatkey Seedance 2.0 Fast: https://flatkey.ai/models/seedance-2.0-fast
• Página del modelo Flatkey Seedance 2.0 Mini: https://flatkey.ai/models/seedance-2.0-mini
• Página de precios de Flatkey: https://flatkey.ai/pricing
• Documentación de precios de BytePlus ModelArk: https://docs.byteplus.com/en/docs/modelark/model-pricing
• Documentación de la API de tareas de generación de video de BytePlus ModelArk: https://docs.byteplus.com/en/docs/modelark/create-video-generation-task-api