cicora.ai
Specyfikacja APIAsynchroniczne multimedia

Wideo

Uruchamiaj tworzenie filmu jako zadanie asynchroniczne, zachowuj jego identyfikator i oddzielaj tworzenie od odczytu wyniku.

Materiały dotyczące integracji: wybierz parametry i dostępne funkcje w ustawieniach API konta oraz w katalogu modeli dla swojego środowiska.

Utwórz zadanie

Żądanie filmu zwykle zawiera prompt, model i właściwości klatki, takie jak czas trwania, proporcje obrazu, rozdzielczość lub materiały referencyjne, wyłącznie gdy obsługuje je wybrany model.

Natychmiast zapisz identyfikator zadania. Jest potrzebny do pokazywania postępu, obsługi anulowania w interfejsie i pobrania końcowej treści.

Zadanie generowania filmu
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"
  }'

Sprawdzaj status

  • Odczytaj zadanie przez GET /videos/{video_id}.
  • Traktuj status końcowy jako źródło prawdy o ukończeniu.
  • Stosuj rosnący odstęp między sprawdzeniami i zatrzymuj je, gdy użytkownik opuści stronę.

Pracuj z wynikiem

Po zakończeniu użyj adresu URL lub treści zwróconej przez zadanie i sprawdź gotowość pliku przed wyświetleniem odtwarzacza.

Zachowuj prompt, model, parametry i identyfikator zadania na potrzeby pomocy technicznej, ale nie przechowuj wejściowych materiałów referencyjnych dłużej, niż wymaga tego produkt.