cicora.ai
API specifikacijaAsinchroninė medija

Vaizdo įrašas

Vaizdo įrašo kūrimą pradėkite kaip asinchroninę užduotį, išsaugokite jos identifikatorių ir atskirkite kūrimą nuo rezultato skaitymo.

Integracijų žinynas: savo paskyros API nustatymuose ir jūsų aplinkos modelių kataloge pasirinkite parametrus bei galimas funkcijas.

Sukurkite užduotį

Vaizdo įrašo užklausoje paprastai būna raginimas, modelis ir kadrų savybės, tokios kaip trukmė, kraštinių santykis, skiriamoji geba ar etalonai, tik kai pasirinktas modelis jas palaiko.

Nedelsdami išsaugokite užduoties identifikatorių. Jo reikia pažangai rodyti, atšaukimui sąsajoje ir galutiniam turiniui gauti.

Vaizdo įrašo generavimo užduotis
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"
  }'

Tikrinkite būseną

  • Skaitykite užduotį per GET /videos/{video_id}.
  • Galutinę būseną laikykite patikimu šaltiniu, rodančiu, ar užduotis užbaigta.
  • Naudokite ilgėjantį tikrinimo intervalą ir sustabdykite tikrinimą, kai naudotojas išeina.

Darbas su rezultatu

Kai užduotis užbaigta, naudokite jos grąžintą URL arba turinį ir prieš rodydami leistuvą patikrinkite, ar failas parengtas.

Pagalbai teikti išsaugokite raginimą, modelį, parametrus ir užduoties identifikatorių, bet įvesties etalonų nelaikykite ilgiau, nei reikalauja jūsų produktas.