GPT Image

API gpt-image-2

gpt-image-2 prend en charge la génération d’images à partir de texte et la retouche d’images. Il est disponible via l’endpoint unifié AIHubMix et les endpoints compatibles OpenAI.

Scénario	Méthode	Chemin	Content-Type
Génération unifiée	POST	`/ai/v1/images/generations`	`application/json`
Génération compatible OpenAI	POST	`/v1/images/generations`	`application/json`
Retouche compatible OpenAI	POST	`/v1/images/edits`	`multipart/form-data`

Pour une nouvelle intégration unifiée, consultez Génération d’images. Les exemples de cette page utilisent les endpoints compatibles OpenAI pour les intégrations SDK existantes.

La génération, la retouche, le décodage Base64 et le rejet d’un paramètre invalide ont été vérifiés avec gpt-image-2. Avant l’intégration, consultez l’API Schema du modèle, sélectionnez l’endpoint par path et lisez son request.schema.

Prérequis

Installez ou mettez à jour le SDK Python OpenAI et fournissez la clé API par une variable d’environnement :

pip install -U openai
export AIHUBMIX_API_KEY="YOUR_API_KEY"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIHUBMIX_API_KEY"],
    base_url="https://aihubmix.com/v1",
)

Générer une image

Cet exemple génère une image PNG 1024x1024 de qualité basse et enregistre les données Base64 retournées.

import base64
import os
from pathlib import Path
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIHUBMIX_API_KEY"],
    base_url="https://aihubmix.com/v1",
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="A simple green triangle centered on a plain white background",
    n=1,
    size="1024x1024",
    quality="low",
    output_format="png",
)

image_bytes = base64.b64decode(result.data[0].b64_json)
Path("gpt-image-2.png").write_bytes(image_bytes)
print(result.usage)

Requête HTTP équivalente :

curl https://aihubmix.com/v1/images/generations \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A simple green triangle centered on a plain white background",
    "n": 1,
    "size": "1024x1024",
    "quality": "low",
    "output_format": "png"
  }'

Modifier une image

L’endpoint de retouche accepte multipart/form-data. Placez l’image source dans le dossier courant sous le nom input.png.

import base64
import os
from pathlib import Path
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIHUBMIX_API_KEY"],
    base_url="https://aihubmix.com/v1",
)

with Path("input.png").open("rb") as source_image:
    result = client.images.edit(
        model="gpt-image-2",
        image=source_image,
        prompt="Change the red circle to a blue square, keeping the white background",
        n=1,
        size="1024x1024",
        quality="low",
        output_format="png",
    )

image_bytes = base64.b64decode(result.data[0].b64_json)
Path("gpt-image-2-edited.png").write_bytes(image_bytes)
print(result.usage)

Requête HTTP équivalente :

curl https://aihubmix.com/v1/images/edits \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image=@input.png;type=image/png" \
  -F "prompt=Change the red circle to a blue square, keeping the white background" \
  -F "n=1" \
  -F "size=1024x1024" \
  -F "quality=low" \
  -F "output_format=png"

Paramètres confirmés

Champ	Génération	Retouche	Description
`model`	Requis	Requis	`gpt-image-2`
`prompt`	Requis	Requis	Description d’image ou instruction de retouche non vide
`image`	-	Requis	Image source à modifier
`mask`	-	Facultatif	Masque qui sélectionne la zone à modifier
`n`	Facultatif	Facultatif	De `1` à `10`, valeur par défaut `1`
`size`	Facultatif	Facultatif	Format `{width}x{height}`
`quality`	Facultatif	Facultatif	`low`, `medium` ou `high`
`output_format`	Facultatif	Facultatif	`png` ou `jpeg`

N’appliquez pas directement à gpt-image-2 les paramètres d’autres versions de GPT Image. Le request.schema de l’endpoint sélectionné fait foi.

Exemple de réponse

Les deux endpoints compatibles renvoient une réponse image OpenAI. data[].b64_json contient l’image en Base64 et usage indique l’utilisation des tokens.

{
  "created": 1787719630,
  "background": "opaque",
  "data": [
    {
      "b64_json": "<base64-encoded-image>"
    }
  ],
  "output_format": "png",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 16,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 16
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 212
  }
}

Réponse d’erreur

Un paramètre non pris en charge renvoie une erreur 4xx structurée. Par exemple, quality: "ultra" renvoie HTTP 400 :

{
  "error": {
    "message": "Invalid value: 'ultra'. Supported values are: 'low', 'medium', 'high', and 'auto'.",
    "type": "invalid_request_error",
    "param": "quality",
    "code": "invalid_value"
  }
}

Vérifiez error.param et error.code, puis corrigez la requête selon le request.schema de l’endpoint sélectionné.

Démarrage

Fonctionnalités passerelle

Capacités des modèles

Référence du protocole

Gestion de la plateforme

Confidentialité et conditions

API gpt-image-2

Prérequis

Générer une image

Modifier une image

Paramètres confirmés

Exemple de réponse

Réponse d’erreur

​API gpt-image-2

​Prérequis

​Générer une image

​Modifier une image

​Paramètres confirmés

​Exemple de réponse

​Réponse d’erreur

API gpt-image-2

Prérequis

Générer une image

Modifier une image

Paramètres confirmés

Exemple de réponse

Réponse d’erreur