cicora.ai
API-specifikációKépgenerálás

Képek

Képeket egy útvonalon hozzon létre, a paramétereket pedig a kiválasztott modell képességeiből válassza ki.

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.

Generálás létrehozása

A kérés a model és a prompt mezőt, valamint csak az alkalmazható műtermék-paramétereket tartalmazza: méret, képarány, formátum vagy eredményszám.

Ne használjon szövegmodellt képmodell-azonosítóként: a modellt a katalógus modalitása alapján válassza ki.

Képgenerálási kérés
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
  }'

Referenciák és szerkesztés

  • A referenciaképeket csak a kiválasztott modell által támogatott formában küldje az input_references mezőn keresztül.
  • A képből kép létrehozása és a szerkesztés ugyanazt a /images útvonalat használja a forráshivatkozással és egy szöveges utasítással.
  • Küldés előtt ellenőrizze a bemeneti fájl MIME-típusát, méretét és jogait.

A műtermék fogadása

A kompatibilis válaszban a data[].b64_json értéket képbájtokként olvassa; a media_type azonosíthatja a formátumot. A metaadatokat őrizze meg az utasítással és a modellel.

Részleges eredményt ne tegyen közzé véglegesként. Streamelt kézbesítésnél különböztesse meg a vázlateseményt a befejezett műterméktől.