Texte vers image
Générez des images à partir d’un prompt avec l’API Cheapest Imagen, et choisissez le modèle, la taille, la qualité, le nombre d’images et le format du fichier.
Envoyez un prompt à POST /v1/images/generations. Seuls model et prompt sont obligatoires.
curl https://api.cheapestimagen.com/v1/images/generations \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "a lighthouse at dusk, oil painting",
"n": 2,
"size": "1536x1024",
"quality": "high"
}'Options
| Champ | Rôle | Valeurs |
|---|---|---|
n | Nombre d’images | 1 à 10, 1 par défaut |
size | Largeur et hauteur | auto ou une taille 1K, 2K ou 4K, voir Formats et tailles |
quality | Qualité de rendu, même prix pour toutes | auto, low, medium, high ; xhigh, max sur gpt-image-2.5-sunburst |
background | Fond transparent ou uni | auto, opaque, transparent |
output_format | Format du fichier | png (par défaut), jpeg, webp sur tous les modèles ; gif sur gpt-image-2.6 et ses variantes flare et sunburst ; svg sur gpt-image-2.6 |
output_compression | Qualité pour jpeg et webp | 0 à 100, 100 par défaut |
moderation | Rigueur des contrôles de contenu | auto, low |
response_format | Données de l’image ou lien | b64_json (par défaut), url |
Aucun modèle ne produit de fond transparent pour le moment : OpenAI a retiré son aperçu de la transparence pour les modèles GPT Image, qui renvoient désormais un fond uni. Une requête avec background: transparent renvoie une erreur 400 avec le code unsupported_parameter. Pour obtenir un détourage, demandez dans le prompt un fond uni d’une seule couleur et retirez-le ensuite.
Formats de sortie
PNG, JPEG et WebP fonctionnent sur tous les modèles, comme sur l’API d’OpenAI. La plupart des modèles produisent un PNG, que nous convertissons dans le JPEG ou le WebP demandé au sein du réseau de Cloudflare (environ 0,1 à 0,4 seconde ; un PNG de 2 Mo devient un JPEG ou un WebP d’environ 250 Ko). gpt-image-2.6-flare et gpt-image-2.6-sunburst produisent eux-mêmes du JPEG et du WebP.
| Modèle | PNG | JPEG | WebP | GIF | SVG |
|---|---|---|---|---|---|
gpt-image-2, gpt-image-2.5, gpt-image-2-adobe | Oui | Oui | Oui | – | – |
gpt-image-2.6 | Oui | Oui | Oui | Oui | Oui |
gpt-image-2.5-flare, gpt-image-2.5-sunburst | Oui | Oui | Oui | – | – |
gpt-image-2.6-flare, gpt-image-2.6-sunburst | Oui | Oui | Oui | Oui | – |
| Nano Banana (toutes les versions) | Oui | Oui | Oui | – | – |
« – » renvoie une erreur 400. output_compression règle la qualité du JPEG ou du WebP sur tous les modèles (100 par défaut). Un GIF peut prendre de trois à cinq minutes. Le vrai type du fichier figure dans l’extension du lien et dans son Content-Type.
Combien de crédits utilise une requête
Une requête utilise n fois les crédits du modèle : 8 par image pour GPT Image 2, 2.5 et 2.6, 12 pour Nano Banana 2 et 2.1, 20 pour Nano Banana Pro, gpt-image-2-adobe et les variantes flare, 25 pour les variantes sunburst, 60 à 180 pour les canaux stables Nano Banana. Si moins d’images reviennent que demandé, vous ne payez que les images reçues.
Envoyer deux fois la même requête
Ajoutez un en-tête Idempotency-Key avec une valeur de votre choix. Si la même clé arrive de nouveau pendant que la première requête s’exécute ou après son succès, l’API répond 409 et ne génère ni ne facture une seconde fois. Après une requête échouée, vous pouvez réutiliser la clé.
Démarrage rapide
Créez votre première image IA avec l’API Cheapest Imagen en trois étapes : créer une clé, envoyer une requête et lire l’image dans la réponse.
Modèles
Tous les identifiants de modèle de l’API Cheapest Imagen, avec le modèle officiel OpenAI ou Google qu’ils exécutent, les résolutions et leur prix en crédits par image.