Images API

Deux endpoints : génération (texte → image) et édition (image + texte → image). Les deux réponses suivent la structure standard OpenAI data[0].b64_json.

Seedream et Qwen-Image ne prennent pas en charge /v1/images/edits : l’image vers image passe par l’endpoint generations, mais le champ des images de référence diffère — Seedream utilise image, Qwen utilise input_images ; ne les inversez pas. Pour contrôler la résolution de Gemini (de 512 à 4K), passez par le protocole natif Gemini. Les différences de paramètres propres à chaque famille sont décrites sur sa page.

Démarrage rapide

Une requête minimale et exécutable : générer une image de 1024×1024, la décoder et l’enregistrer sous output.png.

import base64
from openai import OpenAI
 
client = OpenAI(
    api_key="YOUR_OFOX_API_KEY",
    base_url="https://api.ofox.io/v1",
    timeout=600,  # l'API d'images est synchrone et peut être lente
)
 
resp = client.images.generate(
    model="openai/gpt-image-2.5-flare",
    prompt="Une pomme rouge sur une table blanche",
    size="1024x1024",
    quality="low",
)
 
with open("output.png", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

curl https://api.ofox.io/v1/images/generations \
  --max-time 600 \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5-flare",
    "prompt": "Une pomme rouge sur une table blanche",
    "size": "1024x1024",
    "quality": "low"
  }' | jq -r '.data[0].b64_json' | base64 --decode > output.png

Toutes les familles s’appellent de la même façon : pour changer de modèle, seul model change. Les plages de valeurs et les paramètres propres diffèrent ; voir la description de chaque paramètre ci-dessous.

Générer des images

POST https://api.ofox.io/v1/images/generations

Paramètres de la requête

Les valeurs possibles et par défaut ci-dessous s’appliquent à la famille GPT Image (gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2). Les différences des autres familles sont signalées au cas par cas. Détails mesurés : famille GPT Image.

Réponse

{
  "created": 1777385517,
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA…", "index": 0 }
  ],
  "model": "openai/gpt-image-2.5-flare",
  "size": "1024x1024",
  "quality": "low",
  "usage": {
    "input_tokens": 13,
    "input_tokens_details": { "text_tokens": 13 },
    "output_tokens": 196,
    "output_tokens_details": { "image_tokens": 196 },
    "total_tokens": 209
  }
}

Éditer des images

POST https://api.ofox.io/v1/images/edits

Paramètres de la requête

Envoyés en multipart/form-data, sous forme de champs de formulaire, avec un fichier image téléversé. Les valeurs possibles et par défaut s’appliquent là encore à la famille GPT Image.

Réponse

Même structure qu’en génération ; usage contient en plus les tokens d’entrée des images de référence :

{
  "created": 1777385669,
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA…", "index": 0 }
  ],
  "model": "openai/gpt-image-2",
  "size": "auto",
  "quality": "low",
  "usage": {
    "input_tokens": 1041,
    "input_tokens_details": { "image_tokens": 1024, "text_tokens": 17 },
    "num_input_images": 1,
    "output_tokens": 358,
    "total_tokens": 1399
  }
}

Les autres champs sont identiques à ceux de la réponse de génération.

Appel

import base64
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/v1", timeout=600)
 
with open("apple.png", "rb") as f:
    resp = client.images.edit(
        model="openai/gpt-image-2",
        image=f,
        prompt="Rends la pomme verte, ne change rien d'autre",
        size="auto",
        quality="low",
    )
 
with open("apple_edited.png", "wb") as out:
    out.write(base64.b64decode(resp.data[0].b64_json))

import OpenAI, { toFile } from 'openai'
import fs from 'node:fs'
 
const client = new OpenAI({
  apiKey: 'YOUR_OFOX_API_KEY',
  baseURL: 'https://api.ofox.io/v1',
  timeout: 600_000, // millisecondes
})
 
const resp = await client.images.edit({
  model: 'openai/gpt-image-2',
  image: await toFile(fs.createReadStream('apple.png'), 'apple.png'),
  prompt: "Rends la pomme verte, ne change rien d'autre",
  size: 'auto',
  quality: 'low',
})
 
fs.writeFileSync('apple_edited.png', Buffer.from(resp.data[0].b64_json!, 'base64'))

curl -X POST 'https://api.ofox.io/v1/images/edits' \
  --max-time 600 \
  -H 'Authorization: Bearer YOUR_OFOX_API_KEY' \
  -F 'model="openai/gpt-image-2"' \
  -F "prompt=\"Rends la pomme verte, ne change rien d'autre\"" \
  -F 'image=@/path/to/apple.png' \
  -F 'size="auto"' \
  -F 'quality="low"'

Le champ image attend un chemin de fichier local (préfixe @ en cURL), et non une URL.

Comparaison mesurée :

Image d’origine	Après édition

Erreurs

En cas d’erreur, la réponse comporte un code HTTP d’erreur et la structure suivante (mesurée) :

{
  "error": {
    "code": null,
    "message": "The model 'gpt-image-2' does not support quality 'xhigh'.",
    "param": null,
    "request_id": "fbe4f24c-779d-41a0-8b3a-c62886cdd1ae",
    "type": "image_generation_user_error"
  }
}

code peut valoir null. Fondez-vous sur le code HTTP et sur message.

Lorsque vous contactez le support, joignez le request_id de la réponse et le détail de l’erreur (code HTTP et error.message). Il est conseillé de les journaliser.

Avancé : sélectionner un fournisseur

Facultatif et généralement inutile. Les trois modèles GPT Image (gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2) sont servis à la fois par azure_foundry et par openai, en génération comme en édition. Sans sélection, la passerelle route automatiquement.

Vous pouvez sélectionner un fournisseur si vous avez des exigences en matière de modération du contenu. Les requêtes vont alors uniquement vers ce fournisseur ; s’il est indisponible, elles ne basculent pas automatiquement vers un autre.

Sélectionner un fournisseur qui ne sert pas le modèle renvoie 400 provider_type_unavailable.

Texte vers image /v1/images/generations

Corps JSON : le champ du corps extra_body.provider.type et l’en-tête X-OfoxAI-Provider-Type fonctionnent tous les deux.

resp = client.images.generate(
    model="openai/gpt-image-2",
    prompt="A simple red apple on a white table",
    size="1024x1024",
    extra_body={"extra_body": {"provider": {"type": "openai"}}},
)

const resp = await client.images.generate({
  model: 'openai/gpt-image-2',
  prompt: 'A simple red apple on a white table',
  size: '1024x1024',
  extra_body: { provider: { type: 'openai' } },
})

curl https://api.ofox.io/v1/images/generations \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "...",
    "n": 1,
    "size": "1024x1024",
    "extra_body": { "provider": { "type": "openai" } }
  }'

Image vers image /v1/images/edits

Un envoi multipart n’a pas de corps JSON où imbriquer extra_body : seul l’en-tête est utilisable.

curl https://api.ofox.io/v1/images/edits \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "X-OfoxAI-Provider-Type: openai" \
  -F "model=openai/gpt-image-2" \
  -F "prompt=..." \
  -F "image=@input.png"

Avec les SDK : en Python, passez extra_headers={"X-OfoxAI-Provider-Type": "openai"} ; en TypeScript, passez { headers: { 'X-OfoxAI-Provider-Type': 'openai' } } en second argument.

Référence complète : API · Routage des fournisseurs.

Documentation officielle et ressources

La documentation officielle décrit le comportement en appel direct à OpenAI. En cas d’écart avec les mesures effectuées sur OfoxAI, les mesures de ce site font foi.

Documentation officielle d’OpenAI

• Guide de génération d’images · Générer des images 
• Guide de génération d’images · Éditer des images 
• Guide de génération d’images · Édition localisée avec un masque 
• Guide de génération d’images · Taille et qualité 
• Guide de génération d’images · Calcul des coûts 
• Référence de l’Images API 

Pages des familles OfoxAI

• Présentation de la famille GPT Image : choix du modèle, taille, qualité, latence, erreurs
• Texte vers image
• Édition et multi-image
• Retouche localisée
• Famille Nano Banana (Gemini Image) et diagnostic des erreurs
• Famille Seedream
• Famille Qwen-Image
• Famille MAI Image