Hopp til hovedinnhold

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.

Bruk CometAPI-dokumentasjonen for videomodeller ved å velge leverandørflyten som passer jobbt typen din. De fleste videopunkter oppretter asynkrone oppgaver, så lagre oppgave-ID-en og bruk polling for å hente resultater. Legg bare til callbacks når siden for den aktuelle modellen beskriver støtte for callbacks.

​
Velg et video-API

Opprett Sora-video

Opprett Sora-videojobber.

Hent Sora-video

Spørr Sora-videojobber.

Runway bilde til video

Generer Runway-videoer fra bilder.

Kling tekst til video

Generer Kling-videoer fra tekstprompter.

Seedance opprettelse

Opprett Seedance-videotilfeller.

xAI videogenerering

Generer xAI-videojobber.

​
Opprett og poll en videooppgave

Bruk en model ID som støtter video fra Models-siden eller model directory. Eksemplene nedenfor oppretter en videooppgave med POST /v1/videos, og poller deretter den returnerte oppgave-ID-en til oppgaven når en terminal tilstand.
Disse eksemplene bruker plassholderen your-video-model-id. Erstatt den med en tilgjengelig model ID for video fra Models-siden eller model directory før du kjører forespørselen.
Åpne Create og Query for å bruke API-sandkassene og endepunktskjemaene.
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)

​
Eksempel på svar

Et vellykket create-svar kan se slik ut. Lagre oppgave-ID-en før du poller: 
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
Et vellykket poll-svar kan se slik ut. Fullførte svar kan inkludere video_url; enkelte leverandørformater bruker modellspesifikke resultatfelt eller innholdsruten for video når den ruten er dokumentert: 
{
  "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"
}

​
Eksempel på modellposter

Denne eksempelresponsen fra modellkatalogen viser /api/models-innpakningen og én struktur for en videomodellpost. Dette er ikke en fullstendig modellliste.
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
      }
    }
  ]
}

​
Vanlige feil

Lagre ID-en fra create-svaret før du returnerer fra jobbhåndtereren din.
Legg inn forsinkelse og backoff mellom statuskontroller.
Bruk varighets- og oppløsningsfeltene som er dokumentert for det valgte videopunktet.
Behandle video_url som valgfritt og fall tilbake til modellspesifikke resultatfelt eller innholdsruten når det er tilgjengelig.
Bruk polling som sannhetskilde og verifiser at callback-URL-en din godtar POST-forespørsler.

​
Feilkoder og retry-strategi

Ikke retry før prompt-, fil-, varighets- eller størrelsesfeltene er rettet.
Ikke retry før API-nøkkelen er til stede og gyldig.
Kontroller oppgave-ID, base URL, path og model ID før du retryer.
Reduser opplastingsstørrelsen før du retryer.
Retry med eksponentiell backoff og reduser samtidighet for opprettelse eller polling.
Retry opprettelse av oppgave med backoff; fortsett å poll eksisterende oppgaver med mindre oppgaven når en terminal feil.
For implementeringsmønstre, se Error codes and retry strategy, Rate limits and concurrency, og Webhook and polling for video generation.

​
Pris og model directory

Models-siden

Les hvordan CometAPI eksponerer model IDs i dokumentasjonen.

Model directory

Bla gjennom tilgjengelighet og kapabiliteter for modeller.

Pris

Sjekk prisene før du kaller en modell.
Last modified on May 28, 2026