Generierung erstellen
Eine Anfrage enthält Modell, Eingabe und nur zutreffende Artefaktparameter: Größe, Seitenverhältnis, Format oder Ergebnisanzahl.
Verwenden Sie kein Textmodell als Bildkennung: Wählen Sie das Modell anhand seiner Katalogmodalität aus.
Anfrage zur Bilderzeugung
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
}'Referenzen und Bearbeitung
- Senden Sie Referenzbilder über input_references nur in der vom ausgewählten Modell unterstützten Form.
- Bild-zu-Bild-Erzeugung und Bearbeitung verwenden dieselbe /images-Route mit dem Verweis auf die Quelle und einer Textanweisung.
- Prüfen Sie MIME-Typ, Größe und Rechte einer Eingabedatei vor dem Senden.
Artefakt empfangen
Lesen Sie in der kompatiblen Antwort data[].b64_json als Bildbytes; media_type kann das Format bezeichnen. Speichern Sie Metadaten zusammen mit Eingabe und Modell.
Veröffentlichen Sie kein Teilergebnis als endgültig. Unterscheiden Sie bei Streaming-Ausgabe zwischen einem Entwurfsereignis und einem abgeschlossenen Artefakt.