Génération d'images

Générez et modifiez des images à partir d'invites textuelles avec tous les modèles d'image pris en charge.

POST/v1/images/generations

Générez des images à partir d'invites textuelles avec tous les modèles d'image pris en charge — GPT Image, Nano Banana, FLUX.2, Seedream et bien d'autres. Le même point d'accès gère également la modification d'images lorsque vous passez des images de référence (aliasé en POST /v1/images/edits).

Familles de modèles

FamilleIDs de modèleParamètre de tarification
GPT Imagegpt-image-1-mini, gpt-image-1, gpt-image-1.5, gpt-image-2quality : low, medium ou high — omis, high est facturé
Nano Banananano-banana-flash-lite, nano-banana, nano-banana-2, nano-banana-proresolution : 0.5K, 1K, 2K ou 4K (disponibilité selon le modèle)
FLUX.2flux-2-pro, flux-2-flexTarif unique par image ; aspect_ratio et resolution sont transmis
Seedreamseedream-4.5, seedream-5-lite, seedream-5-proTarif unique par image ; aspect_ratio et resolution sont transmis

La page de chaque modèle affiche son prix actuel en crédits par image, et l'en-tête X-Credits-Used de la réponse indique le coût réel de l'appel. Un size non carré (par ex. 1536x1024) est facturé 1,5× le prix carré sur tous les modèles sauf gpt-image-2 et la famille Nano Banana, qui tarifent selon resolution. Passer aspect_ratio plutôt que size n'entraîne aucun supplément.

Corps de requête commun

Les champs ci-dessous sont partagés par tous les modèles d'image. Les options propres à chaque modèle — size, aspect_ratio, resolution, quality, output_format, negative_prompt, seed, background, etc. — dépendent de la famille. Ouvrez le modèle sur Modèles et basculez vers l'onglet API pour la référence complète des paramètres.

ParamètreTypeRequisDescription
modelstringOuiN'importe quel ID de modèle d'image — par ex. nano-banana-pro, gpt-image-1, flux-2-pro, seedream-4.5.
promptstringOuiDescription textuelle de l'image à générer.
nintegerNonNombre d'images (1–4). Par défaut : 1. Les modèles Nano Banana renvoient une image par appel : n y est ramené à 1.
response_formatstringNonb64_json (par défaut — base64 dans la réponse) ou url (URL hébergée). La prise en charge varie selon le modèle.
imagesstring[]NonImages de référence encodées en base64 pour la modification. Le nombre maximal accepté dépend du modèle (par ex. 14 pour Nano Banana, 16 pour GPT Image).
userstringNonIdentifiant facultatif de l'utilisateur final pour la surveillance des abus.

Exemple

Remplacez model par n'importe quel ID de modèle d'image — les paramètres au-delà de ceux présentés ci-dessous doivent correspondre à l'onglet API de ce modèle.

import Tchavi from '@tchavi/sdk';

const client = new Tchavi({ apiKey: 'YOUR_API_KEY' });

const result = await client.images.generations.create({
  model: 'YOUR_MODEL_ID',
  prompt: 'Un perroquet coloré sur une branche, art numérique',
});

console.log(result.data[0].b64_json);
console.log('Crédits utilisés :', result.tchavi.credits_used);

La réponse contient les données de l'image encodées en base64 dans data[0].b64_json. Voici comment l'utiliser :

// Afficher l'image dans un navigateur
const img = document.createElement('img');
img.src = `data:image/png;base64,${data.data[0].b64_json}`;
document.body.appendChild(img);

Sur cette page