cicora.ai
Špecifikácia APIAsynchrónne médiá

Video

Spustite generovanie videa ako asynchrónnu úlohu, uchovajte jej ID a oddeľte vytvorenie od čítania výsledku.

Referenčná dokumentácia integrácie: parametre a dostupné funkcie vyberte z nastavení API účtu a katalógu modelov pre svoje prostredie.

Vytvorte úlohu

Požiadavka na video zvyčajne obsahuje prompt, model a vlastnosti snímky, ako sú dĺžka, pomer strán, rozlíšenie alebo referencie, iba keď ich vybraný model podporuje.

ID úlohy okamžite uložte. Je potrebné na zobrazenie priebehu, podporu zrušenia vo vašom rozhraní a získanie konečného obsahu.

Úloha generovania videa
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"
  }'

Kontrolujte stav

  • Úlohu načítajte prostredníctvom GET /videos/{video_id}.
  • Konečný stav považujte za zdroj pravdy o dokončení.
  • Používajte rastúci interval kontroly a zastavte ju, keď používateľ odíde.

Pracujte s výsledkom

Po dokončení použite URL alebo obsah vrátený úlohou a pred zobrazením prehrávača overte pripravenosť súboru.

Na účely podpory uchovajte prompt, model, parametre a ID úlohy, ale vstupné referencie neuchovávajte dlhšie, než váš produkt vyžaduje.