ToAPIs
    InicioToAPIs
    Generación de imágenesGPT Image 2.6, Gemini, FLUX…Generación de videoSeedance, Veo, Kling, Sora…Chat y redacciónGPT-5.6, Claude, DeepSeek…Voz y músicaLocuciones, TTS, audio
    NovedadSeedance 2.5
    PreciosDocumentación de APIMCP
    BlogAlternativas
    Iniciar sesiónEmpieza gratis
    Todos los modelosPreciosDocumentación de APIMCPBlogAlternativas
    Iniciar sesiónEmpieza gratis

    Idioma

    Esc
    • Seedance 2.5Generación de video
    • GPT Image 2Generación de imágenes
    • GPT Image 2.6Generación de imágenes
    • GPT Image 2.5Generación de imágenes
    • Veo 3.1 FastGeneración de video
    • Kling 3.0 TurboGeneración de video
    • Kling V4 FlashGeneración de video
    • Grok Video 1.5Generación de video
    • Nano Banana 2Generación de imágenes
    • Seedream 5.5Generación de imágenes
    • FLUXGeneración de imágenes
    • Sora 2Generación de video
    • Todos los modelos de imagenCategoría
    • Todos los modelos de videoCategoría
    • GPT-5.6 SolChat y código
    • Claude Opus 4.8Chat y código
    • Claude Opus 4.7Chat y código
    • DeepSeek V4 ProDeepSeek · Texto
    • Gemini Omni 1.1 FlashGoogle · Multimodal
    1. Inicio
    2. Blog
    3. Tutorial
    4. GPT Image 2: espejo global y proxy para equipos internacionales
    Volver a todos los artículos
    tutorial2026-11-117 min de lectura

    GPT Image 2: espejo global y proxy para equipos internacionales

    Cómo los equipos internacionales pueden llamar a la API de GPT Image 2 mediante un origen documentado de ToAPIs, reutilizar sesiones y consultar tareas de imagen asíncronas, sin depender de cifras de latencia no verificadas.

    ToAPIs Engineering & Evaluation Team
    GPT Image 2API GatewayLatencyImage APITutorial
    TL;DR - Puntos clave
    • Apunta todos los entornos a un único origen documentado de ToAPIs; la documentación oficial indica a los usuarios de China continental que usen https://toapis.cn, mientras que esta serie usa https://api.toapis.com.
    • El contrato actual de gpt-image-2 usa size como relación de aspecto (por ejemplo 1:1 o 16:9) y resolution como 1k, 2k o 4k, no una cadena de tamaño en píxeles como 1024x1024.
    • Las tareas de imagen son asíncronas: guarda el id de la tarea y consulta GET /v1/images/generations/{id}. Un timeout del cliente no demuestra que la tarea haya fallado.
    • No publiques ni presupuestes con tiempos de handshake, listas de POP ni la promesa de que los prompts repetidos se sirven desde una caché gratuita en el edge.

    GPT Image 2: espejo global y proxy para equipos internacionales

    Modelo objetivo: gpt-image-2
    Endpoint de inferencia: https://api.toapis.com/v1/images/generations
    Relacionado: Guía de la API GPT Image 2 · Precios de GPT Image 2 · Guía de la API GPT-Image-2.6


    1. TL;DR y panorama de rendimiento

    • Tarea: apuntar los clientes internacionales a una sola pasarela de imágenes de ToAPIs, en lugar de abrir una sesión de larga distancia nueva contra un origen del proveedor para cada solicitud a gpt-image-2.
    • Contrato: usa el ID de modelo gpt-image-2 en POST /v1/images/generations. Los campos documentados actuales incluyen prompt (hasta 32,000 caracteres), size como relación de aspecto como 1:1 o 16:9 (no una cadena de píxeles 1024x1024) y resolution como 1k, 2k o 4k.
    • Regiones: la documentación oficial de ToAPIs indica a los usuarios de China continental usar https://toapis.cn como URL base. Los ejemplos internacionales de esta serie de blog usan https://api.toapis.com. Las rutas, los ID de modelo y la cabecera Bearer no cambian; solo cambia el origen.
    • Protocolo asíncrono: la generación de imágenes devuelve un id de tarea. Consulta GET /v1/images/generations/{task_id} (o GET /v1/tasks/{task_id}) hasta que el estado sea completed o failed. El tiempo de reloj en el cliente no es lo mismo que el tiempo de generación, y un timeout del cliente no demuestra que la tarea haya fallado.
    • Lo que este artículo no afirma: no publica una lista de POP, un tiempo de handshake ni un objetivo de latencia de extremo a extremo sin verificar. Mídelos en tu propia ruta. El detalle de parámetros y las comparativas de SKU están en la guía de la API y en la guía de 2.6.

    2. Enrutar equipos internacionales a través de la pasarela de ToAPIs

    Los equipos fuera de la región de origen del proveedor suelen notar dos retrasos distintos: el tiempo para establecer una conexión y el tiempo que el modelo pasa realmente renderizando. Meterlos en un único número de "la API es lenta" hace que se optimice lo equivocado. El primero es un problema de red que puedes abordar usando un origen documentado de ToAPIs más cercano y reutilizando una sesión HTTP en caliente. El segundo es el tiempo de generación, que observas después de que se acepte la tarea.

    ToAPIs expone una ruta unificada de generación de imágenes. La documentación oficial documenta actualmente https://toapis.com e indica a los usuarios de China continental reemplazar ese origen por https://toapis.cn. Las guías de esta serie, incluida la guía de la API GPT Image 2, envían las mismas rutas a https://api.toapis.com. Elige una URL base por entorno, guárdala como configuración y no codifiques una mezcla de orígenes en el mismo servicio.

    Grupos abstractos de nodos regionales enrutando a través de una pasarela central de ToAPIs hacia una ruta de generación de imágenes

    Figura 1: mantén los clientes en un único origen documentado de ToAPIs, reutiliza la sesión y trata la generación de imágenes como una tarea asíncrona en lugar de un viaje síncrono de larga distancia.

    Hábitos prácticos de enrutamiento que no dependen de cifras de latencia no publicadas:

    • Un origen por entorno. Un servicio en Singapur y otro en Fráncfort pueden compartir el mismo ID de modelo y payload. No deberían inventar sus propias URL de proveedor.
    • Reutiliza conexiones. Activa HTTP keep-alive (y HTTP/2 donde tu cliente ya lo soporte) para que el establecimiento de TLS no se repita en cada envío o consulta.
    • Desacopla el envío de la espera. Guarda el id de la tarea de inmediato. Consulta con un intervalo acotado, o mejor usa un webhook de tareas y mantén la consulta como respaldo.
    • No cachees "prompts idénticos" como atajo de facturación. No hay garantía documentada de ToAPIs de que un prompt repetido se sirva desde una caché del edge o sea gratuito. Si se envían dos tareas, preve pagar dos tareas, salvo que los términos de tu cuenta digan otra cosa.

    El contrato de solicitud actual también se queda obsoleto con facilidad. Algunos fragmentos antiguos envían size como 1024x1024 y un flag quality: "standard". La referencia actual de la API de gpt-image-2 y el contrato del frontend de ToAPIs usan size para la relación de aspecto (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 o auto) y resolution para el nivel (1k, 2k, 4k). El gpt-image-2 exacto no expone un campo quality en el contrato actual del playground; quality aparece en ID como gpt-image-2-vip. Confirma el ID que realmente llamas.

    Las imágenes de referencia van en reference_images (solo URL públicas, hasta 14). image_urls se acepta como alias retrocompatible y se normaliza a reference_images. No envíes base64; sube primero. Para proporciones personalizadas, más opciones de calidad o comportamiento de SKU oficial, consulta la guía de la API y la guía del modelo.


    3. Implementación en producción: cURL y Python

    Paso 1: envío con 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"
      }'
    

    Paso 2: helper de Python para enviar y consultar

    Ajusta los nombres de campo y el envoltorio de respuesta a la referencia de la API de tu cuenta. El fragmento usa la ruta de estado de imagen documentada y los estados completed / failed. Cambia BASE a https://toapis.cn solo para un entorno de China continental que deba usar ese origen.

    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))
    

    Guarda la URL base, el ID de modelo, size y resolution junto al registro de la tarea. Si más adelante cambias un cliente de gpt-image-2 a gpt-image-2-vip o a una SKU de 2.6, cambia una variable a la vez y vuelve a leer la guía correspondiente: las unidades de facturación no son automáticamente las mismas.


    4. Gestión de errores y matriz de estados

    Las categorías siguientes son puntos de partida para el diagnóstico, no una garantía de códigos de error exactos de ToAPIs. Una consulta HTTP correcta todavía requiere que leas el status de la tarea.

    Estado HTTPCategoría habitualAcción recomendada
    400Campo inválido o combinación no admitidaComprueba el ID de modelo, que size sea una proporción documentada, que resolution sea 1k / 2k / 4k y que las imágenes de referencia sean URL en lugar de base64
    401Clave de API ausente o inválidaRota la clave en el panel de ToAPIs y confirma la cabecera Authorization
    429Límite de tarifa o de concurrenciaRespeta Retry-After cuando esté presente; aplica backoff con jitter; reintenta solo cuando sea seguro
    5xx o timeout de redProblema temporal de la pasarela o del upstreamComprueba el estado de la tarea antes de reenviar; usa una política de reintentos acotada

    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. Precios y ROI con FinOps

    Costo estimado=imaˊgenes facturables exitosas×tarifa actual de la cuenta para ese modelo, taman˜o y resolucioˊn\text{Costo estimado} = \text{imágenes facturables exitosas} \times \text{tarifa actual de la cuenta para ese modelo, tamaño y resolución}Costo estimado=imaˊgenes facturables exitosas×tarifa actual de la cuenta para ese modelo, taman˜o y resolucioˊn

    • No reutilices precios unitarios de borradores de planificación ni de artículos antiguos. Las tarifas del catálogo, los multiplicadores por resolución y el tratamiento de tareas fallidas varían según la SKU y la cuenta. Algunos ID de GPT Image 2.x se facturan por imagen; la guía de 2.6 documenta la facturación por tokens para esa generación. Confirma la tarifa aplicable al ID de modelo exacto que llamas.
    • El enrutamiento no cambia por sí mismo el precio del modelo. Usar api.toapis.com o toapis.cn es una elección de URL base. No es un descuento documentado. Las ganancias de FinOps vienen de evitar envíos duplicados tras un timeout del cliente, hacer borradores en 1k y elegir la SKU correcta.
    • Los contratos oficiales del proveedor suelen añadir restricciones regionales de facturación, compromisos o mínimos de prepago. La facturación de ToAPIs suele ser de pago por uso: confirma los términos activos en tu cuenta.
    • Para una discusión de tarifas más profunda, usa el artículo de precios de GPT Image 2 como contexto y luego verifica cada cifra contra el catálogo en vivo antes de incluirla en una previsión.

    6. Preguntas frecuentes

    Consulta el bloque FAQ de la cabecera. Resumen: cambiar el origen de ToAPIs no cambia el ID de modelo ni la forma documentada de la solicitud; los usuarios de China continental deben seguir la nota sobre toapis.cn en la documentación oficial; las tareas de imagen son asíncronas; size es una relación de aspecto y resolution es el nivel; no hay una caché del edge gratuita documentada para prompts repetidos.


    7. Lista de acciones

    • Crea una clave en el Portal de desarrolladores de ToAPIs.
    • Define una URL base por entorno (https://api.toapis.com o, cuando sea necesario, https://toapis.cn) y prueba el fragmento cURL con gpt-image-2, size: "1:1" y resolution: "1k".
    • Guarda el id de la tarea, consulta GET /v1/images/generations/{id} con un plazo acotado y respeta Retry-After en 429.
    • Siguiente: la guía de la API GPT Image 2 para los parámetros, la guía de 2.6 si vas a cambiar de SKU, y el recorrido de créditos gratis si vas a abrir una cuenta nueva.

    Explora los modelos mencionados en este artículo

    OpenAIIMAGE

    GPT-Image-2

    Tarifa actual: 3 credits /request
    Guía del modeloProbar en la consolaObtener clave de API
    OpenAIIMAGE

    GPT-Image-2 VIP

    Tarifa actual: 3.38 credits /request
    Guía del modeloProbar en la consolaObtener clave de API

    Artículos relacionados

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

    Generar imágenes nativas en 4K con GPT Image 2: relaciones de aspecto y flujos de escalado

    Genera salida nativa en 4K con el contrato actual de GPT Image 2: define size como una relación de aspecto y resolution como 4k. No existe un flag upscale: true documentado, y el tamaño en píxeles del 4K depende de la proporción que elijas.

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

    Dominar el inpainting y el outpainting con la API de edición de imágenes de GPT Image 2

    Edita imágenes existentes con el contrato actual de GPT Image 2: cambios guiados por referencias en gpt-image-2 e inpainting con máscara en gpt-image-2-official, todo sobre el endpoint asíncrono de generaciones.

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

    Guía completa de la API GPT Image 2: parámetros, especificaciones oficiales y ejemplos en Python

    Guía de integración para desarrolladores de la API GPT Image 2. Aprende a ajustar parámetros, usar resoluciones HD, controlar la relación de aspecto, aplicar inpainting e implementar en Python y Node.js.

    TO
    ToAPIs Engineering & Evaluation Team
    #GPT Image 2
    ToAPIs
    InicioToAPIs
    Pasarela empresarial de API de IA. Accede a GPT-5, Claude, Gemini y más de 200 modelos mediante una única API unificada.

    Modelos populares

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Mostrar másMostrar menos
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • Todos los modelos

    Categorías de API

    • API de imagen con IA
    • API de vídeo con IA
    • API texto a vídeo
    • API imagen a vídeo
    Mostrar másMostrar menos
    • API de edición de imágenes con IA
    • API de LLM y razonamiento
    • Todas las herramientas API →

    Alternativas

    Alternativas
    • Alternativa a Kie.ai
    • Alternativa a Fal.ai
    • Alternativa a OpenRouter
    • Alternativa a Replicate
    • Alternativa a Wavespeed AI
    • Todas las comparativas →

    Guías destacadas

    Guías destacadas
    • Precios de Seedance 2.0 y 2.5
    • Guía de la API Seedance más económica
    • Guía de integración de MiniMax H3
    • Clave de API gratuita de Seedance 2
    • Inicio rápido de la API Seedance 2
    • Todos los artículos técnicos →

    Desarrolladores y plataforma

    Desarrolladores y plataforma
    • Documentación de API
    • MCP
    • Precios
    • Área de pruebas de modelos
    • LLMs.txt
    • Contactar con soporte
    • Directorio de guías de modelos
    Entidad operadora:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Domicilio social:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    PrivacidadTérminosUso aceptableEliminación de datosConservación de datosSubencargados y regionesFacturación y reembolsosPolítica de cookiesMapa del sitioAcerca de

    © 2026 ToAPIs. Todos los derechos reservados.