cicora.ai
API-specificatieAsynchrone media

Video

Start video als asynchrone taak, bewaar de taak-ID en houd het maken gescheiden van het lezen van het resultaat.

Integratiereferentie: kies parameters en beschikbare mogelijkheden uit de API-instellingen van uw account en de modelcatalogus voor uw omgeving.

Een taak maken

Een videoaanvraag bevat doorgaans prompt, model en frame-eigenschappen zoals duur, beeldverhouding, resolutie of referenties, maar alleen wanneer het gekozen model ze ondersteunt.

Sla de taak-ID onmiddellijk op. Deze is nodig om voortgang te tonen, annulering in uw interface te ondersteunen en de uiteindelijke inhoud op te halen.

Taak voor videogeneratie
bash
curl --request POST https://cicora.ai/api/v1/videos \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/veo-3.1",
    "prompt": "Slow aerial movement above a river at sunrise",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

Status opvragen

  • Lees een taak via GET /videos/{video_id}.
  • Beschouw de eindstatus als de bron van waarheid voor voltooiing.
  • Gebruik een oplopend opvraaginterval en stop dit wanneer de gebruiker vertrekt.

Met het resultaat werken

Gebruik na voltooiing de URL of inhoud die de taak retourneert en controleer of het bestand gereed is voordat u een speler toont.

Bewaar prompt, model, parameters en taak-ID voor ondersteuning, maar bewaar invoerreferenties niet langer dan uw product vereist.