El modo de muestra de Seedance 2.5 ya está disponible en APIYI: guía en 2 pasos para crear un video final en 1080p a partir de una muestra en 480p

Nota del autor: Este artículo explica el flujo de llamadas en dos etapas del modo de borrador de Seedance 2.5. Primero se genera un borrador de bajo costo en 480p y, tras comprobar que el resultado es satisfactorio, se genera el video final en 1080p. Incluye ejemplos de solicitudes listos para ejecutar.

Al generar videos con IA, un problema habitual es crear directamente el video final en alta definición y descubrir que la composición, los movimientos de cámara o las acciones del sujeto no son los esperados. Entonces hay que volver a generarlo, lo que supone una pérdida de tiempo y dinero. El 25 de octubre de 2026, la documentación de APIYI añadió una guía completa sobre el modo de borrador de Seedance 2.5 (Draft Mode). Este modo te permite validar la idea primero con un borrador en 480p y, cuando estés conforme, generar el video final en 1080p a partir del ID de tarea del borrador.

No se trata de una nueva interfaz independiente. El modo de borrador utiliza la interfaz asíncrona de tareas que Seedance ya ofrece. Solo tienes que añadir draft: true al cuerpo de la solicitud o hacer referencia al ID de tarea del borrador en la segunda etapa. Si tu proyecto ya está integrado con Seedance, los cambios son mínimos.

Ventaja principal: Al terminar de leer, conocerás el flujo de llamadas en dos etapas del modo de borrador de Seedance 2.5, sus parámetros clave, las reglas de facturación y las limitaciones de uso. También podrás integrar el flujo de trabajo «primero revisar el borrador y después generar el video final» en tu propia canalización de producción de video.

Aspectos clave del modo de vídeo de prueba de Seedance 2.5

Según la documentación de APIYI, la información clave del modo de vídeo de prueba de Seedance 2.5 se resume en la siguiente tabla:

Por qué vale la pena usar el modo de vídeo de prueba de Seedance 2.5

La generación de vídeo se diferencia claramente de la generación de texto: cada generación tarda más, cuesta más y ofrece resultados más impredecibles. Por muy detallada que sea la indicación, puede que el modelo interprete el ritmo de los planos o los movimientos del sujeto de forma distinta a la esperada. Si se genera directamente en 1080p cada vez, cualquier resultado insatisfactorio supone asumir el coste completo de una versión final.

El modo de vídeo de prueba divide el proceso en dos pasos: una «prueba de cámara» y la «grabación oficial». Un vídeo de prueba a 480p es suficiente para evaluar el sujeto, la dirección de los movimientos de cámara y el ambiente general. Una vez confirmado el resultado, se genera la versión final a 1080p a partir de ese vídeo. Para los equipos que producen vídeos cortos, materiales publicitarios o vistas previas de guiones gráficos en serie, este método puede reducir considerablemente la proporción de vídeos descartados.

Relación entre las dos fases del modo de vídeo de prueba de Seedance 2.5

Hay que tener en cuenta que la versión final no es simplemente una ampliación del vídeo de prueba. La segunda fase es una nueva tarea de generación que hace referencia a la tarea del vídeo de prueba mediante draft_task.id, hereda la configuración correspondiente de la primera fase y genera el resultado a 1080p. Para saber qué parámetros se heredan y cuáles no se pueden modificar en la segunda fase, consulta la sección «Herencia y restricciones de los parámetros» de la documentación de APIYI.

Primeros pasos con el modo de vista previa de Seedance 2.5

Antes de empezar, crea una clave API en la consola de APIYI apiyi.com y configúrala como la variable de entorno APIYI_API_KEY. Los ejemplos siguientes leen la clave desde esa variable para evitar incluirla directamente en el código.

Paso 1: Generar una vista previa en 480p

Esta es la solicitud más sencilla para crear una tarea de vista previa. Lo importante es establecer "draft": true y definir la resolución como 480p:

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "text", "text": "一只橘猫在窗边伸懒腰，阳光洒在木地板上，镜头缓慢推进"}
    ],
    "draft": true,
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 4,
    "generate_audio": false
  }'

La API funciona de forma asíncrona. Si la solicitud se crea correctamente, recibirás un ID de tarea. Guárdalo: lo necesitarás para consultar el resultado de la vista previa y generar el video final.

Parámetros de la solicitud de la primera etapa

El encabezado Accept-Encoding: identity de la solicitud indica al servidor que no comprima la respuesta. Esto facilita que algunos clientes procesen directamente el resultado, por lo que se recomienda mantenerlo.

Segunda etapa: consultar el estado de la tarea de muestra

Después de crear la tarea de muestra, hay que consultar su estado periódicamente hasta que finalice correctamente y se obtenga la URL del video. Para la consulta se utiliza la interfaz existente de tareas asíncronas. Normalmente, se envía una solicitud GET a la URL de la tarea añadiendo su ID. Consulta la documentación de APIYI para conocer la ruta exacta y los campos de la respuesta:

curl -X GET "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks/${TASK_ID}" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Accept-Encoding: identity"

Se recomienda dejar entre 5 y 10 segundos entre consultas. Consultar con demasiada frecuencia no aporta nada y podría activar los límites de frecuencia.

Paso 3: Generar el video final en 1080p a partir del ID de la tarea de muestra

Cuando estés conforme con el resultado de la muestra, haz referencia a su tarea mediante draft_task.id en el array content y establece la resolución en 1080p:

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "YOUR_DRAFT_TASK_ID"}}
    ],
    "resolution": "1080p"
  }'

Sustituye YOUR_DRAFT_TASK_ID por el ID de la tarea de muestra que devolvió el primer paso. Consulta los ejemplos de solicitudes en dos fases de la documentación para verificar los valores admitidos por el campo type de los elementos de content y los demás parámetros opcionales. La tarea de generación del video final también es asíncrona: puedes consultarla como en el segundo paso para obtener el video en 1080p.

import os
import time
import requests

API_KEY = os.environ["APIYI_API_KEY"]
BASE_URL = "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks"  # APIYI, interfaz de tareas asíncronas de Seedance
MODEL = "doubao-seedance-2-5-260628"

HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
    "Accept-Encoding": "identity",
}


def create_task(payload: dict) -> str:
    """Crea una tarea asíncrona y devuelve su ID."""
    resp = requests.post(BASE_URL, headers=HEADERS, json=payload, timeout=60)
    resp.raise_for_status()
    data = resp.json()
    return data["id"]


def wait_task(task_id: str, interval: int = 8, timeout: int = 900) -> dict:
    """Consulta el estado de la tarea hasta que termine correctamente o falle."""
    start = time.time()
    while time.time() - start < timeout:
        resp = requests.get(f"{BASE_URL}/{task_id}", headers=HEADERS, timeout=30)
        resp.raise_for_status()
        data = resp.json()
        status = data.get("status")
        print(f"[{task_id}] status = {status}")
        if status == "succeeded":
            return data
        if status in ("failed", "cancelled", "expired"):
            raise RuntimeError(f"La tarea terminó sin éxito: {data}")
        time.sleep(interval)
    raise TimeoutError(f"Se agotó el tiempo de espera al consultar la tarea {task_id}")


def generate_draft(prompt: str) -> str:
    """Primera fase: genera una muestra en 480p."""
    payload = {
        "model": MODEL,
        "content": [{"type": "text", "text": prompt}],
        "draft": True,
        "resolution": "480p",
        "ratio": "16:9",
        "duration": 4,
        "generate_audio": False,
    }
    task_id = create_task(payload)
    result = wait_task(task_id)
    print("Resultado de la muestra:", result.get("content"))
    return task_id


def generate_final(draft_task_id: str) -> dict:
    """Segunda fase: genera el video final en 1080p a partir del ID de la tarea de muestra."""
    payload = {
        "model": MODEL,
        "content": [
            {"type": "draft_task", "draft_task": {"id": draft_task_id}}
        ],
        "resolution": "1080p",
    }
    task_id = create_task(payload)
    return wait_task(task_id)


if __name__ == "__main__":
    draft_id = generate_draft("Un gato naranja se estira junto a la ventana mientras la luz del sol cae sobre el suelo de madera; la cámara avanza lentamente.")
    ok = input("¿Te gusta la muestra? (y/n): ").strip().lower()
    if ok == "y":
        final = generate_final(draft_id)
        print("Resultado del video final:", final.get("content"))
    else:
        print("Ajusta la indicación y vuelve a generar la muestra.")

🚀 Inicio rápido: Te recomendamos obtener primero el crédito gratuito de prueba para nuevos usuarios en APIYI apiyi.com, perfeccionar la indicación con muestras de 480p y, cuando esté lista, generar los videos finales en 1080p por lotes. La plataforma cobra mediante una clave API unificada, lo que facilita gestionar el costo de las invocaciones en varios proyectos de video.

Comparación entre el modo de muestra de Seedance 2.5 y la generación directa del video final

La decisión de usar el modo de muestra depende de cuánto valoras la previsibilidad del resultado y la rapidez de entrega en tu proyecto. En la tabla se comparan las dos formas de invocación:

Análisis comparativo del modo de muestra de Seedance 2.5

La generación directa del video final tiene la ventaja de un proceso más sencillo: basta con una solicitud para obtener el video definitivo. Sin embargo, si el sujeto de la escena o los movimientos de cámara no son los esperados, se pierden tanto el costo como el tiempo de espera de todo el video final en 1080p. En cambio, el modo de muestra permite hacer pruebas en baja resolución, por lo que resulta más adecuado para proyectos que requieren varias rondas de ajustes de la indicación o en los que el cliente debe aprobar primero la dirección creativa.

Si la plantilla de indicación ya se ha validado muchas veces y los resultados son relativamente estables, también tiene sentido generar directamente el video final. Un enfoque práctico es usar el modo de muestra para nuevas ideas y plantillas, y la generación directa para las plantillas consolidadas. Puedes cambiar de un método a otro en cualquier momento dentro de la misma interfaz asíncrona.

💡 Recomendación: Para comparar los resultados reales de ambos métodos, prueba varios grupos con las indicaciones de tu propio negocio. Al invocar el servicio a través de APIYI apiyi.com, ambos modos comparten la misma interfaz y clave API; para cambiar de uno a otro, solo tienes que modificar los parámetros del cuerpo de la solicitud.

Consideraciones para integrar el modo de muestras de Seedance 2.5

Al integrar el modo de muestras en un entorno de producción, hay varios detalles que es fácil pasar por alto. La siguiente tabla resume los más habituales:

Recomendaciones para diseñar el flujo de trabajo del modo de muestras de Seedance 2.5

En escenarios de colaboración en equipo, recomendamos dividir el modo de muestras en tres etapas: «generación, revisión y aprobación». Una vez que el sistema genere las muestras en lotes, las envía al equipo de revisión. Los ID de las tareas de muestra aprobadas pasan a la cola de videos finales; las rechazadas vuelven a la etapa de ajuste de indicaciones junto con los comentarios. De este modo, la revisión humana se concentra en la fase de muestras, que tiene un costo menor.

En flujos de trabajo más automatizados, también puedes incorporar un Modelo de Lenguaje Grande multimodal en la fase de muestras para hacer una primera revisión automática, por ejemplo, comprobar si aparece el sujeto indicado o si hay deformaciones evidentes. Las muestras que superen esta revisión pasan después a la validación humana, lo que reduce aún más la carga de trabajo. Como APIYI ofrece una interfaz unificada para varios modelos populares, puedes usar la misma clave API para la generación de video y la revisión multimodal.

Preguntas frecuentes (FAQ)

Puntos clave del modo de muestra de Seedance 2.5

• Proceso de dos etapas: primero, genera una muestra en 480p con draft: true; después, usa el ID de la tarea para generar el video final en 1080p
• La interfaz no cambia: se mantiene la interfaz de tareas asíncronas de Seedance, por lo que los proyectos que ya la integran necesitan muy pocos cambios
• Campo clave: en la etapa del video final, se hace referencia a la tarea de muestra mediante content[].draft_task.id
• Reglas de facturación: la muestra y el video final se facturan por separado; solo pagas el costo del video final de las muestras que te convencen
• Límite de tiempo: el ID de la tarea de muestra es válido durante 7 días, así que debes revisarla y aprobarla a tiempo
• Casos de uso: resulta especialmente útil para explorar ideas creativas, obtener la aprobación del cliente y seleccionar materiales en lotes
• Cómo empezar: consigue créditos gratuitos en APIYI (apiyi.com) y sigue los ejemplos de este artículo para completar el proceso

Resumen

Puntos clave del modo de versiones preliminares de Seedance 2.5:

1. Prueba antes de producir: usa versiones preliminares a 480p para validar la composición y los movimientos de cámara a bajo costo, y así reducir la cantidad de videos descartados a 1080p.
2. Integración sencilla: solo tienes que añadir el parámetro draft y hacer referencia a draft_task.id; puedes reutilizar la interfaz asíncrona existente.
3. Ten en cuenta la vigencia y la facturación: los ID de las versiones preliminares son válidos durante 7 días, y las versiones preliminares y los videos finales se facturan por separado.

Si tu negocio de video requiere ajustar las indicaciones con frecuencia, vale la pena integrar cuanto antes el modo de versiones preliminares. Te recomendamos probar el flujo «versión preliminar → video final» con algunas indicaciones representativas y evaluar los resultados y los costos antes de extenderlo a la producción en serie.

Te recomendamos usar APIYI apiyi.com para comprobar rápidamente los resultados del modo de versiones preliminares de Seedance 2.5. La plataforma ofrece una interfaz compatible con OpenAI, facturación por uso y crédito gratuito de prueba para nuevos usuarios.

📚 Referencias

1. Documentación de generación de video Seedance 2 de APIYI: modo de versiones preliminares: instrucciones oficiales para usar el modo de versiones preliminares de Seedance 2.5
2. Enlace: docs.apiyi.com/api-capabilities/seedance2/video-generation#draft-mode

3. Descripción: incluye ejemplos de solicitudes en dos fases, herencia y limitaciones de los parámetros, y detalles sobre la facturación y el periodo de validez.

4. Centro de documentación de APIYI: documentación de todas las interfaces de modelos de la plataforma

5. Enlace: docs.apiyi.com
6. Descripción: puedes consultar una descripción general para elegir un modelo Seedance y las instrucciones de uso de otros modelos.

Autor: Equipo técnico de APIYI
Consultas técnicas: Si tienes algún problema durante la integración, puedes contactarnos desde la página de inicio de APIYI apiyi.com. Encontrarás más información en el centro de documentación docs.apiyi.com.

Artículos relacionados

• Guía práctica de generación y edición de videos con rostros en SeeDance 2.5: incorpora material de personas reales al repositorio y úsalo de forma conforme en 3 pasos: Explica claramente el flujo correcto para generar y editar vídeos con rostros en SeeDance2.5: registrar material de personas reales, obtener el Asset ID, invocarlo mediante asset:// y aclarar si es necesario ocultar los rostros y por qué se bloquea la carga directa de vídeos con rostros.