Crea una generazione
Una richiesta contiene modello, prompt e solo i parametri dell'artefatto applicabili: dimensione, proporzioni, formato o numero di risultati.
Non usare un modello di testo come identificatore di un modello di immagini: seleziona il modello dalla modalità indicata nel catalogo.
Richiesta di generazione di immagini
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
}'Riferimenti e modifica
- Invia le immagini di riferimento tramite input_references solo nella forma supportata dal modello selezionato.
- La trasformazione da immagine a immagine e la modifica usano lo stesso percorso /images con il riferimento sorgente e un'istruzione testuale.
- Controlla tipo MIME, dimensione e diritti di un file di input prima di inviarlo.
Ricevi l'artefatto
Nella risposta compatibile, leggi data[].b64_json come byte dell'immagine; media_type può identificare il formato. Conserva i metadati con il prompt e il modello.
Non pubblicare come definitivo un risultato parziale. Con la consegna in streaming, distingui un evento di bozza da un artefatto completato.