Vai al contenuto principale

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 documentazione dei modelli video di CometAPI scegliendo il flusso del provider che corrisponde al tuo tipo di lavoro. La maggior parte degli endpoint video crea task asincroni, quindi salva il task ID e usa il polling per recuperare i risultati. Aggiungi i callback solo quando la pagina specifica del modello documenta il supporto ai callback.

​
Scegli un’API video

Crea video Sora

Crea task video Sora.

Recupera video Sora

Interroga i task video Sora.

Runway image to video

Genera video Runway da immagini.

Kling text to video

Genera video Kling da prompt testuali.

Creazione Seedance

Crea task video Seedance.

Generazione video xAI

Genera task video xAI.

​
Crea ed esegui il polling di un task video

Usa un model ID compatibile con i video dalla pagina Models o dalla directory dei modelli. Gli esempi seguenti creano un task video con POST /v1/videos, quindi eseguono il polling del task ID restituito finché il task non raggiunge uno stato terminale.
Questi esempi usano il segnaposto your-video-model-id. Sostituiscilo con un model ID video disponibile dalla pagina Models o dalla directory dei modelli prima di eseguire la richiesta.
Apri Create e Query per usare i playground API e gli schemi degli endpoint.
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)

​
Esempi di risposta

Una risposta di creazione riuscita può apparire così. Memorizza il task ID prima di eseguire il polling: 
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
Una risposta di polling riuscita può apparire così. Le risposte completate possono includere video_url; alcuni formati dei provider usano campi risultato specifici del modello o il route dei contenuti video quando quel route è documentato: 
{
  "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"
}

​
Esempi di record del modello

Questa risposta di esempio del catalogo modelli mostra il wrapper /api/models e la struttura di un record di modello video. Non è un elenco completo di modelli.
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
      }
    }
  ]
}

​
Errori comuni

Memorizza l’ID dalla risposta di creazione prima di restituire l’esito dal tuo handler del job.
Aggiungi un ritardo e un backoff tra i controlli di stato.
Usa i campi duration e resolution documentati per l’endpoint video selezionato.
Considera video_url come opzionale e fai fallback ai campi risultato specifici del modello o al route dei contenuti quando disponibile.
Usa il polling come fonte di verità e verifica che il tuo callback URL accetti richieste POST.

​
Codici di errore e strategia di retry

Non riprovare finché i campi prompt, files, duration o size non sono stati corretti.
Non riprovare finché la API key non è presente e valida.
Controlla il task ID, il base URL, il path e il model ID prima di riprovare.
Riduci la dimensione dell’upload prima di riprovare.
Riprova con exponential backoff e riduci la concorrenza di creazione o di polling.
Riprova la creazione del task con backoff; continua a eseguire il polling dei task esistenti a meno che il task non raggiunga un errore terminale.
Per i pattern di implementazione, vedi Codici di errore e strategia di retry, Limiti di velocità e concorrenza, e Webhook e polling per la generazione video.

​
Pricing e directory dei modelli

Pagina Models

Leggi come CometAPI espone i model ID nella documentazione.

Directory dei modelli

Consulta la disponibilità e le funzionalità dei modelli.

Pricing

Controlla il pricing prima di chiamare un modello.
Last modified on May 28, 2026