cicora.ai
API-specifikationBilledgenerering

Billeder

Opret billeder gennem én rute, og vælg parametre ud fra den valgte models funktioner.

Integrationsreference: Vælg parametre og tilgængelige funktioner fra API-indstillingerne for kontoen og modelkataloget for dit miljø.

Opret en generering

En anmodning indeholder model, prompt og kun relevante artefaktparametre: størrelse, sideforhold, format eller antal resultater.

Brug ikke en tekstmodel som billed-ID: vælg modellen ud fra dens modalitet i kataloget.

Anmodning om billedgenerering
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
  }'

Referencer og redigering

  • Send referencebilleder gennem input_references kun i den form som den valgte model understøtter.
  • Billede-til-billede og redigering bruger den samme /images-rute med kildereferencen og en tekstinstruktion.
  • Kontrollér MIME-type, størrelse og rettigheder for en inputfil før den sendes.

Modtag artefaktet

I det kompatible svar læser du data[].b64_json som billedbytes; media_type kan identificere formatet. Bevar metadata sammen med prompten og modellen.

Offentliggør ikke et delvist resultat som endeligt. Ved streaming skal du skelne mellem en kladdehændelse og et færdigt artefakt.