ToAPIs
    AccueilToAPIs
    Génération d'imagesGPT Image 2.6, Gemini, FLUX…Génération de vidéosSeedance, Veo, Kling, Sora…Chat et rédactionGPT-5.6, Claude, DeepSeek…Voix et musiqueVoix off, TTS, audio
    Nouvelle sortieSeedance 2.5
    TarifsDocumentation APIMCP
    BlogAlternatives
    Se connecterCommencer gratuitement
    Tous les modèlesTarifsDocumentation APIMCPBlogAlternatives
    Se connecterCommencer gratuitement

    Langue

    Esc
    • Seedance 2.5Génération de vidéos
    • GPT Image 2Génération d'images
    • GPT Image 2.6Génération d'images
    • GPT Image 2.5Génération d'images
    • Veo 3.1 FastGénération de vidéos
    • Kling 3.0 TurboGénération de vidéos
    • Kling V4 FlashGénération de vidéos
    • Grok Video 1.5Génération de vidéos
    • Nano Banana 2Génération d'images
    • Seedream 5.5Génération d'images
    • FLUXGénération d'images
    • Sora 2Génération de vidéos
    • Tous les modèles d'imageCatégorie
    • Tous les modèles vidéoCatégorie
    • GPT-5.6 SolChat et codage
    • Claude Opus 4.8Chat et codage
    • Claude Opus 4.7Chat et codage
    • DeepSeek V4 ProDeepSeek · Texte
    • Gemini Omni 1.1 FlashGoogle · Multimodal
    1. Accueil
    2. Blog
    3. Tutoriel
    4. GPT Image 2 : miroir global et proxy pour les équipes internationales
    Retour à tous les articles
    tutorial2026-11-117 min de lecture

    GPT Image 2 : miroir global et proxy pour les équipes internationales

    Comment les équipes internationales peuvent appeler l'API GPT Image 2 via un origin ToAPIs documenté, réutiliser les sessions et interroger les tâches d'image asynchrones, sans dépendre de chiffres de latence non vérifiés.

    ToAPIs Engineering & Evaluation Team
    GPT Image 2API GatewayLatencyImage APITutorial
    TL;DR - Points clés
    • Pointez chaque environnement vers un seul origin ToAPIs documenté ; la documentation officielle indique aux utilisateurs de Chine continentale d'utiliser https://toapis.cn, tandis que cette série utilise https://api.toapis.com.
    • Le contrat actuel de gpt-image-2 utilise size comme format d'image (par exemple 1:1 ou 16:9) et resolution comme 1k, 2k ou 4k — pas une chaîne de pixels comme 1024x1024.
    • Les tâches d'image sont asynchrones : conservez l'id de tâche et interrogez GET /v1/images/generations/{id}. Un timeout client ne prouve pas que la tâche a échoué.
    • Ne publiez pas de temps de handshake, de listes de POP ni l'affirmation que des prompts répétés sont servis par un cache de périphérie gratuit, et ne budgétez pas sur ces bases.

    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-2 sur POST /v1/images/generations. Les champs documentés actuels incluent prompt (jusqu'à 32 000 caractères), size comme format d'image tel que 1:1 ou 16:9 (pas une chaîne de pixels 1024x1024) et resolution comme 1k, 2k ou 4k.
    • Régions : la documentation officielle ToAPIs indique aux utilisateurs de Chine continentale d'utiliser https://toapis.cn comme URL de base. Les exemples internationaux de cette série utilisent https://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 id de tâche. Interrogez GET /v1/images/generations/{task_id} (ou GET /v1/tasks/{task_id}) jusqu'au statut completed ou failed. 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.

    Groupes abstraits de nœuds régionaux routés via une passerelle ToAPIs centrale vers un chemin de génération d'images

    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'id de 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

    bash
    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.

    python
    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 HTTPCatégorie couranteAction recommandée
    400Champ invalide ou combinaison non prise en chargeVé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
    401Clé d'API absente ou invalideFaites tourner la clé dans le tableau de bord ToAPIs et confirmez l'en-tête Authorization
    429Limite de débit ou de concurrenceRespectez 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éseauProblème temporaire de passerelle ou d'amontVérifiez le statut de la tâche avant de renvoyer ; utilisez une politique de nouvelle tentative bornée

    WaitTime=min⁡(MaxWait,BaseInterval×2attempt)+Uniform(0,1)\text{WaitTime} = \min(\text{MaxWait}, \text{BaseInterval} \times 2^{\text{attempt}}) + \text{Uniform}(0, 1)WaitTime=min(MaxWait,BaseInterval×2attempt)+Uniform(0,1)


    5. Tarifs et ROI FinOps

    Couˆt estimeˊ=images facturables reˊussies×tarif actuel du compte pour ce modeˋle, cette taille et cette reˊsolution\text{Coût estimé} = \text{images facturables réussies} \times \text{tarif actuel du compte pour ce modèle, cette taille et cette résolution}Couˆt estimeˊ=images facturables reˊussies×tarif actuel du compte pour ce modeˋle, cette taille et cette reˊsolution

    • 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.com ou toapis.cn est 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 en 1k et 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.com ou, si nécessaire, https://toapis.cn) et testez l'extrait cURL avec gpt-image-2, size: "1:1" et resolution: "1k".
    • Conservez l'id de tâche, interrogez GET /v1/images/generations/{id} avec un délai borné et respectez Retry-After sur 429.
    • 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.

    Découvrir les modèles cités dans cet article

    OpenAIIMAGE

    GPT-Image-2

    Tarif actuel : 3 credits /request
    Guide du modèleEssayer dans la consoleObtenir une clé d'API
    OpenAIIMAGE

    GPT-Image-2 VIP

    Tarif actuel : 3.38 credits /request
    Guide du modèleEssayer dans la consoleObtenir une clé d'API

    Articles associés

    tutorial2026-11-12T10:00:00+08:007 min de lecture

    Générer des images 4K natives avec GPT Image 2 : formats d'image et workflows d'upscaling

    Générez une sortie 4K native avec le contrat actuel de GPT Image 2 : définissez size comme un format d'image et resolution sur 4k. Il n'existe pas de flag upscale: true documenté, et la taille en pixels du 4K dépend du ratio que vous choisissez.

    TO
    ToAPIs Engineering & Evaluation Team
    #GPT Image 2
    tutorial2026-11-12T10:00:00+08:007 min de lecture

    Maîtriser l'inpainting et l'outpainting avec l'API d'édition d'images GPT Image 2

    Modifiez des images existantes avec le contrat actuel de GPT Image 2 : changements guidés par référence sur gpt-image-2 et inpainting par masque sur gpt-image-2-official, le tout sur l'endpoint asynchrone de génération.

    TO
    ToAPIs Engineering & Evaluation Team
    #GPT Image 2
    tutorial2026-10-23T10:00:00+08:004 min de lecture

    Guide complet de l'API GPT Image 2 : paramètres, spécifications officielles et exemples Python

    Guide d'intégration pour les développeurs de l'API GPT Image 2. Apprenez à régler les paramètres, à utiliser les résolutions HD, à contrôler le format d'image, à faire de l'inpainting et à implémenter en Python et Node.js.

    TO
    ToAPIs Engineering & Evaluation Team
    #GPT Image 2
    ToAPIs
    AccueilToAPIs
    Passerelle d'API d'IA pour l'entreprise. Accédez à GPT-5, Claude, Gemini et plus de 200 modèles via une API unifiée.

    Modèles populaires

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Afficher plusAfficher moins
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • Tous les modèles

    Catégories d'API

    • API image IA
    • API vidéo IA
    • API texte-vers-vidéo
    • API image-vers-vidéo
    Afficher plusAfficher moins
    • API d'édition d'image IA
    • API LLM et raisonnement
    • Tous les outils API →

    Alternatives

    Alternatives
    • Alternative à Kie.ai
    • Alternative à Fal.ai
    • Alternative à OpenRouter
    • Alternative à Replicate
    • Alternative à Wavespeed AI
    • Toutes les comparaisons →

    Guides à la une

    Guides à la une
    • Tarifs de Seedance 2.0 et 2.5
    • Guide de l'API Seedance la moins chère
    • Guide d'intégration de MiniMax H3
    • Clé d'API Seedance 2 gratuite
    • Démarrage rapide de l'API Seedance 2
    • Tous les articles techniques →

    Développeurs et plateforme

    Développeurs et plateforme
    • Documentation API
    • MCP
    • Tarifs
    • Playground de modèles
    • LLMs.txt
    • Contacter le support
    • Annuaire des guides de modèles
    Entité exploitante :
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Siège social :
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    ConfidentialitéConditionsUsage acceptableSuppression des donnéesConservation des donnéesSous-traitants et régionsFacturation et remboursementsPolitique relative aux cookiesPlan du siteÀ propos

    © 2026 ToAPIs. Tous droits réservés.