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 conPOST /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.Ejemplos de respuesta
Una respuesta de creación correcta puede tener este aspecto. Almacena el ID de tarea antes de consultarla: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
ID de tarea ausente
ID de tarea ausente
Guarda el ID de la respuesta de creación antes de regresar desde el controlador de tu trabajo.
Polling demasiado rápido
Polling demasiado rápido
Añade retraso y backoff entre las comprobaciones de estado.
Duración o tamaño no compatibles
Duración o tamaño no compatibles
Usa los campos de duración y resolución documentados para el endpoint de vídeo seleccionado.
Falta video_url
Falta video_url
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.Callback no recibido
Callback no recibido
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
400
400
No vuelvas a intentarlo hasta corregir los campos de prompt, archivos, duración o tamaño.
401
401
No vuelvas a intentarlo hasta que la clave de API esté presente y sea válida.
404
404
Comprueba el ID de tarea, la URL base, la ruta y el ID de modelo antes de volver a intentarlo.
413
413
Reduce el tamaño de carga antes de volver a intentarlo.
429
429
Vuelve a intentarlo con backoff exponencial y reduce la concurrencia de creación o polling.
500 o 503
500 o 503
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.