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.
L’API utilise les mêmes requêtes et les mêmes réponses que l’API OpenAI Images. Si vous appelez déjà OpenAI, changez l’URL de base et la clé, et gardez le reste de votre code.
1. Obtenir une clé API
Connectez-vous et créez une clé sur la page Clés API. Un nouveau compte reçoit 5 images gratuites, utilisables aussi par l’API : GPT Image 2, 2.5 ou 2.6 en 1K, une image par requête. Pour tout le reste, rechargez d’abord votre compte. Une clé commence par sk-cheap- et n’est affichée qu’une fois, copiez-la donc au moment de sa création.
2. Envoyer une requête
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 red fox in the snow",
"size": "1536x1024"
}'from openai import OpenAI
client = OpenAI(
base_url="https://api.cheapestimagen.com/v1",
api_key="YOUR_KEY",
)
result = client.images.generate(
model="gpt-image-2",
prompt="a red fox in the snow",
size="1536x1024",
)import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.cheapestimagen.com/v1',
apiKey: process.env.YOUR_KEY,
});
const result = await client.images.generate({
model: 'gpt-image-2',
prompt: 'a red fox in the snow',
size: '1536x1024',
});3. Lire l’image
La réponse contient une entrée par image. Par défaut, chaque entrée porte l’image en base64 dans b64_json :
{
"created": 1794660236,
"data": [{ "b64_json": "iVBORw0KGgo..." }]
}Envoyez "response_format": "url" pour obtenir un lien à la place. Les images liées sont conservées 72 heures.
Synchrone ou asynchrone
La requête ci-dessus est synchrone : elle répond quand l’image est prête. Si une requête est longue, ou si vous en envoyez beaucoup à la fois, passez en asynchrone : ajoutez "async": true pour obtenir tout de suite un identifiant de tâche, puis interrogez la tâche, ou ajoutez webhook_url et nous vous appelons à la fin. Les deux méthodes coûtent le même prix. L’interrogation, la lecture de plusieurs tâches en un appel et les webhooks sont décrits dans Requêtes synchrones et asynchrones.
Combien ça coûte
GPT Image 2, 2.5 et 2.6 coûtent 8 crédits par image ; Nano Banana 2 et 2.1 coûtent 12 ; Nano Banana Pro, gpt-image-2-adobe et les variantes flare 20 ; les variantes sunburst 25 ; les canaux stables Nano Banana (-1k, -2k, -4k) de 60 à 180. La taille et la qualité ne changent pas le prix (un crédit vaut de 0,001 $ à environ 0,0018 $, voir /fr/pricing). Une requête échouée ne coûte rien : les crédits sont réservés au début de la requête et rendus pour chaque image non livrée. Une seule exception : les canaux stables Nano Banana (-1k, -2k, -4k) facturent les images refusées pour leur contenu.