à partir de 3 crédits par appel
API de génération d'images par IA
Générez des images à partir d'un prompt de texte avec une seule requête JSON. Jusqu'à quatre échantillons par appel, trois modèles pour arbitrer entre vitesse et qualité, et des droits commerciaux complets sur le résultat.
- REST · JSON
- Sans filigrane
- Rien n'est stocké
POST /v1/generate-image
Qu'est-ce que l'API de génération d'images par IA ?
L'API de génération d'images ImgGen AI est un endpoint REST qui transforme un prompt de texte en images. Vous envoyez un corps JSON avec le prompt, le nombre d'échantillons souhaité, un format et le modèle à utiliser ; l'endpoint renvoie les images générées encodées en base64 dans un tableau. C'est le seul endpoint qui reçoit du JSON plutôt qu'un fichier.
C'est l'un des sept endpoints de l'API d'édition d'images ImgGen AI, qui partagent tous une seule clé d'API, une seule URL de base et le même format de requête et de réponse. Si vous avez aussi besoin de cette fonction dans un navigateur plutôt que depuis du code, le même modèle d'IA anime l'outil AI Image Generator.
Paramètres de la requête
Envoyez une requête POST vers https://app.imggen.ai/v1/generate-image, authentifiée avec une clé d'API dans l'en-tête Authorization.
| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
| prompt | string | OBLIGATOIRE | — | Description textuelle de l'image à générer. |
| samples | number | facultatif | 1 | Nombre d'images à générer, de 1 à 4. |
| aspect_ratio | string | facultatif | square | Format de sortie. Accepte square, portrait ou landscape. |
| model | string | facultatif | imggen-base | Modèle de génération. Accepte imggen-base, imggen-base-fast ou imggen-xl. |
Comment intégrer l'API de génération d'images par IA ?
Créez une clé d'API dans votre compte ImgGen, enregistrez-la comme variable d'environnement et appelez l'endpoint. Voici la même requête en cURL, Node.js et Python.
curl --request POST \
--url 'https://app.imggen.ai/v1/generate-image' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "close up photo of a rabbit in a wildflower meadow",
"samples": 1,
"aspect_ratio": "square",
"model": "imggen-base"
}'import fs from 'node:fs';
const res = await fetch('https://app.imggen.ai/v1/generate-image', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.IMGGEN_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
prompt: 'close up photo of a rabbit in a wildflower meadow',
samples: 1,
aspect_ratio: 'square',
model: 'imggen-base',
}),
});
const data = await res.json();
data.images.forEach((img, i) =>
fs.writeFileSync(`image-${i}.png`, Buffer.from(img, 'base64')),
);import base64, os, requests
res = requests.post(
"https://app.imggen.ai/v1/generate-image",
headers={
"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}",
"Content-Type": "application/json",
},
json={
"prompt": "close up photo of a rabbit in a wildflower meadow",
"samples": 1,
"aspect_ratio": "square",
"model": "imggen-base",
},
)
for i, img in enumerate(res.json()["images"]):
with open(f"image-{i}.png", "wb") as out:
out.write(base64.b64decode(img))Réponse
Un appel réussi renvoie du JSON. Le résultat est encodé en base64 — décodez-le avant de l'écrire sur disque ou dans votre stockage objet. Chaque réponse réussie porte aussi un en-tête X-Credit-Remaining avec votre solde après l'appel.
{
"success": true,
"message": "Images generated successfully",
"images": ["iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="]
}Limites et comportements à connaître
L'endpoint accepte JPEG (JPG), PNG et WebP avec une taille de fichier maximale de 25 Mo, et répond de façon synchrone en moins de 60 secondes : aucun job à interroger, aucun webhook à configurer.
Renvoie un tableau images
Contrairement aux endpoints d'édition, qui renvoient un unique champ image, la génération renvoie images — un tableau avec une entrée par échantillon demandé.
Trois modèles
imggen-base est l'équilibre par défaut, imggen-base-fast troque du détail contre de la vitesse, et imggen-xl vise la meilleure qualité. Le choix se fait par requête, pas par compte.
JSON, pas multipart
C'est le seul endpoint qui reçoit un corps JSON. Envoyez Content-Type: application/json plutôt qu'un formulaire multipart.
À quoi sert l'API de génération d'images par IA ?
Là où les équipes mettent cet endpoint en production pour traiter des images par programmation, à grande échelle.
Visuels éditoriaux et de blog
Générez une image d'en-tête originale pour chaque article à partir du titre, plutôt que de puiser dans une banque d'images que tout le monde utilise.
Conception produit et campagnes
Produisez quatre variantes d'une idée visuelle en un seul appel pour qu'une équipe choisisse une direction avant de commander le vrai travail.
Fonctions créatives dans l'application
Laissez vos utilisateurs générer des images dans votre produit sans que vous ayez à monter une infrastructure GPU.
Contenu de remplissage et maquettes
Remplissez démos, prototypes et environnements de test avec des visuels crédibles générés à la demande.
Combien coûte l'API de génération d'images par IA ?
Chaque appel réussi coûte à partir de 3 crédits : votre coût réel par image dépend donc du forfait que vous avez. Les crédits proviennent de votre forfait et sont partagés entre tous les endpoints et l'éditeur web, vous n'achetez donc pas un quota séparé par outil. Un appel qui échoue est remboursé automatiquement. Voir tous les détails sur la page tarifs.
| Forfait | Prix | Crédits | API |
|---|---|---|---|
| Free | $0 | 50 crédits gratuits en une fois | Pas d'accès à l'API |
| Starter | $9.99 / month | 400 crédits / mois | Accès à l'API inclus |
| Pro | $29.99 / month | 1 400 crédits / mois | Accès à l'API + support prioritaire |
| Enterprise | Custom | Volume sur mesure | Infrastructure dédiée |
Coûts en crédits et limites vérifiés pour la dernière fois le 2026-08-27.
Endpoints et outils associés
Les équipes qui utilisent l'API de génération d'images par IA se tournent ensuite généralement vers ceux-ci.
Également disponibles : Suppression de filigrane, Suppression de texte, Restauration de photos, Colorisation de photos.
FAQ sur l'API de génération d'images par IA
- C'est un endpoint HTTP qui transforme une description écrite en image. Vous envoyez un prompt en JSON et le service renvoie les images générées dans la réponse, ce qui permet à un produit de proposer du texte vers image sans faire tourner sa propre infrastructure de modèles.
- Entre une et quatre, via le paramètre samples. Toutes les images demandées reviennent dans un unique tableau images au sein de la même réponse.
- Trois : imggen-base est le modèle par défaut et équilibre qualité et vitesse, imggen-base-fast renvoie des résultats plus vite avec moins de détail, et imggen-xl vise la meilleure qualité. Vous choisissez par requête via le paramètre model.
- square, portrait et landscape, via le paramètre aspect_ratio. Si vous l'omettez, la valeur par défaut est square.
- La génération est facturée par modèle plutôt qu'à un tarif fixe, car les modèles diffèrent nettement en calcul. Elle démarre à 3 crédits par image sur le modèle par défaut et augmente pour les modèles de meilleure qualité. Votre solde restant revient dans l'en-tête X-Credit-Remaining de chaque appel réussi, et le coût actuel de chaque modèle s'affiche dans votre compte ImgGen.
- À vous. ImgGen ne revendique la propriété de rien de ce que l'API renvoie, et tous les forfaits comportent des droits d'usage commercial complets, sans filigrane. Gardez à l'esprit que le droit d'auteur sur les images générées par IA est traité différemment selon les juridictions : si la propriété est juridiquement déterminante dans votre cas, vérifiez la situation locale.
- Oui. Tous les forfaits, y compris le forfait gratuit, incluent des droits d'usage commercial complets, et aucun résultat ne porte de filigrane. Vous pouvez vendre, imprimer ou publier tout ce que l'API renvoie.
- Les images générées sont renvoyées dans la réponse et ne sont pas conservées. Comme pour tous les endpoints ImgGen, la seule chose gardée est un journal d'utilisation indiquant qu'un appel a eu lieu et ce qu'il a coûté. Votre contenu ne sert pas à entraîner des modèles.
Commencer
Commencez à appeler l'API de génération d'images par IA
Une seule clé débloque les sept endpoints. Sans filigrane, avec des droits commerciaux complets, et rien de ce que vous envoyez n'est conservé une fois la réponse renvoyée.
Obtenir votre clé d'API