Cómo usar GPT-Image-2 — mediante la API, no ChatGPT, y cuánto cuesta cada imagen

GPT-Image-2 (gpt-image 2) es el modelo de generación de imágenes más reciente de OpenAI y puede utilizarse de dos formas. Puede pedir imágenes mediante texto en la aplicación de ChatGPT (dentro de los límites de su plan) o llamar a la API por imagen con facturación basada en el uso. En la API, a través de Kunavo, basta con pagar $0.0633 por imagen, cambiar base_url del SDK de OpenAI por https://api.kunavo.com/v1, indicar gpt-image-2 y llamar a POST /v1/images/generations. Para editar imágenes existentes, use gpt-image-2-edit con POST /v1/images/edits. El uso de ChatGPT y la facturación de la API son independientes; los planes de pago de ChatGPT no incluyen el uso de la API.

Los resultados de búsqueda en japonés suelen limitarse a instrucciones para usar la interfaz de ChatGPT o a sitios externos para probarlo gratis. Esta página va más allá: reúne el precio por imagen al llamar mediante la API, código que puede copiar y ejecutar directamente y el endpoint de edición, y explica claramente cuándo conviene más la aplicación de ChatGPT.

Usar ChatGPT o la API

Si solo crea unas pocas imágenes ocasionalmente, la aplicación de ChatGPT es más sencilla. No necesita código ni claves y puede corregirla conversando, por ejemplo, «hazla un poco más luminosa». Como OpenAI suele cambiar los límites y condiciones de cada plan, no incluimos cifras aquí. La API resulta útil cuando necesita crear decenas o cientos de imágenes con el mismo formato, generar dentro de su propio servicio o conocer el coste por imagen.

Cómo usarlo en ChatGPT (brevemente)

Solo tiene que describir en el campo de chat de ChatGPT la imagen que quiere crear. Si adjunta una imagen y pide «cambia el fondo», se convierte en una edición. Cuanto más concretamente describa la composición, la luz, el uso (banner, foto de producto, etc.) y el texto que debe aparecer, más se acercará el resultado a lo que busca. Esta forma de escribir prompts también puede utilizarse tal cual al llamar a la API.

Cómo usar la API — 3 pasos

1. Cree una clave. Después de registrarse, emita en /app/keys una clave que empiece por sk-kn-. Solo se muestra una vez, así que guárdela en ese momento.
2. Recarga saldo. Prepago desde $10. En el checkout de Stripe puedes usar tarjetas, incluidas JCB, Apple Pay, Google Pay y Link. El saldo no caduca.
3. Cambie el destino del SDK de OpenAI y haga la llamada. No necesita una cuenta de OpenAI; si ya tiene código, basta con sustituir base_url y la clave.

import os
import requests
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],   # sk-kn-...
    base_url="https://api.kunavo.com/v1",   # 既存コードから変えるのはここだけ
    timeout=600,                            # 同期モードは最長 540 秒待つ
)

img = client.images.generate(
    model="gpt-image-2",
    prompt="白い机の上の和菓子、やわらかい自然光、真上から、余白を多めに",
    size="1024x1024",                  # 縦横比として解釈される
    extra_body={"resolution": "2K"},   # 1K / 2K / 4K（SDK の標準外なので extra_body）
)

url = img.data[0].url   # 約 24 時間で消える一時 URL — すぐ保存する
with open("wagashi.png", "wb") as f:
    f.write(requests.get(url, timeout=60).content)

Las URL devueltas son temporales y desaparecen en aproximadamente 24 horas, así que guárdelas al recibirlas, como se muestra arriba. La generación de GPT-Image-2 suele tardar entre 15 y 60 segundos y, en modo síncrono, Kunavo mantiene la conexión hasta 540 segundos. Configure el tiempo de espera del cliente por encima de ese valor. Para procesar grandes volúmenes, conviene usar la API asíncrona: añada "async": true (o webhook_url) y recupere el resultado mediante GET /v1/images/{id}. Encontrará más detalles en la documentación de la API de imágenes; desde la creación de la clave hasta la primera llamada, consulte el inicio rápido.

Parámetros principales

Precio de GPT-Image-2 — cuánto cuesta una imagen mediante la API

Los precios siguientes se obtienen directamente del catálogo de modelos de este sitio, por lo que la tabla también cambiará si cambian los precios.

Por ahora, elegir 1K, 2K o 4K cuesta lo mismo: $0.0633 por imagen. Los precios por resolución se muestran desde el catálogo en la sección de resolución de la documentación. La edición (GPT-Image-2 Edit) también cuesta $0.0633 por imagen. Las solicitudes fallidas no se facturan, pero las imágenes que regenere porque no le gustó el resultado son generaciones exitosas y se cobran una por una.

El precio de usar directamente la API de OpenAI aparece en la página de precios de OpenAI. Para comparar, iguale la resolución y la calidad por imagen. El precio de los planes de ChatGPT se factura por separado de ambas API.

Editar imágenes — gpt-image-2-edit

Para rehacer una imagen existente, use POST /v1/images/edits. Pase la imagen original a image como una URL https o una URI base64 de data:; si hay varias imágenes de referencia, páselas como un array a image_urls. Como la edición se envía en JSON, aquí la llamamos mediante requests.

import os
import base64
import requests

KEY = os.environ["KUNAVO_API_KEY"]

# 手元の画像を data: URI にする（https の URL をそのまま渡してもよい）
with open("wagashi.png", "rb") as f:
    src = "data:image/png;base64," + base64.b64encode(f.read()).decode()

r = requests.post(
    "https://api.kunavo.com/v1/images/edits",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
        "model": "gpt-image-2-edit",
        "prompt": "背景を藍色の和紙に変える。和菓子と構図はそのまま",
        "image": src,   # 参照画像が複数なら "image_urls": [...] に配列で
    },
    timeout=600,
)
print(r.json()["data"][0]["url"])

Si va a reutilizar el mismo archivo muchas veces, súbalo una vez mediante POST /v1/files y recibirá una URL permanente de files.kunavo.com (hasta 25 MB). Después solo tiene que pasar esa URL a image.

Con franqueza — cuándo no conviene Kunavo

La API a través de Kunavo permite empezar con una sola clave sin una cuenta de OpenAI, pero funciona con capacidad compartida. No hay una asignación exclusiva (cuota) ni un SLA contractual. Si necesita una cuota o un SLA garantizados a esa escala, lo correcto es contratar directamente con OpenAI.

Además, si solo crea unas pocas imágenes al mes mientras conversa, la aplicación de ChatGPT requiere menos esfuerzo. Si ninguna de estas razones —cantidad, integración o control del coste— justifica elegir la API, la aplicación es suficiente.

Cómo elegir frente a Nano Banana

Puede llamar a otros modelos de imagen con la misma clave y el mismo endpoint cambiando únicamente la cadena de model. Si necesita muchas imágenes y prioriza el precio unitario, elija Nano Banana ($0.0273 por imagen); si prioriza la fidelidad a las instrucciones o el texto dentro de la imagen, elija GPT-Image-2. La forma más rápida de decidir es generar diez imágenes con cada modelo usando el mismo prompt y comparar los resultados.

Para una explicación detallada en inglés, consulte la guía de la API de GPT-Image-2 y la API de Nano Banana; para los precios unitarios de los modelos GPT de texto, precios de la API de GPT; para la generación de vídeo, cómo usar la API de Seedance; y para los precios de todos los modelos, la página de precios.

Preguntas frecuentes