Skip to main content
Usa la documentación de modelos de video de CometAPI eligiendo el flujo de trabajo del proveedor que coincida con tu tipo de tarea. La mayoría de los endpoints de video crean tareas asíncronas, así que guarda el ID de la tarea y usa sondeo para recuperar los resultados. Añade callbacks solo cuando la página específica del modelo documente compatibilidad con callbacks.

Elige una API de video

Crear un video de Seedance

Crea tareas de video de Seedance.

Crear un video de HappyHorse

Crea trabajos de texto a video de HappyHorse.

Crear un video de MiniMax H3

Crea tareas de video de texto a video o de imagen de referencia de MiniMax H3.

Crear un video de Flux 3

Crea tareas de texto a video o de imagen a video de Flux 3.

Crear un video de Sora 2

Crea trabajos de video de Sora 2.

Recuperar un video de Sora 2

Consulta trabajos de video de Sora.

Crear un video de Veo 3

Crea trabajos de video de Veo.

Crear un video de Wan

Crea trabajos de texto a video o de imagen a video de Wan.

Crear un video de xAI

Genera trabajos de video de xAI.

Crear un video de Vidu

Crea trabajos de texto a video o de imagen a video de Vidu.

Crear un video de Omni (Beta)

Crea trabajos de video beta de Omni.

Crear una tarea de texto a video de Kling

Genera videos de Kling a partir de prompts de texto.

Usar modelos de Runway

Elige un modelo de Runway para tareas de imagen, video o audio.

Crear y consultar una tarea de vídeo

Usa un ID de modelo compatible con vídeo de la página Models o del directorio de modelos. Los ejemplos siguientes crean una tarea de vídeo con POST /v1/videos y, después, consultan el ID de tarea devuelto hasta que la tarea alcance un estado terminal.
Estos ejemplos usan el marcador de posición your-video-model-id. Sustitúyelo por un ID de modelo de vídeo disponible de la página Models o del directorio de modelos antes de ejecutar la solicitud.
Abre Crear un vídeo de Seedance y Recuperar un vídeo de Seedance para usar los entornos de pruebas de la API y los esquemas de los endpoints.
Crea la tarea con una solicitud directa:
Consulta la tarea una vez con el ID devuelto:

Ejemplos de respuesta

Una respuesta de creación correcta puede tener este aspecto. Almacena el ID de tarea antes de consultarla:
Una respuesta de consulta correcta puede tener este aspecto. Las respuestas completadas pueden incluir video_url; algunos formatos de proveedores usan campos de resultado específicos del modelo o la ruta de contenido de vídeo cuando esa ruta está documentada:

Registros de modelos de ejemplo

Esta respuesta de ejemplo del catálogo de modelos muestra el envoltorio /api/models y la estructura de un registro de modelo de vídeo. No es una lista completa de modelos.
cURL

Errores comunes

Guarda el ID de la respuesta de creación antes de regresar desde el controlador de tu trabajo.
Añade retraso y backoff entre las comprobaciones de estado.
Usa los campos de duración y resolución documentados para el endpoint de vídeo seleccionado.
Considera video_url como opcional y recurre a campos de resultado específicos del modelo o a la ruta de contenido cuando estén disponibles.
Usa el polling como fuente de referencia y verifica que la URL de tu callback acepte solicitudes POST.

Códigos de error y estrategia de reintentos

No vuelvas a intentarlo hasta corregir los campos de prompt, archivos, duración o tamaño.
No vuelvas a intentarlo hasta que la clave de API esté presente y sea válida.
Comprueba el ID de tarea, la URL base, la ruta y el ID de modelo antes de volver a intentarlo.
Reduce el tamaño de carga antes de volver a intentarlo.
Vuelve a intentarlo con backoff exponencial y reduce la concurrencia de creación o polling.
Vuelve a intentar la creación de tareas con backoff; continúa haciendo polling de las tareas existentes, salvo que la tarea alcance un error terminal.

Precios y directorio de modelos

Página de modelos

Lee cómo CometAPI expone los ID de modelo en la documentación.

Directorio de modelos

Consulta la disponibilidad y las capacidades de los modelos.

Precios

Consulta los precios antes de llamar a un modelo.
Última modificación el 18 de septiembre de 2026