cicora.ai
Specyfikacja APIGenerowanie obrazów

Obrazy

Twórz obrazy za pomocą jednej ścieżki i wybieraj parametry spośród możliwości wybranego modelu.

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

Utwórz generowanie

Żądanie zawiera model, prompt i wyłącznie odpowiednie parametry artefaktu: rozmiar, proporcje obrazu, format lub liczbę wyników.

Nie używaj modelu tekstowego jako identyfikatora modelu obrazu: wybierz model zgodnie z jego modalnością w katalogu.

Żądanie generowania obrazu
bash
curl --request POST https://cicora.ai/api/v1/images \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/gemini-2.5-flash-image",
    "prompt": "A precise editorial illustration of a delivery route at dusk",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Materiały referencyjne i edycja

  • Wysyłaj obrazy referencyjne przez input_references wyłącznie w formie obsługiwanej przez wybrany model.
  • Konwersja obrazu na obraz i edycja korzystają z tej samej ścieżki /images, wraz z odwołaniem do obrazu źródłowego i instrukcją tekstową.
  • Przed wysłaniem pliku wejściowego sprawdź jego typ MIME, rozmiar i prawa.

Odbierz artefakt

W zgodnej odpowiedzi odczytaj data[].b64_json jako bajty obrazu; media_type może wskazywać format. Zachowaj metadane wraz z poleceniem i modelem.

Nie publikuj częściowego wyniku jako końcowego. Przy dostarczaniu strumieniowym rozróżniaj zdarzenie wersji roboczej od ukończonego artefaktu.