cicora.ai
Špecifikácia APIGenerovanie obrázkov

Obrázky

Obrázky vytvárajte prostredníctvom jednej trasy a parametre vyberajte z možností zvoleného modelu.

Referenčná dokumentácia integrácie: parametre a dostupné funkcie vyberte z nastavení API účtu a katalógu modelov pre svoje prostredie.

Vytvorte generovanie

Požiadavka obsahuje model, prompt a iba príslušné parametre artefaktu: veľkosť, pomer strán, formát alebo počet výsledkov.

Textový model nepoužívajte ako identifikátor obrazového modelu: model vyberte podľa jeho modality v katalógu.

Požiadavka na generovanie obrázka
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
  }'

Referencie a úpravy

  • Referenčné obrázky posielajte cez input_references iba vo forme podporovanej vybraným modelom.
  • Prevod obrázka na obrázok a úpravy používajú rovnakú trasu /images so zdrojovou referenciou a textovým pokynom.
  • Pred odoslaním vstupného súboru skontrolujte typ MIME, veľkosť a práva.

Prijmite artefakt

V kompatibilnej odpovedi čítajte data[].b64_json ako bajty obrázka; media_type môže určiť formát. Metadáta uchovajte spolu s promptom a modelom obrázka.

Čiastočný výsledok nezverejňujte ako konečný. Pri streamovanom doručení rozlišujte udalosť konceptu od dokončeného artefaktu.