cicora.ai
Specifikace APIAsynchronní média

Video

Spusťte generování videa jako asynchronní úlohu, uchovejte její ID a tvorbu oddělte od načtení výsledku.

Referenční dokumentace integrace: parametry a dostupné možnosti vybírejte v nastavení API svého účtu a v katalogu modelů pro své prostředí.

Vytvoření úlohy

Požadavek na video obvykle obsahuje prompt, model a vlastnosti snímku, jako jsou délka, poměr stran, rozlišení nebo reference, pouze pokud je zvolený model podporuje.

ID úlohy ihned uložte. Je potřeba k zobrazení postupu, podpoře zrušení ve vašem rozhraní a získání konečného obsahu.

Úloha generování 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"
  }'

Zjišťování stavu

  • Úlohu načtěte prostřednictvím GET /videos/{video_id}.
  • Konečný stav považujte za rozhodující zdroj informace o dokončení.
  • Použijte prodlužující se interval dotazování a ukončete jej, když uživatel odejde.

Práce s výsledkem

Po dokončení použijte URL nebo obsah vrácený úlohou a před zobrazením přehrávače ověřte připravenost souboru.

Pro účely podpory uchovávejte prompt, model, parametry a ID úlohy, vstupní reference však neuchovávejte déle, než váš produkt vyžaduje.