cicora.ai
Français
Spécification de l’APIGénération d’images

Images

Créez des images via une seule route et sélectionnez les paramètres selon les capacités du modèle choisi.

Référence d’intégration : choisissez les paramètres et les capacités disponibles dans les réglages de l’API de votre compte et dans le catalogue de modèles de votre environnement.

Créer une génération

Une requête contient model, prompt et uniquement les paramètres d’artefact applicables : taille, rapport d’aspect, format ou nombre de résultats.

N’utilisez pas un modèle de texte comme identifiant de modèle d’image : sélectionnez le modèle d’après sa modalité dans le catalogue.

Requête de génération d’image
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
  }'

Références et retouche

  • Envoyez les images de référence via input_references uniquement sous la forme prise en charge par le modèle sélectionné.
  • La transformation d’image à image et la retouche utilisent la même route /images, avec la référence source et une instruction textuelle.
  • Vérifiez le type MIME, la taille et les droits d’un fichier d’entrée avant de l’envoyer.

Recevoir l’artefact

Dans la réponse compatible, lisez data[].b64_json comme des octets d’image ; media_type peut indiquer le format. Conservez les métadonnées avec le prompt et le modèle correspondants.

Ne publiez pas un résultat partiel comme résultat final. Lors d’une livraison en continu, distinguez un événement de brouillon d’un artefact terminé.

Continuer avec