cicora.ai
API-specifikationAsynkrone medier

Video

Start video som et asynkront job, bevar job-ID'et, og hold oprettelsen adskilt fra læsningen af resultatet.

Integrationsreference: Vælg parametre og tilgængelige funktioner fra API-indstillingerne for kontoen og modelkataloget for dit miljø.

Opret et job

En videoanmodning indeholder normalt prompt, model og billedegenskaber som varighed, sideforhold, opløsning eller referencer, men kun når den valgte model understøtter dem.

Gem job-ID'et med det samme. Det er nødvendigt for at vise fremdrift, understøtte annullering i grænsefladen og hente det endelige indhold.

Job for videogenerering
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"
  }'

Forespørg status

  • Læs et job gennem GET /videos/{video_id}.
  • Brug den endelige status som sandhedskilde for fuldførelse.
  • Brug et stigende interval mellem statuskontrollerne, og stop dem når brugeren forlader siden.

Arbejd med resultatet

Efter fuldførelse bruger du URL'en eller indholdet som jobbet returnerer, og kontrollerer at filen er klar før du viser en afspiller.

Bevar prompt, model, parametre og job-ID til support, men opbevar ikke inputreferencer længere end produktet kræver.