Come usare GPT-Image-2 — tramite API, non ChatGPT, e quanto costa per immagine

GPT-Image-2 (gpt-image 2) è il modello di generazione di immagini più recente di OpenAI e può essere utilizzato in due modi. Puoi chiederne l’uso in linguaggio naturale nell’app ChatGPT, entro i limiti del piano ChatGPT, oppure chiamarlo tramite API con fatturazione a consumo per immagine. Con l’API, tramite Kunavo, basta pagare $0,0633 per immagine, sostituire base_url dell’SDK OpenAI con https://api.kunavo.com/v1, specificare gpt-image-2 e chiamare POST /v1/images/generations. Per modificare immagini esistenti usa gpt-image-2-edit con POST /v1/images/edits. L’utilizzo in ChatGPT e la fatturazione API sono separati; i piani a pagamento di ChatGPT non includono l’utilizzo dell’API.

La maggior parte dei risultati di ricerca in giapponese riguarda i passaggi nell’interfaccia di ChatGPT o siti esterni che offrono prove gratuite. Questa pagina copre ciò che viene dopo: il costo per immagine quando si usa l’API, codice pronto da copiare ed eseguire e l’endpoint di editing; chiarisce anche quando è più adatta l’app ChatGPT.

Usare ChatGPT o l’API

Se devi creare solo poche immagini ogni tanto, l’app ChatGPT è più semplice. Non servono né codice né chiavi e puoi correggere il risultato conversando, ad esempio “rendilo un po’ più luminoso”. Poiché il numero di utilizzi e le condizioni dei piani cambiano spesso sul lato OpenAI, qui non riportiamo numeri. L’API diventa utile quando devi creare decine o centinaia di immagini nello stesso formato, generare immagini all’interno del tuo servizio o conoscere il costo per immagine.

Come usarlo in ChatGPT (in breve)

Nella casella della chat di ChatGPT, descrivi semplicemente l’immagine che vuoi creare. Allegando un’immagine e chiedendo “cambia lo sfondo”, la richiesta diventa un editing. Più specifichi composizione, luce, utilizzo (banner, foto di prodotto e così via) e testo da inserire nell’immagine, più il risultato si avvicinerà all’obiettivo. Questo modo di scrivere i prompt può essere usato invariato anche nelle chiamate API.

Come usarlo con l’API — 3 passaggi

1. Crea una chiave. Dopo la registrazione, emetti da /app/keys una chiave che inizia con sk-kn-. La chiave viene mostrata una sola volta, quindi salvala subito.
2. Ricarica il saldo. Sistema prepagato a partire da $10. Nel checkout Stripe sono disponibili carte, incluse JCB, Apple Pay, Google Pay e Link. Il saldo non scade.
3. Cambia la destinazione dell’SDK OpenAI ed effettua la chiamata. Non serve un account OpenAI; nel codice esistente basta sostituire base_url e la chiave.

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   # files.kunavo.com の恒久的な URL。下の編集の例で使うので手元にも保存する
with open("wagashi.png", "wb") as f:
    f.write(requests.get(url, timeout=60).content)

Gli URL restituiti sono URL permanenti di files.kunavo.com e non scadono. La generazione con GPT-Image-2 richiede normalmente 15–60 secondi e, in modalità sincrona, Kunavo mantiene la connessione per un massimo di 540 secondi. Imposta il timeout del client su un valore leggermente superiore. Per grandi volumi, usa l’API asincrona aggiungendo "async": true (o webhook_url), quindi recupera il risultato con GET /v1/images/{id}. Dettagli nella documentazione dell’API immagini; per creare la chiave e fare la prima chiamata, consulta la guida rapida.

Parametri principali

Prezzi di GPT-Image-2 — quanto costa ogni immagine tramite API

I prezzi seguenti vengono visualizzati direttamente dal catalogo dei modelli di questo sito, quindi questa tabella cambia quando cambiano i prezzi.

Scegliendo 1K, 2K o 4K, al momento il prezzo è lo stesso: $0,0633 per immagine. I prezzi per risoluzione vengono visualizzati dal paragrafo sulla risoluzione della documentazione a partire dal catalogo. Anche la modifica (GPT-Image-2 Edit) costa $0,0633 per immagine. Le richieste non riuscite non vengono addebitate, ma le immagini rigenerate perché non soddisfacevano le aspettative sono generazioni riuscite e vengono quindi addebitate singolarmente.

Il prezzo quando si utilizza direttamente l'API di OpenAI è riportato nella pagina dei prezzi di OpenAI. Per confrontare i prezzi, assicurati di usare la stessa risoluzione e la stessa qualità per immagine. Il prezzo dei piani ChatGPT è una fatturazione separata da entrambe le API.

Modificare immagini — gpt-image-2-edit

Per rigenerare un'immagine esistente, usa POST /v1/images/edits. Passa l'immagine originale a image tramite un URL https o un URI base64 di data:, e quando ci sono più immagini di riferimento passale in un array a image_urls. Poiché la modifica viene inviata in formato JSON, qui la chiamiamo con 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"])

Se utilizzi più volte lo stesso file, caricalo una volta con POST /v1/files per ricevere un URL permanente di files.kunavo.com (fino a 25 MB). In seguito ti basta passare quell'URL a image.

Sinceramente — quando Kunavo non è la scelta giusta

L'API tramite Kunavo ti permette di iniziare con una sola chiave senza un account OpenAI, ma funziona su capacità condivisa. Non ci sono quote dedicate né uno SLA contrattuale. Per una scala che richiede una quota garantita o uno SLA, la scelta giusta è stipulare un contratto direttamente con OpenAI.

Inoltre, se vuoi creare solo qualche immagine al mese conversando, l'app ChatGPT è più semplice. Se il motivo per scegliere un'API non riguarda «numero di immagini», «integrazione» o «gestione dei costi», l'app è sufficiente.

Quando usare Nano Banana

Puoi chiamare altri modelli di immagini mantenendo la stessa chiave e lo stesso endpoint, cambiando soltanto la stringa di model. Se hai un volume elevato e dai priorità al prezzo unitario, scegli Nano Banana ($0,0273 per immagine); se dai priorità alla fedeltà alle istruzioni o al testo nelle immagini, scegli GPT-Image-2. Il modo più rapido per decidere è inviare lo stesso prompt a entrambi, 10 immagini per modello, e confrontare i risultati.

La spiegazione dettagliata in inglese è disponibile nella guida all'API GPT-Image-2 e in Nano Banana API; per i prezzi unitari dei modelli GPT di testo consulta Prezzi dell'API GPT, per la generazione video Come usare l'API Seedance e per i prezzi unitari di tutti i modelli la pagina dei prezzi.

Domande frequenti