GPT Image 2 : miroir global et proxy pour les équipes internationales
Modèle cible :
gpt-image-2
Endpoint d'inférence :https://api.toapis.com/v1/images/generations
Associé : Guide de l'API GPT Image 2 · Tarifs GPT Image 2 · Guide de l'API GPT-Image-2.6
1. TL;DR et vue d'ensemble des performances
- Objectif : pointer les clients internationaux vers une seule passerelle d'images ToAPIs, plutôt que d'ouvrir une nouvelle session longue distance vers un origin éditeur pour chaque requête
gpt-image-2. - Contrat : utilisez l'ID de modèle
gpt-image-2surPOST /v1/images/generations. Les champs documentés actuels incluentprompt(jusqu'à 32 000 caractères),sizecomme format d'image tel que1:1ou16:9(pas une chaîne de pixels1024x1024) etresolutioncomme1k,2kou4k. - Régions : la documentation officielle ToAPIs indique aux utilisateurs de Chine continentale d'utiliser
https://toapis.cncomme URL de base. Les exemples internationaux de cette série utilisenthttps://api.toapis.com. Les chemins, ID de modèle et l'en-tête Bearer restent identiques ; seul l'origin change. - Protocole asynchrone : la génération d'images renvoie un
idde tâche. InterrogezGET /v1/images/generations/{task_id}(ouGET /v1/tasks/{task_id}) jusqu'au statutcompletedoufailed. Le temps d'horloge côté client n'est pas la même chose que le temps de génération, et un timeout client ne prouve pas que la tâche a échoué. - Ce que cet article n'affirme pas : il ne publie ni liste de POP, ni temps de handshake, ni cible de latence de bout en bout non vérifiée. Mesurez-les sur votre propre chemin. Le détail des paramètres et les comparaisons de SKU se trouvent dans le guide de l'API et le guide 2.6.
2. Router les équipes internationales via la passerelle ToAPIs
Les équipes hors de la région d'origine de l'éditeur ressentent souvent deux délais distincts : le temps d'établissement d'une connexion, et le temps que le modèle passe réellement à rendre. Les fondre en un unique chiffre « l'API est lente » conduit à optimiser la mauvaise chose. Le premier est un problème réseau que vous pouvez traiter en utilisant un origin ToAPIs documenté plus proche et en réutilisant une session HTTP chaude. Le second est le temps de génération, que vous observez une fois la tâche acceptée.
ToAPIs expose un chemin unifié de génération d'images. La documentation officielle documente actuellement https://toapis.com et indique aux utilisateurs de Chine continentale de remplacer cet origin par https://toapis.cn. Les guides de cette série, dont le guide de l'API GPT Image 2, envoient les mêmes chemins vers https://api.toapis.com. Choisissez une URL de base par environnement, stockez-la en configuration et ne codez pas en dur un mélange d'origins dans le même service.

Figure 1 : gardez les clients sur un seul origin ToAPIs documenté, réutilisez la session et traitez la génération d'images comme une tâche asynchrone plutôt qu'un aller-retour synchrone longue distance.
Des habitudes de routage pratiques qui ne dépendent pas de chiffres de latence non publiés :
- Un origin par environnement. Un service à Singapour et un service à Francfort peuvent partager le même ID de modèle et la même payload. Ils ne devraient pas inventer leurs propres URL d'éditeur.
- Réutilisez les connexions. Activez le HTTP keep-alive (et HTTP/2 là où votre client le prend déjà en charge) pour que l'établissement TLS ne se répète pas à chaque soumission ou interrogation.
- Découplez la soumission de l'attente. Conservez l'
idde tâche immédiatement. Interrogez à intervalle borné, ou préférez un webhook de tâche en gardant l'interrogation en secours. - Ne cachez pas les « prompts identiques » comme raccourci de facturation. Il n'existe aucune garantie ToAPIs documentée qu'un prompt répété soit servi depuis un cache de périphérie ou soit gratuit. Si deux tâches sont soumises, prévoyez de payer deux tâches, sauf si les conditions de votre compte indiquent le contraire.
Le contrat de requête actuel devient aussi facilement obsolète. D'anciens extraits envoient parfois size comme 1024x1024 et un flag quality: "standard". La référence actuelle de l'API gpt-image-2 et le contrat du frontend ToAPIs utilisent size pour le format d'image (1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 21:9, 9:21 ou auto) et resolution pour le palier (1k, 2k, 4k). Le gpt-image-2 exact n'expose pas de champ quality dans le contrat actuel du playground ; quality apparaît sur des ID comme gpt-image-2-vip. Confirmez l'ID que vous appelez réellement.
Les images de référence vont dans reference_images (URL publiques uniquement, jusqu'à 14). image_urls est accepté comme alias rétrocompatible et normalisé en reference_images. N'envoyez pas de base64 ; importez d'abord. Pour des ratios personnalisés, plus d'options de qualité ou le comportement d'une SKU officielle, voir le guide de l'API et le guide du modèle.
3. Implémentation en production : cURL et Python
Étape 1 : envoi cURL
curl -X POST "https://api.toapis.com/v1/images/generations" \
-H "Authorization: Bearer $TOAPIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Minimalist product still of a matte ceramic pour-over kettle on slate, soft side light, no typography",
"size": "1:1",
"resolution": "1k",
"n": 1,
"response_format": "url"
}'
Étape 2 : helper Python de soumission et d'interrogation
Alignez les noms de champs et l'enveloppe de réponse sur la référence de l'API de votre compte. L'extrait utilise le chemin de statut d'image documenté et les statuts completed / failed. Passez BASE à https://toapis.cn uniquement pour un environnement de Chine continentale devant utiliser cet origin.
import os
import time
import requests
API_KEY = os.environ["TOAPIS_API_KEY"]
BASE = "https://api.toapis.com"
ENDPOINT = f"{BASE}/v1/images/generations"
HEADERS = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
}
def dispatch_image(
prompt: str,
size: str = "1:1",
resolution: str = "1k",
model: str = "gpt-image-2",
reference_images: list[str] | None = None,
) -> str:
payload = {
"model": model,
"prompt": prompt,
"size": size,
"resolution": resolution,
"n": 1,
"response_format": "url",
}
if reference_images:
payload["reference_images"] = reference_images
res = requests.post(ENDPOINT, headers=HEADERS, json=payload, timeout=30)
res.raise_for_status()
data = res.json()
task_id = data.get("id") or data.get("task_id")
if not task_id:
raise RuntimeError(f"Unexpected submission envelope: {data}")
return task_id
def poll_image_task(task_id: str, deadline_s: int = 180) -> str:
poll_url = f"{BASE}/v1/images/generations/{task_id}"
interval = 2.0
start = time.time()
while time.time() - start < deadline_s:
time.sleep(interval)
poll = requests.get(poll_url, headers=HEADERS, timeout=15)
if poll.status_code == 429:
retry_after = poll.headers.get("Retry-After")
time.sleep(float(retry_after) if retry_after else min(interval * 2, 20))
continue
poll.raise_for_status()
data = poll.json()
status = data.get("status")
if status == "completed":
return data["result"]["data"][0]["url"]
if status == "failed":
raise RuntimeError(f"Generation failed: {data.get('error')}")
interval = min(interval * 1.5, 8.0)
raise TimeoutError(f"Task {task_id} exceeded {deadline_s}s; check status before retrying")
if __name__ == "__main__":
task_id = dispatch_image(
"Minimalist product still of a matte ceramic pour-over kettle on slate, soft side light, no typography"
)
print("Task:", task_id)
print("Image:", poll_image_task(task_id))
Stockez l'URL de base, l'ID de modèle, size et resolution à côté de l'enregistrement de tâche. Si vous faites ensuite passer un client de gpt-image-2 à gpt-image-2-vip ou à une SKU 2.6, changez une variable à la fois et relisez le guide correspondant — les unités de facturation ne sont pas automatiquement identiques.
4. Gestion des erreurs et matrice des statuts
Les catégories ci-dessous sont des points de départ pour le diagnostic, pas une garantie de codes d'erreur ToAPIs exacts. Une requête HTTP réussie exige tout de même de lire le status de la tâche.
| Statut HTTP | Catégorie courante | Action recommandée |
|---|---|---|
400 | Champ invalide ou combinaison non prise en charge | Vérifiez l'ID de modèle, que size est un ratio documenté, que resolution vaut 1k / 2k / 4k et que les images de référence sont des URL plutôt que du base64 |
401 | Clé d'API absente ou invalide | Faites tourner la clé dans le tableau de bord ToAPIs et confirmez l'en-tête Authorization |
429 | Limite de débit ou de concurrence | Respectez Retry-After lorsqu'il est présent ; appliquez un backoff avec jitter ; ne réessayez que si c'est sûr |
5xx ou timeout réseau | Problème temporaire de passerelle ou d'amont | Vérifiez le statut de la tâche avant de renvoyer ; utilisez une politique de nouvelle tentative bornée |
5. Tarifs et ROI FinOps
- Ne réutilisez pas de prix unitaires de brouillons de planification ou d'anciens articles. Les tarifs du catalogue, les multiplicateurs de résolution et le traitement des tâches échouées varient selon la SKU et le compte. Certains ID GPT Image 2.x sont facturés par image ; le guide 2.6 documente une facturation par tokens pour cette génération. Confirmez le tarif applicable à l'ID de modèle exact que vous appelez.
- Le routage ne change pas, à lui seul, le prix du modèle. Utiliser
api.toapis.comoutoapis.cnest un choix d'URL de base. Ce n'est pas une remise documentée. Les gains FinOps viennent de l'évitement des soumissions en double après un timeout client, des brouillons en1ket du choix de la bonne SKU. - Les contrats officiels des éditeurs ajoutent souvent des contraintes régionales de facturation, des engagements ou des planchers de prépaiement. La facturation ToAPIs est généralement en paiement à l'usage — confirmez les conditions actives sur votre compte.
- Pour une discussion tarifaire plus approfondie, utilisez l'article sur les tarifs GPT Image 2 comme contexte, puis vérifiez chaque chiffre au catalogue en direct avant de l'inscrire dans une prévision.
6. Questions fréquentes
Voir le bloc FAQ du frontmatter. En résumé : changer l'origin ToAPIs ne change ni l'ID de modèle ni la forme de requête documentée ; les utilisateurs de Chine continentale doivent suivre la note toapis.cn de la documentation officielle ; les tâches d'image sont asynchrones ; size est un format d'image et resolution est le palier ; il n'existe aucun cache de périphérie gratuit documenté pour les prompts répétés.
7. Liste d'actions
- Créez une clé sur le portail développeur ToAPIs.
- Définissez une URL de base par environnement (
https://api.toapis.comou, si nécessaire,https://toapis.cn) et testez l'extrait cURL avecgpt-image-2,size: "1:1"etresolution: "1k". - Conservez l'
idde tâche, interrogezGET /v1/images/generations/{id}avec un délai borné et respectezRetry-Aftersur429. - Ensuite : le guide de l'API GPT Image 2 pour les paramètres, le guide 2.6 si vous changez de SKU, et le parcours des crédits gratuits si vous ouvrez un nouveau compte.







