Een generatie maken
Een aanvraag bevat model, prompt en alleen toepasselijke artefactparameters: grootte, beeldverhouding, indeling of aantal resultaten.
Gebruik een tekstmodel niet als afbeeldings-ID: selecteer het model op basis van de modaliteit in de catalogus.
Aanvraag voor afbeeldingsgeneratie
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
}'Referenties en bewerking
- Stuur referentieafbeeldingen via input_references, uitsluitend in de vorm die het geselecteerde model ondersteunt.
- Afbeelding-naar-afbeelding en bewerking gebruiken dezelfde /images-route met de bronreferentie en een tekstinstructie.
- Controleer MIME-type, grootte en rechten van een invoerbestand voordat u het verzendt.
Het artefact ontvangen
Lees in het compatibele antwoord data[].b64_json als afbeeldingsbytes; media_type kan de indeling aangeven. Bewaar metadata bij de prompt en het model.
Publiceer een gedeeltelijk resultaat niet als definitief. Maak bij streaminglevering onderscheid tussen een conceptgebeurtenis en een voltooid artefact.