En un coup d’œil
L'API GPT Image 2 exécute GPT Image 2 et 2 autres variantes via Mage sur POST https://api.mage.space/v1/gpt_image_2/generate. Une requête avec les réglages par défaut coûte 9 Gems (environ 0,009 $), sans abonnement. GPT Image 2 accepte les personnages enregistrés et les références via @handle dans le prompt.
Image
Sortie
3
Variantes
9
Gems par image, par défaut
$0.009
Environ, en USD
Présentation
Ce que fait l'API GPT Image 2
Les modèles GPT Image d'OpenAI, qui suivent le prompt à la lettre et génèrent du texte lisible. Génère ou modifie à partir de nombreuses images de référence. Le filtre de sécurité d'OpenAI s'applique.
GPT Image 2, GPT Image 2.5 Flare et GPT Image 2.5 Sunburst d'OpenAI, pour la génération et les modifications. Le filtre de sécurité d'OpenAI s'applique.
Il accepte image et additional_images en entrée.
Démarrage rapide
Appeler l'API GPT Image 2
Définis MAGE_API_KEY, envoie ta requête à /gpt_image_2/generate, puis interroge status_url jusqu'à ce que la requête soit terminée.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "gpt-image-2"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('gpt_image_2', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'gpt-image-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("gpt_image_2", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "gpt-image-2",
})
print(request["result"]["url"])Modèles
Valeurs model_id de GPT Image 2
Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.
| model_id | Nom | Par défaut |
|---|---|---|
| gpt-image-2 | GPT Image 2 | Oui |
| gpt-image-2.5-flare | GPT Image 2.5 Flare | |
| gpt-image-2.5-sunburst | GPT Image 2.5 Sunburst |
Options
Paramètres de GPT Image 2
Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.
| Champ | Valeurs |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
Entrées
Médias acceptés en entrée par GPT Image 2
Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.
| Champ | Rôle |
|---|---|
| image | L'image de référence. |
| additional_images | Images de référence supplémentaires. |
Règles
Ce que l'API GPT Image 2 impose
- Chaque modèle propose seulement certains niveaux de `quality` ; un niveau que le modèle choisi ne propose pas est refusé.
Autres modèles d'image
Autres API de génération d'images sur Mage
Image · à partir de 75 Gems
API Grok Image
Grok Imagine, en trois niveaux de qualité
Image · à partir de 37 Gems
API Guava
Un photoréalisme digne d'une vraie photo
Image · à partir de 20 Gems
API HiDream
Rapide et polyvalent, avec prompts négatifs
Image · à partir de 20 Gems
Krea 2 API
Une esthétique superbe en quelques secondes
Image · à partir de 135 Gems
API Mango
Notre famille d'images phare
Image · à partir de 68 Gems
API Nano Banana 2
Texte net et lisible, jusqu'en 4K
FAQ
Questions fréquentes
Combien coûte l'API GPT Image 2 ?
Une requête GPT Image 2 avec les réglages par défaut (GPT Image 2) coûte 9 Gems, soit environ 0,009 $. D'autres résolutions, durées et variantes modifient le prix ; la réponse indique le montant exact débité. Une génération qui échoue est remboursée ; celle que bloque la politique de contenu de Mage ne l'est pas.
Quel est le endpoint de l'API GPT Image 2 ?
POST https://api.mage.space/v1/gpt_image_2/generate avec un en-tête Authorization: Bearer contenant ta clé API Mage. La réponse inclut un status_url à interroger pour obtenir le résultat.
Quels modèles GPT Image 2 puis-je appeler ?
gpt-image-2 (GPT Image 2), gpt-image-2.5-flare (GPT Image 2.5 Flare), gpt-image-2.5-sunburst (GPT Image 2.5 Sunburst). Le modèle par défaut est GPT Image 2.
GPT Image 2 prend-il en charge les images de référence ou les personnages ?
GPT Image 2 accepte image, additional_images. GPT Image 2 prend en charge les personnages et références enregistrés via @handle dans le prompt.
Puis-je utiliser GPT Image 2 depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor, puis demande GPT Image 2 par son nom. Ton assistant lit ses options avec get_model et t'indique le prix avant de générer.
Combien de temps les résultats de GPT Image 2 sont-ils conservés ?
Les résultats et les entrées sont conservés pendant 30 jours. Télécharge tout ce que tu veux garder sur ton propre stockage.
Lance-toi avec Mage
Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.