Usted leyó el anuncio de Seedance 2.5, esbozó una característica de producto en torno a clips generados de 30 segundos, y ahora quiere escribir código. Luego se topa con el muro que todo desarrollador encuentra con un modelo recién anunciado: la página de capacidades está activa, pero el endpoint al que realmente puede llamar desde su aplicación es una cuestión completamente diferente.
Aquí está la versión honesta de la situación, y una guía de inicio rápido que la respeta. Atlas Cloud ha publicado una página de la familia Seedance 2.5 que se compromete a un acceso el Día 0 en los mismos endpoints unificados que ya sirven a Seedance 2.0 y 1.5. En el momento de escribir este artículo, esa lista está marcada como "Próximamente" y no se ha publicado ningún precio de Atlas Cloud para Seedance 2.5. Lo que eso significa en la práctica son buenas noticias: la integración que construya hoy contra un nivel de Seedance en vivo es la misma integración que ejecutará en el lanzamiento de 2.5. Lo único que cambia es la cadena del modelo.
Así que esta guía de inicio rápido hace dos trabajos. Obtiene un video real de un endpoint real hoy, y estructura su código y sus prompts para que la actualización sea una diferencia de una línea.
Qué se está lanzando realmente en Seedance 2.5
Según la página oficial de Seedance 2.5 de ByteDance, este es un modelo de generación conjunta de audio y video de próxima generación construido para la narración de 30 segundos con control de referencia preciso y edición potente. Las afirmaciones concretas en las que vale la pena basarse para el diseño:
- Hasta 30 segundos en una sola generación, con la opción de extender dos veces para una narración más larga y completa
- Movimiento más suave y consistente, con imágenes más realistas
- Comprensión más precisa del video de referencia, capturando la intención, el encuadre y el lenguaje cinematográfico en lugar de solo transferir el movimiento
- Edición más confiable en una gama más amplia de solicitudes de edición de audio y visuales
- Control de modelo blanco y edición de pantalla verde, además de movimiento de cámara profesional y bloqueo de rendimiento, dirigido a flujos de trabajo de producción complejos
Observe lo que no está en esa lista: ninguna tabla de referencia, ninguna escalera de resolución, ningún recuento de activos de referencia. Cualquier cosa que haya visto en esa línea es el barniz de marketing de alguien, no la hoja de especificaciones de primera parte. Construya sobre las afirmaciones anteriores.
Paso 1: obtenga una clave de la consola
Inicie sesión en console.atlascloud.ai y cree una clave API. No hay depósito, ni compromiso mínimo ni lista de espera, por lo que la clave se puede usar inmediatamente con pago por uso. Una clave cubre el catálogo completo de más de 300 modelos de texto, imagen y video, en una cuenta de facturación, que es la parte que importa para esta guía de inicio rápido: la clave que genere ahora es la misma clave que llamará a Seedance 2.5.
Guárdela como una variable de entorno, nunca en el código fuente. ATLASCLOUD_API_KEY es un buen nombre.
Paso 2: envíe un trabajo de video
La generación de video en Atlas Cloud es una llamada REST asíncrona de dos pasos, no una finalización de chat. Usted POSTea un trabajo y obtiene una ID de predicción, luego sondea esa ID hasta que finaliza la renderización. Cualquier cliente HTTP servirá, por lo que no hay un SDK de proveedor que instalar ni un nuevo esquema de autenticación que aprender: es un token de portador en la clave que acaba de generar.
python1import os, time, requests 2 3KEY = os.environ["ATLASCLOUD_API_KEY"] 4BASE = "https://api.atlascloud.ai/api/v1/model" 5HAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"} 6 7job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={ 8 "model": "bytedance/seedance-2.0/text-to-video", 9 "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, " 10 "neon reflections on wet asphalt, slight lag on turns.", 11 "duration": 5, 12 "resolution": "720p", 13 "ratio": "adaptive", 14 "bitrate_mode": "standard", 15 "generate_audio": True, 16 "watermark": False, 17}).json() 18 19prediction_id = job["data"]["id"]
La respuesta se devuelve como {"code": 200, "data": {"id": "...", "status": "processing"}}. Tenga en cuenta que model es un campo de cadena de texto simple. Ese detalle es toda la historia de actualización para este artículo, y el Paso 6 vuelve a él.
Paso 3: sondee hasta que la renderización aterrice
Un clip de 5 segundos no es una respuesta instantánea, así que trate la renderización como un trabajo con un ciclo de vida en lugar de una llamada de bloqueo. Sondee el endpoint de predicción hasta que status alcance un valor terminal.
python1while True: 2 r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json() 3 status = r["data"]["status"] 4 if status in ("completed", "succeeded", "failed"): 5 break 6 time.sleep(3) 7 8print(status, r["data"]) # on success the payload carries the output URL(s)
Dos cosas que vale la pena incorporar ahora en lugar de más tarde. Ponga un límite al bucle de sondeo para que un trabajo atascado no pueda colgar un controlador de solicitudes, y persista la ID de predicción antes de comenzar a sondear para que un trabajador bloqueado pueda reanudar en lugar de pagar dos veces por la renderización. Ambos hábitos se mantienen sin cambios en 2.5.
Si su característica funciona a partir de una imagen de referencia o una referencia de sujeto en lugar de texto puro, el mismo flujo se aplica con una variante de modelo diferente, bytedance/seedance-2.0/image-to-video o bytedance/seedance-2.0/reference-to-video. Los activos de referencia de sujeto se cargan una vez a través de uploadMedia y luego se pasan como asset://<id> en los campos de imagen, por lo que un personaje o producto recurrente no necesita volver a cargarse en cada llamada.
Paso 4: elija un nivel de Seedance en vivo y sepa cuánto cuesta un segundo
Atlas Cloud factura el video por segundo de duración de salida. Esa es una aritmética que puede hacer en su cabeza antes de escribir cualquier código. Tres niveles de Seedance están activos hoy:
| Modelo | ID del modelo | Precio de Atlas Cloud | Notable |
|---|---|---|---|
| Seedance 2.0 | bytedance/seedance-2.0/text-to-video | $0.112/s | Nivel insignia en vivo, clave instantánea, sin lista de espera |
| Seedance 2.0 Fast | bytedance/seedance-2.0-fast/text-to-video | $0.09/s | Variante más rápida de la misma familia |
| Seedance 2.0 Mini | bytedance/seedance-2.0-mini/text-to-video | $0.056/s | El nivel más barato de Seedance 2.0 en vivo, también de imagen a video y de referencia a video |
| Seedance 1.5 Pro | bytedance/seedance-v1.5-pro/text-to-video | $0.047/s, o $0.018/s en la variante Fast | Audio sincronizado nativo, sincronización labial multilingüe, clips de 4 a 12 segundos |
Para orientación, otros modelos de video en la misma clave se ejecutan en una banda comparable: Grok Imagine Video v1.5 a $0.080/s, Wan 2.7 a $0.100/s, Kling V3.0 Turbo a $0.112 estándar y $0.095 con descuento, MiniMax H3 a $0.14/s.
Cuál construir depende de lo que su característica 2.5 eventualmente hará. Si el audio es fundamental para la salida, Seedance 1.5 Pro es el nivel que ya tiene audio sincronizado nativo y sincronización labial multilingüe, por lo que su pipeline aprende a manejar una pista de audio desde el primer día. Si está iterando en la estructura del prompt y quiere el costo más bajo por experimento, Seedance 2.0 Mini a $0.056/s es el sandbox obvio. Si desea lo más parecido a una renderización de generación actual de grado de producción, Seedance 2.0 a $0.112/s es la opción sencilla, con la variante Fast a $0.09/s si el rendimiento importa más que el último incremento de calidad.
Paso 5: verifique el precio en vivo en el Playground antes de gastar
Antes de su primera llamada de pago, abra el modelo en el Atlas Cloud Playground. Cada modelo muestra su precio por modelo en vivo junto al botón Ejecutar. Esto importa más de lo que parece: los descuentos promocionales van y vienen, y el número junto al botón Ejecutar es el que realmente facturará. Ejecute una generación en el Playground, confirme que la salida es lo que su característica necesita, luego transfiera la configuración al código.
El modelo de "por segundo de salida" también hace que su conversación presupuestaria sea trivial. Un clip de 10 segundos en Seedance 2.0 Mini es 10 × $0.056. No hay calculadora, ni estimación de tokens ni paso de conciliación posterior.
Vale la pena contrastar esto con cómo los canales de ByteDance de primera parte facturan Seedance. En Volcano Engine Ark en China y BytePlus ModelArk internacionalmente, la facturación se basa en tokens: el consumo estimado de tokens es (duración del video de entrada + duración del video de salida) × ancho de salida × alto de salida × velocidad de fotogramas de salida / 1024, multiplicado por un precio unitario de token, con el uso real autorizado del campo usage.completion_tokens en la respuesta de la API. Para la serie Seedance 2.0 y Seedance 2.5, cuando la entrada incluye video, se aplica un piso de consumo mínimo de tokens, y el piso depende de la resolución, la relación de aspecto y la duración de la salida. ByteDance publica una calculadora de precios más una tabla de tokens mínimos exactamente por esta razón.
Ambos modelos son legítimos. Pero si está presupuestando una renderización de 30 segundos, la duración por segundo de salida es aritmética mental y el token con pisos necesita una hoja de cálculo.
Paso 6: escriba la descripción de la toma como si ya fuera 2.5
Esta es la parte de la guía de inicio rápido que se transfiere perfectamente, porque la creación de prompts no tiene versiones. Dos de las afirmaciones de capacidad de 2.5 deberían cambiar la forma en que escribe hoy.
Control de referencia preciso. La afirmación de ByteDance es que 2.5 lee un video de referencia por su intención, encuadre y lenguaje cinematográfico, yendo más allá de la transferencia de movimiento. La implicación del prompting es que su activo de referencia deja de ser una plantilla de movimiento y comienza a ser un resumen directorial. Así que deje de escribir prompts que describan solo el sujeto, y comience a nombrar la gramática que desea que se transfiera: la sensación de la lente, el encuadre, el ritmo del corte, si la cámara lidera o sigue al sujeto. Escriba "toma media de mano, siguiendo al sujeto, con reflejos de neón en el asfalto mojado, ligero retraso en los giros" en lugar de "persona caminando, cinematográfico".
Treinta segundos en una sola generación. Un clip de 5 segundos es una toma. Treinta segundos es una escena con estructura, y 2.5 admite extender dos veces además de eso. Así que escriba descripciones de tomas con una estructura de ritmo en lugar de una sola descripción estática: un ritmo de establecimiento, un cambio (un giro, una entrada, una revelación) y una resolución. Nombre explícitamente el movimiento de la cámara y el bloqueo de rendimiento, ya que esos son exactamente los controles a los que apunta 2.5. Dónde se para el sujeto, dónde se mueve, qué hace la cámara mientras se mueve.
Ambos hábitos dan sus frutos en los niveles en vivo ahora. Ambos son los hábitos exactos que 2.5 recompensa.
Paso 7: planifique el intercambio
Estructure su código para que el identificador del modelo sea una configuración, no un literal. Una constante, leída del entorno o de la configuración:
python1SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")
Luego pase SEEDANCE_MODEL donde el Paso 2 codificó la cadena. Debido a que model es un campo de cadena JSON único en el cuerpo de generateVideo, la actualización en el lanzamiento de 2.5 es realmente una variable de entorno. No una metáfora de un pequeño cambio, literalmente un valor.
Nunca codifique un identificador de Seedance 2.5 hoy, porque aún no existe una ID de modelo de Atlas Cloud Seedance 2.5. Obtenga las ID en vivo exactas del catálogo en atlascloud.ai/models en lugar de copiarlas de un artículo, incluido este, ya que se agregan nuevas variantes con el tiempo. Cuando 2.5 aterrice bajo el compromiso del Día 0, el trabajo de su parte es esa variable, más una nueva mirada al precio junto al botón Ejecutar y una nueva lectura de cualquier nuevo parámetro de solicitud, ya que un modelo de 30 segundos con soporte de extensión probablemente aceptará campos que el cuerpo de 2.0 no tiene.
Mientras tanto, si necesita Seedance 2.5 hoy en lugar de en el lanzamiento de Atlas Cloud, la respuesta honesta son los canales de ByteDance de primera parte: Volcano Engine Ark en China y BytePlus ModelArk internacionalmente. Entre los agregadores, varios se encuentran en el mismo estado de prelanzamiento o compromiso del Día 0.
Preguntas frecuentes
P: ¿Puedo llamar a Seedance 2.5 en Atlas Cloud ahora mismo? R: No. La página de la familia Seedance 2.5 en Atlas Cloud está marcada como "Próximamente" con un compromiso de acceso el Día 0 en los mismos endpoints unificados que ya sirven a Seedance 2.0 y 1.5. Aún no se ha publicado ninguna ID de modelo ni precio para ello.
P: ¿Cuánto cuesta Seedance en Atlas Cloud hoy? R: Seedance 2.0 cuesta $0.112/s, Seedance 2.0 Fast cuesta $0.09/s, Seedance 2.0 Mini cuesta $0.056/s, y Seedance 1.5 Pro cuesta $0.047/s o $0.018/s en su variante Fast. La facturación es por segundo de duración de salida, y el precio en vivo se muestra junto al botón Ejecutar en el Playground.
P: ¿Necesito un SDK especial para video en Atlas Cloud?
R: No. El video es un flujo REST simple: POST /api/v1/model/generateVideo para enviar un trabajo, luego GET /api/v1/model/prediction/{id} para sondearlo, ambos autenticados con un token de portador en su clave de Atlas Cloud. Cualquier cliente HTTP funciona. Tenga en cuenta que el video no pasa por el endpoint de chat compatible con OpenAI que utiliza el catálogo de texto, así que no espere que chat.completions renderice un clip. Los parámetros de solicitud por modelo están documentados en atlascloud.ai/docs.
P: ¿Hay un depósito o compromiso mínimo para empezar? R: No. Atlas Cloud es de pago por uso sin depósito, sin compromiso mínimo y sin lista de espera, y la clave de console.atlascloud.ai se puede usar inmediatamente.
P: ¿En qué nivel en vivo debo prototipar si estoy apuntando a 2.5? R: Seedance 2.0 Mini a $0.056/s para una iteración de prompt barata, Seedance 1.5 Pro si su pipeline necesita manejar una pista de audio sincronizada nativa, y Seedance 2.0 a $0.112/s para la renderización de producción de generación actual más cercana.
En resumen
Atlas Cloud ejecuta Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini y Seedance 1.5 Pro hoy con una clave API con facturación por segundo de duración de salida, certificación SOC II, cumplimiento de HIPAA y cifrado en reposo y en tránsito, y ha publicado un compromiso del Día 0 para servir a Seedance 2.5 en esos mismos endpoints unificados cuando se lance.
