Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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 task ID y usa polling para recuperar los resultados. Agrega callbacks solo cuando la página específica del modelo documente compatibilidad con callbacks.

​
Elegir una API de video

Crear video con Sora

Crear tareas de video de Sora.

Recuperar video de Sora

Consultar tareas de video de Sora.

Runway de imagen a video

Generar videos de Runway a partir de imágenes.

Kling de texto a video

Generar videos de Kling a partir de prompts de texto.

Crear en Seedance

Crear tareas de video de Seedance.

Generación de video con xAI

Generar tareas de video de xAI.

​
Crear y consultar una tarea de video

Usa un model ID con capacidad de video de la página Models o del directorio de modelos. Los ejemplos a continuación crean una tarea de video con POST /v1/videos y luego consultan el task ID 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 model ID de video disponible de la página Models o del directorio de modelos antes de ejecutar la solicitud.
Abre Create y Query para usar los playgrounds de la API y los esquemas de los endpoints.
import os
import time
import requests

headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}

create_response = requests.post(
    "https://api.cometapi.com/v1/videos",
    headers=headers,
    data={
        "model": "your-video-model-id",
        "prompt": "A calm camera move across a desk with a paper airplane",
    },
    timeout=30,
)
create_response.raise_for_status()
task = create_response.json()
task_id = task["id"]

terminal_statuses = {"completed", "failed", "error"}

while True:
    poll_response = requests.get(
        f"https://api.cometapi.com/v1/videos/{task_id}",
        headers=headers,
        timeout=30,
    )
    poll_response.raise_for_status()
    result = poll_response.json()
    print(result["status"], result.get("progress"))

    if result["status"] in terminal_statuses:
        print(result.get("video_url"))
        break

    time.sleep(10)

​
Ejemplos de respuesta

Una respuesta de creación exitosa puede verse así. Guarda el task ID antes de hacer polling: 
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
Una respuesta de polling exitosa puede verse así. Las respuestas completadas pueden incluir video_url; algunos formatos de proveedor usan campos de resultado específicos del modelo o la ruta de contenido de video cuando esa ruta está documentada: 
{
  "id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "completed",
  "progress": 100,
  "completed_at": 1779872300,
  "video_url": "https://example.com/generated-video.mp4"
}

​
Registros de modelo de ejemplo

Esta respuesta de ejemplo del catálogo de modelos muestra el contenedor de /api/models y la forma de un registro de modelo de video. No es una lista completa de modelos.
cURL
curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1767529753,
      "id": "your-video-model-id",
      "code": "your-video-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example video model",
      "model_type": "video",
      "features": [
        "text-to-video"
      ],
      "endpoints": "{\n  \"seedance\": {\n    \"path\": \"/v1/videos\",\n    \"method\": \"POST\"\n  }\n}",
      "pricing": {
        "currency": "USD / M Tokens",
        "input": null,
        "output": null,
        "per_request": null,
        "per_second": 0.024
      }
    }
  ]
}

​
Errores comunes

Guarda el ID de la respuesta de creación antes de retornar desde tu controlador de tareas.
Agrega retraso y backoff entre las comprobaciones de estado.
Usa los campos de duración y resolución documentados para el endpoint de video seleccionado.
Trata 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 polling como fuente de verdad y verifica que tu URL de callback acepte solicitudes POST.

​
Códigos de error y estrategia de reintento

No reintentes hasta que se corrijan los campos de prompt, archivos, duración o tamaño.
No reintentes hasta que la API key esté presente y sea válida.
Verifica el task ID, la URL base, la ruta y el model ID antes de reintentar.
Reduce el tamaño de la carga antes de reintentar.
Reintenta con backoff exponencial y reduce la concurrencia de creación o de polling.
Reintenta la creación de tareas con backoff; sigue consultando las tareas existentes a menos que la tarea alcance un error terminal.
Para patrones de implementación, consulta Error codes and retry strategy, Rate limits and concurrency y Webhook and polling for video generation.

​
Precios y directorio de modelos

Página Models

Lee cómo CometAPI expone los model IDs en la documentación.

Directorio de modelos

Explora la disponibilidad y las capacidades de los modelos.

Precios

Consulta los precios antes de llamar a un modelo.
Last modified on May 28, 2026