cicora.ai
API-specifikációAszinkron média

Videó

A videót aszinkron feladatként indítsa, őrizze meg a feladatazonosítóját, és a létrehozást válassza külön az eredmény beolvasásától.

Integrációs referencia: válassza ki a paramétereket és az elérhető képességeket a fiókja API-beállításaiból és a környezetéhez tartozó modellkatalógusból.

Feladat létrehozása

A videókérés általában a prompt és a model mezőt, valamint képkocka-tulajdonságokat tartalmaz, például időtartamot, képarányt, felbontást vagy referenciákat, ez utóbbiakat azonban csak akkor, ha a választott modell támogatja őket.

Azonnal mentse el a feladatazonosítót. Erre van szükség az előrehaladás megjelenítéséhez, a megszakítás felületi támogatásához és a végleges tartalom lekéréséhez.

Videógenerálási feladat
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"
  }'

Állapot lekérdezése

  • A feladatot a GET /videos/{video_id} útvonalon olvassa be.
  • A befejezés hiteles forrása a végállapot legyen.
  • Használjon növekvő lekérdezési időközt, és állítsa le, amikor a felhasználó távozik.

Munka az eredménnyel

Befejezés után használja a feladat által visszaadott URL-t vagy tartalmat, és lejátszó megjelenítése előtt ellenőrizze a fájl készenlétét.

Támogatási célból őrizze meg az utasítást, modellt, paramétereket és feladatazonosítót, de a bemeneti referenciákat ne tartsa meg tovább, mint amit a termék igényel.