Images

Deux points d’accès au format de l’API Images d’OpenAI : POST /v1/images/generations crée des images à partir d’une description, POST /v1/images/edits les crée à partir d’une ou plusieurs images. Les images reviennent dans la réponse, en base64 : Moon AI n’en garde aucune copie et ne fournit pas d’adresse hébergée.

Créer une image#Lien vers la section Créer une image

POST https://api.realmoon.ai/v1/images/generations

• Authentification : clé sk-moon-… avec la portée inference (voir Authentification).
• Corps : JSON, 1 Mo au plus.
• Réponse : un objet image (voir Réponse).

Paramètres#Lien vers la section Paramètres

Les paramètres user, style, moderation, background, output_compression, output_format, partial_images et input_fidelity sont acceptés et sans effet. Tout autre paramètre est refusé avec 400 unknown_parameter. Une image envoyée dans image ou images est refusée ici : utilisez /v1/images/edits.

Exemple#Lien vers la section Exemple

curl https://api.realmoon.ai/v1/images/generations \
  -H "Authorization: Bearer $MOONAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "model": "google/gemini-3.1-flash-image",
        "prompt": "Une affiche rétro d’une fusée au-dessus de Paris",
        "size": "1024x1536"
      }' \
  | jq -r '.data[0].b64_json' | base64 --decode > affiche.png

import base64
import os
from openai import OpenAI

client = OpenAI(base_url="https://api.realmoon.ai/v1", api_key=os.environ["MOONAI_API_KEY"])

img = client.images.generate(
    model="google/gemini-3.1-flash-image",
    prompt="Une affiche rétro d’une fusée au-dessus de Paris",
    size="1024x1536",
    # Paramètre propre à Moon AI : passé par extra_body.
    extra_body={"image_size": "2K"},
)
with open("affiche.png", "wb") as f:
    f.write(base64.b64decode(img.data[0].b64_json))

import fs from 'node:fs';
import OpenAI from 'openai';

const client = new OpenAI({ baseURL: 'https://api.realmoon.ai/v1', apiKey: process.env.MOONAI_API_KEY });

const img = await client.images.generate({
  model: 'google/gemini-3.1-flash-image',
  prompt: 'Une affiche rétro d’une fusée au-dessus de Paris',
  size: '1024x1536',
  // Paramètre propre à Moon AI, envoyé tel quel.
  image_size: '2K',
});
fs.writeFileSync('affiche.png', Buffer.from(img.data[0].b64_json, 'base64'));

Taille et format#Lien vers la section Taille et format

Quand vous donnez size sans aspect_ratio ni image_size :

• le format retenu est celui du modèle le plus proche du rapport largeur sur hauteur ;
• la taille retenue est 1K si le plus grand côté fait au plus 1 100 pixels, 2K jusqu’à 2 200 pixels, 4K au-delà (ou la plus grande taille du modèle).

L’image produite peut donc avoir des dimensions un peu différentes de size. Sans size, aspect_ratio ni image_size, le modèle choisit.

Retoucher une image#Lien vers la section Retoucher une image

POST https://api.realmoon.ai/v1/images/edits

• Authentification : clé sk-moon-… avec la portée inference.
• Corps : multipart/form-data (avec l’en-tête Content-Length) ou JSON, 90 Mo au plus.
• Réponse : un objet image (voir Réponse).

Paramètres#Lien vers la section Paramètres

Tous les paramètres de la création s’appliquent, plus les images :

Une image donnée par une adresse https:// est lue par le fournisseur du modèle, jamais par Moon AI.

Exemple#Lien vers la section Exemple

curl https://api.realmoon.ai/v1/images/edits \
  -H "Authorization: Bearer $MOONAI_API_KEY" \
  -F model=google/gemini-3.1-flash-image \
  -F prompt="Même photo, en noir et blanc" \
  -F image=@photo.png

edit = client.images.edit(
    model="google/gemini-3.1-flash-image",
    image=open("photo.png", "rb"),
    prompt="Même photo, en noir et blanc",
)
with open("photo-nb.png", "wb") as f:
    f.write(base64.b64decode(edit.data[0].b64_json))

# Plusieurs images : une liste.
combo = client.images.edit(
    model="google/gemini-3.1-flash-image",
    image=[open("produit.png", "rb"), open("decor.png", "rb")],
    prompt="Le produit de la première image posé dans le décor de la seconde",
)

const edit = await client.images.edit({
  model: 'google/gemini-3.1-flash-image',
  image: fs.createReadStream('photo.png'),
  prompt: 'Même photo, en noir et blanc',
});
fs.writeFileSync('photo-nb.png', Buffer.from(edit.data[0].b64_json, 'base64'));

Le même appel en JSON, avec une image en base64 et une image à une adresse :

{
  "model": "google/gemini-3.1-flash-image",
  "prompt": "Le produit de la première image posé dans le décor de la seconde",
  "images": [
    { "image_url": "data:image/png;base64,iVBORw0KGgo…" },
    { "image_url": "https://example.com/decor.jpg" }
  ]
}

Réponse#Lien vers la section Réponse

Les deux points d’accès renvoient le même objet.

{
  "created": 1793577600,
  "model": "google/gemini-3.1-flash-image",
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA…", "output_format": "png" }
  ],
  "usage": { "images": 1, "credits": 650 }
}

Quand vous demandez plusieurs images et que certaines échouent, la réponse ne contient que celles qui ont été produites : comparez usage.images à n.

En-têtes : X-Moon-Request-Id, X-Moon-Prompt-Storage: none, X-Moon-Blur: not_applied (Moon Blur ne s’applique pas aux images ni à leur description) et Cache-Control: no-store.

Modèles#Lien vers la section Modèles

Liste au 5 novembre 2026 ; la liste à jour, avec les prix, vient de GET /v1/models?type=image.

image_size n’est accepté que par les modèles à plusieurs tailles.

Coûts#Lien vers la section Coûts

• Avant l’appel, la requête retient le plus qu’elle peut coûter : max_credits_per_unit (ou celui de la taille demandée) fois le nombre d’images, plus les images envoyées.
• Après, vous payez le coût réel annoncé par le fournisseur (à défaut, le prix de la liste), et le reste de la retenue est rendu aussitôt.
• Une requête qui échoue, refusée avant toute création, ou coupée par notre délai, ne coûte rien.
• Un modèle qui répond par du texte au lieu d’une image (refus de sécurité, consigne mal comprise) facture le texte qu’il a écrit, et l’API répond 400 content_policy_violation : reformulez la consigne.

Voir Coûts et porte-monnaie pour la réserve et le règlement.

Limites#Lien vers la section Limites

• Toutes les images d’une requête sont faites en même temps ; la requête répond en 90 secondes environ au plus.
• Au plus 8 requêtes d’images en cours à la fois par workspace (au-delà : 429 too_many_concurrent, Retry-After: 5).

Erreurs#Lien vers la section Erreurs

Les erreurs de clé, de solde et de plafonds sont dans Erreurs.

Voir aussi#Lien vers la section Voir aussi

• Modèles : les champs aspect_ratios, image_sizes et max_input_images.
• Solde et coût d’une requête : relire le coût avec X-Moon-Request-Id.