Naar hoofdinhoud gaan

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.

Gebruik de documentatie voor CometAPI-videomodellen door de provider-workflow te kiezen die past bij je taaktype. De meeste video-endpoints maken asynchrone taken aan, dus sla de taak-ID op en gebruik polling om resultaten op te halen. Voeg alleen callbacks toe wanneer de model-specifieke pagina callback-ondersteuning documenteert.

Kies een video-API

Sora video maken

Maak Sora-videotaken aan.

Sora video ophalen

Vraag Sora-videotaken op.

Runway image to video

Genereer Runway-video’s vanuit afbeeldingen.

Kling text to video

Genereer Kling-video’s vanuit tekstprompts.

Seedance create

Maak Seedance-videotaken aan.

xAI video generation

Genereer xAI-videotaken.

Maak een videotaken aan en poll deze

Gebruik een model-ID dat video ondersteunt van de Models page of de model directory. De onderstaande voorbeelden maken een videotaken aan met POST /v1/videos, en pollen vervolgens de geretourneerde taak-ID totdat de taak een terminale status bereikt.
Deze voorbeelden gebruiken de placeholder your-video-model-id. Vervang deze door een beschikbare video model ID van de Models page of model directory voordat je de aanvraag uitvoert.
Open Create en Query om de API-playgrounds en endpointschema’s te gebruiken.
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)

Antwoordvoorbeelden

Een succesvolle create-respons kan er als volgt uitzien. Sla de taak-ID op voordat je gaat pollen:
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
Een succesvolle polling-respons kan er als volgt uitzien. Voltooide responses kunnen video_url bevatten; sommige providerformaten gebruiken model-specifieke resultvelden of het video content route wanneer dat route is gedocumenteerd:
{
  "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"
}

Voorbeeldmodelrecords

Deze voorbeeldreactie van de modelcatalogus toont de /api/models-envelop en de vorm van één video model record. Dit is geen volledige modellenlijst.
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
      }
    }
  ]
}

Veelvoorkomende fouten

Sla de ID van de create-respons op voordat je terugkeert uit je job-handler.
Voeg vertraging en backoff toe tussen statuscontroles.
Gebruik de duur- en resolutievelden die zijn gedocumenteerd voor het geselecteerde video-endpoint.
Behandel video_url als optioneel en val terug op model-specifieke resultvelden of het content route wanneer beschikbaar.
Gebruik polling als bron van waarheid en controleer of je callback-URL POST-verzoeken accepteert.

Foutcodes en retry-strategie

Probeer niet opnieuw totdat de velden prompt, files, duration of size zijn gecorrigeerd.
Probeer niet opnieuw totdat de API-key aanwezig en geldig is.
Controleer de taak-ID, base URL, path en model ID voordat je het opnieuw probeert.
Verminder de uploadgrootte voordat je het opnieuw probeert.
Probeer opnieuw met exponentiële backoff en verminder de concurrency voor create of polling.
Probeer het aanmaken van de taak opnieuw met backoff; blijf bestaande taken pollen tenzij de taak een terminale fout bereikt.

Prijzen en modeldirectory

Models page

Lees hoe CometAPI model-ID’s in de documentatie beschikbaar maakt.

Model directory

Blader door de beschikbaarheid en mogelijkheden van modellen.

Pricing

Controleer de prijzen voordat je een model aanroept.
Last modified on May 28, 2026