Interprétation approfondie de la démo open source imagegen d’OpenAI : 4 étapes pour accéder à l’API gpt-image-2 via un service proxy API

Note de l'auteur : OpenAI a publié en open source le projet de démonstration Photobooth basé sur gpt-image-2. Cet article décortique en profondeur le code source, le principe de fonctionnement du flux (streaming) et explique comment reproduire cette capacité sans aucune barrière technique via le service proxy API d'APIYI.

OpenAI a rendu public sur GitHub le projet openai-imagegen-demo. Il s'agit d'une application Next.js publiée pour accompagner gpt-image-2, illustrant des capacités uniques du nouveau modèle telles que la génération d'images en flux, la stylisation de portraits et la génération concurrente multi-styles. Adresse du projet : github.com/openai/openai-imagegen-demo.

Ce n'est pas un énième exemple "Hello World" : le code source cache le mode de sortie en flux progressif partial_images recommandé par OpenAI, ainsi que l'utilisation la plus récente du point de terminaison /v1/images/edits dans des scénarios d'édition multi-images.

Valeur ajoutée : Après avoir lu cet article, vous comprendrez parfaitement l'architecture, les paramètres clés et les étapes de reproduction de cette démo officielle, et vous saurez comment utiliser la même API gpt-image-2 en Chine sans VPN et sans attente via le service proxy API d'APIYI.

Points clés du projet openai-imagegen-demo

Détails sur le positionnement du projet imagegen-demo

openai-imagegen-demo est essentiellement un photomaton interactif (Photobooth) : l'utilisateur télécharge ou prend un selfie, choisit jusqu'à 4 styles prédéfinis (comme le style tricot, art numérique, peinture à l'huile, etc.), et l'application appelle simultanément le point de terminaison images/edits de gpt-image-2, renvoyant progressivement le résultat de chaque style en flux.

Contrairement aux "démos de génération texte vers image" courantes sur le marché, ce dépôt officiel se concentre sur deux nouvelles capacités : l'image vers image (image editing) et la sortie progressive en flux (partial_images). La première résout le défi technique du "maintien de la cohérence faciale", tandis que la seconde transforme l'attente de 30 secondes devant un écran noir en une apparition progressive image par image.

Analyse de l'architecture du projet imagegen-demo

Analyse du code source clé

Le cœur du projet repose sur une seule route API : app/api/photobooth/route.ts. Elle est chargée d'empaqueter l'image portrait et l'invite de style provenant du front-end, puis d'effectuer une requête en mode streaming vers le point de terminaison /v1/images/edits d'OpenAI. Voici la structure essentielle du corps de la requête :

const body = {
  model: "gpt-image-2",
  prompt: `${style.prompt}\n\n${OPENAI_IMAGE_OUTPUT_REQUIREMENTS}`,
  images: [{ image_url: imageDataUrl }],
  size: "1024x1536",
  quality: "high",
  output_format: "png",
  stream: true,
  partial_images: 2,
};

Trois détails méritent votre attention :

1. stream: true + partial_images: 2 : Il s'agit d'une capacité de streaming exclusive à gpt-image-2. Le serveur envoie deux images intermédiaires avant de livrer le résultat final.
2. Paramètre images : Accepte une ou plusieurs images de référence sous forme d'URL de données (data URL), permettant la fusion et l'édition multi-images.
3. OPENAI_IMAGE_OUTPUT_REQUIREMENTS : Impose des contraintes strictes ("portrait au format 2:3, maintien de la posture et de l'expression du personnage"), ce qui constitue la règle d'or pour rédiger une invite efficace pour l'édition d'images.

Analyse des événements de streaming

La route utilise SSE (Server-Sent Events) pour écouter les réponses officielles et traiter trois types d'événements :

• image_edit.partial_image : Image intermédiaire, transmet style-partial au front-end.
• image_edit.completed : Produit final, transmet style-final au front-end.
• error : Lève une exception, gérée de manière centralisée par le front-end.

Côté React, le front-end utilise un hook personnalisé pour maintenir une chaîne de promesses writeQueue, garantissant que l'ordre des événements reste cohérent lors de requêtes simultanées sur plusieurs styles. C'est sans doute la partie la plus intéressante du point de vue de l'ingénierie dans cette démo.

Prise en main rapide de imagegen-demo

Étapes de reproduction minimalistes

Selon le README officiel, il suffit de 5 commandes pour faire fonctionner le projet :

git clone https://github.com/openai/openai-imagegen-demo
cd openai-imagegen-demo
cp .env.example .env.local
echo "OPENAI_API_KEY=sk-xxxxx" >> .env.local
npm install && npm run dev

# Option 1 : Utiliser l'API officielle OpenAI (nécessite un accès réseau étranger + quota API)
OPENAI_API_KEY="sk-proj-xxxxx"

# Option 2 : Utiliser le service proxy API de APIYI (connexion directe depuis la Chine, sans VPN)
OPENAI_API_KEY="your-apiyi-key"
OPENAI_BASE_URL="https://vip.apiyi.com/v1"

# Optionnel : ID d'organisation et de projet
OPENAI_ORG_ID=""
OPENAI_PROJECT_ID=""

const endpointBase = process.env.OPENAI_BASE_URL ?? "https://api.openai.com/v1";

const response = await fetch(`${endpointBase}/images/edits`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(body),
});

Conseil d'intégration : Les développeurs basés en Chine rencontreront trois obstacles majeurs avec la démo officielle d'OpenAI (réseau, quota API, moyens de paiement). Nous recommandons d'utiliser une clé compatible via le service proxy APIYI (apiyi.com) et de pointer OPENAI_BASE_URL vers https://vip.apiyi.com/v1. Vous pourrez ainsi lancer le projet localement en un clic, avec une compatibilité totale des événements de streaming et des paramètres.

Comparaison des solutions d'intégration pour imagegen-demo

Analyse des solutions

Analyse de l'accès officiel OpenAI : Le canal officiel reste la référence absolue en termes de conformité et de SLA, et constitue l'environnement cible par défaut pour imagegen-demo. Cependant, son utilisation en Chine nécessite un VPN, une carte bancaire internationale et un délai d'approbation pour les quotas API. En comparaison, le canal proxy APIYI est bien plus adapté à la phase de test et aux environnements de production locaux grâce à sa facilité d'accès.

Analyse de l'API entreprise fal : fal a lancé ses points de terminaison entreprise pour gpt-image-2 le 21 avril 2026, offrant d'excellentes performances en termes de SLA à haute concurrence. Toutefois, pour les développeurs indépendants, la barrière à l'entrée est élevée. Pour ceux qui souhaitent faire tourner imagegen-demo localement, APIYI est une solution beaucoup plus légère.

Différences entre proxy et inverse APIYI : Le proxy signifie qu'APIYI transmet vos requêtes à l'API officielle d'OpenAI ; la facturation, le SLA et les fonctionnalités sont identiques à l'original, ce qui est idéal pour un usage commercial. L'inverse repose sur une rétro-ingénierie de l'interface web de ChatGPT, offrant un prix fixe de 0,03 $/image, parfait pour le prototypage. Les deux canaux sont disponibles simultanément sur la plateforme APIYI, permettant aux développeurs de basculer selon leurs besoins.

Note comparative : Les données ci-dessus sont compilées à partir de la tarification officielle d'OpenAI, des communiqués de presse de fal et de la documentation technique docs.apiyi.com. Vous pouvez les vérifier en temps réel via APIYI sur apiyi.com.

Analyse détaillée des paramètres clés de gpt-image-2 (source : imagegen-demo)

D'après le fichier lib/constants.ts du projet imagegen-demo, voici les combinaisons de paramètres par défaut recommandées officiellement pour gpt-image-2 :

Meilleures pratiques pour l'ingénierie d'invite (Prompt Engineering)

La constante OPENAI_IMAGE_OUTPUT_REQUIREMENTS du Demo est un modèle d'invite très précieux :

"portrait orientation (2:3 aspect ratio), preserve the exact people, poses, facial expressions, and scene composition as faithfully as possible"

Ce texte révèle le paradigme d'or pour l'édition d'images avec gpt-image-2 :

• Spécifier explicitement le ratio : Même si le paramètre size est défini, réitérez le ratio dans l'invite pour améliorer le taux de réussite.
• Insister sur la fidélité : preserve the exact ... est la formule magique pour maintenir la cohérence faciale.
• Énumérer les dimensions de fidélité : Citez précisément les personnes, les poses, les expressions et la composition de la scène ; plus vous êtes spécifique, meilleure sera la restitution.

FAQ – Questions fréquentes

Points clés de openai-imagegen-demo

• Open Source officiel d'OpenAI : Démo officielle publiée avec gpt-image-2, sous licence MIT, utilisable commercialement.
• Focus sur l'image vers image : Utilise le point de terminaison /v1/images/edits, un paradigme technique pour maintenir la cohérence faciale.
• Technique de rendu en streaming : stream: true + partial_images: 2 transforme l'attente d'un écran noir en un rendu progressif.
• Full-stack Next.js 15 : L'architecture App Router + SSE est la meilleure pratique moderne pour les applications de génération d'images.
• Raccourci pour l'accès en Chine : Via le service proxy API d'APIYI (apiyi.com), il suffit de modifier la base_url pour une connexion directe.
• Paradigme d'invite (Prompt) en or : preserve the exact ... est la formule magique pour la fidélité, à copier absolument dans vos projets.
• Double canal (officiel vs proxy) : Pour un usage commercial, privilégiez le canal officiel (aligné sur OpenAI) ; pour les tests, le canal proxy (tarif fixe de 0,03 $/image).

Conclusion

openai-imagegen-demo est la meilleure porte d'entrée pour comprendre les nouvelles capacités de gpt-image-2. Sa valeur ajoutée repose sur trois piliers :

1. Référence officielle : Un modèle d'intégration écrit par OpenAI, couvrant les paramètres, les invites et l'architecture de streaming.
2. Code prêt pour la production : Next.js 15 + SSE + concurrence multi-style, réutilisable directement dans vos propres projets.
3. Reproductibilité locale : Grâce au service proxy APIYI, les développeurs peuvent faire fonctionner la démo officielle en 5 minutes.

Si vous souhaitez tester immédiatement les capacités d'édition d'image en streaming de gpt-image-2, nous vous recommandons d'obtenir une clé compatible via APIYI (apiyi.com), de cloner openai-imagegen-demo et de pointer OPENAI_BASE_URL vers https://vip.apiyi.com/v1. Vous pourrez ainsi reproduire localement les effets de la démonstration officielle d'OpenAI.

Lectures complémentaires

Si vous vous intéressez à gpt-image-2 et à openai-imagegen-demo, nous vous recommandons de poursuivre votre lecture :

• 📘 Où trouver l'API inversée de gpt-image-2 ? Connectez-vous au canal officiel APIYI en 3 minutes – Découvrez la solution économique à 0,03 $ par image via le canal officiel.
• 📊 Comparatif des modèles d'image : gpt-image-2 vs Nano Banana Pro – Analysez les différences de capacités entre les principaux modèles d'image.
• 🚀 Guide de déploiement de gpt-image-2 : 6 secteurs clés – Explorez des cas d'usage réels dans l'e-commerce, l'éducation, les réseaux sociaux, etc.

📚 Références

1. Dépôt officiel OpenAI imagegen-demo : code source complet, README et documentation d'installation.

   • Lien : github.com/openai/openai-imagegen-demo
   • Description : Le point de départ idéal pour accéder au code source original et aux guides d'installation afin de comprendre le paradigme d'intégration de gpt-image-2.

2. Documentation officielle de l'API OpenAI gpt-image-2 : paramètres du modèle, points de terminaison et détails de facturation.

   • Lien : developers.openai.com/api/docs/models/gpt-image-2
   • Description : Consultez tous les paramètres pris en charge, les tarifs et les règles de limitation de débit.

3. Page de lancement d'OpenAI ChatGPT Images 2.0 : présentation des capacités du nouveau modèle.

   • Lien : openai.com/index/introducing-chatgpt-images-2-0/
   • Description : Découvrez la philosophie de conception, les capacités principales et les cas d'utilisation de gpt-image-2.

4. Documentation du canal de transfert officiel APIYI pour gpt-image-2 : guide de connexion directe depuis la Chine.

   • Lien : docs.apiyi.com/en/api-capabilities/gpt-image-2-all/overview
   • Description : Obtenez votre clé API compatible, la configuration base_url et les détails tarifaires.

Auteur : Équipe technique APIYI
Échanges techniques : N'hésitez pas à partager vos retours d'expérience sur imagegen-demo dans les commentaires. Pour plus de documentation, visitez le centre de documentation APIYI sur docs.apiyi.com.