Passer au contenu

API Mage · Modèle d'image

API GPT Image 2

Prompts précis et texte lisible

POST https://api.mage.space/v1/gpt_image_2/generate

En un coup d’œil

L'API GPT Image 2 fait tourner GPT Image 2 et 4 autres variantes via Mage à l'adresse 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 par @handle dans le prompt.

  • ImageSortie
  • 5Variantes
  • 9Gems par image, par défaut
  • $0.009Environ, 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 retouche à partir de nombreuses images de référence, ou crée des GIF animés avec GPT Image 2.6. Le filtre de sécurité d'OpenAI s'applique.

Les modèles GPT Image d'OpenAI pour la génération et les retouches : GPT Image 2, GPT Image 2.5 Flare et Sunburst, et GPT Image 2.6 Flare et Sunburst, qui créent aussi des GIF animés. 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_idNomPar défaut
gpt-image-2GPT Image 2Oui
gpt-image-2.5-flareGPT Image 2.5 Flare
gpt-image-2.5-sunburstGPT Image 2.5 Sunburst
gpt-image-2.6-flareGPT Image 2.6 Flare
gpt-image-2.6-sunburstGPT Image 2.6 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.

ChampValeurs
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K
output_formatjpeg, gif

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.

ChampRôle
imageL'image de référence.
additional_imagesImages 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é.
  • Avec un modèle GPT Image 2.6, définis `output_format` sur `gif` pour obtenir un GIF animé, avec `frame_count` de 2 à 16 (9 par défaut) et `frame_duration_ms` de 20 à 2000 (200 par défaut). Les autres modèles le refusent. `resolution` ne s'applique pas : chaque `aspect_ratio` a une seule taille d'image, autour de 640 pixels. Le résultat est un fichier `.gif`, et son `type` reste `image`.
  • Le prix d'un GIF dépend de `quality` et de la tranche de nombre d'images dans laquelle il se situe (2 à 8, 9, 10 à 12 ou 13 à 16), et non de chaque image. Le tableau des prix ci-dessous indique les images fixes : pour un GIF, consulte l'estimation du coût.
  • Un GIF hébergé sur Mage, par exemple un résultat précédent, utilisé comme image d’entrée est traité à partir de sa première image. Un GIF provenant d’ailleurs est refusé : les images d’entrée doivent être au format JPEG ou PNG.

Autres modèles d'image

Autres API de génération d'images sur Mage

  • Image · à partir de 90 Gems

    API Grok Image

    Grok Imagine, en deux versions

  • 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 42 Gems

    API Mango

    Notre famille d'images phare

  • Image · à partir de 15 Gems

    API MiniMax H3 Image

    Images natives de 16 mégapixels, poids ouverts

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), gpt-image-2.6-flare (GPT Image 2.6 Flare), gpt-image-2.6-sunburst (GPT Image 2.6 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.

CharactersCommunauté