Guide API GPT-Image-2

GPT-Image-2 — API de génération d’images OpenAI

Accédez au dernier model de génération d’images d’OpenAI via l’API unifiée de TokenHub. Entièrement OpenAI-compatible, avec réponse synchrone (aucun polling requis), plusieurs tailles jusqu’à 4K, niveaux de qualité et formats de sortie PNG/JPEG/WebP. Prend en charge la génération texte-vers-image (t2i) et l’édition image-vers-image (i2i, composition multi-images et inpainting avec masque). Ce guide vous accompagne dans l’intégration complète.

Text → ImageImage → Image (i2i)OpenAI-CompatibleSynchronousUp to 4KToken-based

1Obtenez votre API Key

Visitez tokenhub.store pour créer un compte (connexion via GitHub / Google prise en charge)
Allez dans Dashboard → API Keys, puis cliquez sur "Create New Key"
Allez dans Dashboard → Billing pour ajouter des Credits (1 Credit = 1 $ USD)
Copiez votre API Key (format : th-xxxxxxxxxxxx...)

⚠️ L’API Key n’est affichée qu’une seule fois à la création. Conservez-la en lieu sûr. Si vous la perdez, vous devrez en créer une nouvelle.

2Aperçu de l’API

Base URL

https://tokenhub.store/api/v1

Authentification

Toutes les requêtes nécessitent une API Key dans l’en-tête :

Header

Authorization: Bearer th-your-api-key

Endpoints (synchrones, OpenAI-compatible)

POST

/images/generations

Texte-vers-image. Génère des images à partir d’un prompt texte.

POST

/images/edits

Édition image-vers-image. Prend en charge les modifications sur une image, la composition multi-images et l’inpainting optionnel avec un masque.

3Tarification

Niveau	Prix	Plage de résolution
1K	$0.125 / image	Le côté le plus long ≤ 1536 px (ex. 1024×1024, 1024×1536)
2K	$0.250 / image	Le côté le plus long ≤ 2048 px (ex. 2048×2048)
4K	$0.500 / image	Le côté le plus long > 2048 px (par ex. 4096×4096)

Tarification fixe par image selon le niveau de résolution de sortie (déterminé par le côté le plus long de size). n images = prix unitaire × n. Les requêtes échouées ne sont pas facturées.

Correspondance des niveaux selon le côté le plus long : ≤ 1536 px → 1K ($0.125), ≤ 2048 px → 2K ($0.250), > 2048 px → 4K ($0.500). Exemples : 1024×1024 et 1024×1536 sont tous deux 1K ; 2048×2048 est 2K ; 4096×4096 est 4K.

4Paramètres de requête

Paramètre	Type	Obligatoire	Par défaut	Description
model	string	Obligatoire	—	ID du modèle. Utilisez "openai/gpt-image-2" (ou la forme courte "gpt-image-2").
prompt	string	Obligatoire	—	Prompt textuel décrivant l'image à générer.
n	integer	Optionnel	1	Nombre d'images à générer (1–10).
size	string	Optionnel	1024x1024	Dimensions de sortie. Options : 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840, auto.
quality	string	Optionnel	auto	Qualité de génération. Options : auto, low, medium, high. Une qualité plus élevée consomme plus de Tokens.
format	string	Optionnel	png	Format d'image de sortie. Options : png, jpeg, webp.

Champs supplémentaires pour /images/edits (i2i)

Paramètre	Type	Obligatoire	Par défaut	Description
image	file / string \| array	Obligatoire	—	Image(s) d'entrée à modifier. Accepte les fichiers via multipart, ou une URL / un data URI base64 dans JSON. Fournissez-en plusieurs pour les composer en une seule sortie.
mask	file / string	Optionnel	—	Masque d'inpainting optionnel. Les zones transparentes seront régénérées ; les zones opaques seront conservées.
input_fidelity	string	Optionnel	low	Degré de conservation de l'entrée. Options : low, high. Utilisez high pour conserver l'identité/la mise en page ; utilisez low pour des transformations plus marquées.
output_format	string	Optionnel	png	Alias de 'format' pour le point de terminaison d'édition. Options : png, jpeg, webp.
output_compression	integer	Optionnel	100	Niveau de compression 0–100 (uniquement pour jpeg / webp).

5Exemple curl complet

bash

curl -X POST https://tokenhub.store/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "A serene Japanese garden at sunset, koi pond reflections, cherry blossoms, soft cinematic lighting, ultra-detailed"
  }'

Réponse :

json

{
  "created": 1740000000,
  "data": [
    {
      "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

6Exemple Python complet

python

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://tokenhub.store/api/v1",
)

result = client.images.generate(
    model="openai/gpt-image-2",
    prompt="A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
    n=1,
    size="1536x1024",
    quality="high",
)

image_url = result.data[0].url
print("Image URL:", image_url[:80], "...")

7Exemple JavaScript / Node.js complet

javascript

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://tokenhub.store/api/v1",
});

const result = await client.images.generate({
  model: "openai/gpt-image-2",
  prompt: "A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
  n: 1,
  size: "1536x1024",
  quality: "high",
});

console.log("Image URL:", result.data[0].url.slice(0, 80), "...");

8Conseils d'utilisation

Les prompts en anglais donnent généralement les meilleurs résultats ; le chinois est également pris en charge.
Response data[].url peut être une URL https simple ou un data URI (base64). Gérez les deux cas lors de l'enregistrement sur disque.
Pour réduire les coûts, utilisez low/medium pour les brouillons et réservez high/les tailles 4K pour la sortie finale.
Le point de terminaison est synchrone — pas de task id, pas de polling. Une requête se termine généralement en 5–30 secondes selon la taille et la qualité.
Réglez le timeout HTTP côté client sur ≥ 120 s pour éviter une déconnexion prématurée sur les grandes images.

9FAQ

Prêt à commencer ?

Inscrivez-vous sur TokenHub et commencez à utiliser l’API GPT-Image-2 dès maintenant

Obtenir une API Key Recharger des Credits