Vai al contenuto principale

1. Ottenere l’API Key

Apri l’elenco delle applicazioni di Ace Data Cloud, accedi a un’applicazione disponibile e copia l’API Key. Ottenere l'API Key di Ace Data Cloud

2. Inviare la prima richiesta

L’immagine della risposta riuscita si trova in data[].url. Di seguito è riportato il risultato 1024×1536 ottenuto tramite una richiesta effettiva su Ace Data Cloud l’8 settembre 2026 (attività d56455e2-e7f7-4bcd-b935-475b0a1e0948, trace eb938601-8192-407f-b539-1e0554b697ec): Tazza bianca generata da GPT Image 2

3. Parametri comuni

Dimensioni comuni: size: "auto" seleziona il formato in base al rapporto, ai pixel e all’intento di impaginazione nel prompt; quando sono necessari pixel precisi, inserisci direttamente le dimensioni.

Modelli e modalità di fatturazione

Il prezzo visualizzato per il canale API ufficiale è una stima prima della richiesta; il risultato finale si basa sull’effettivo utilizzo di Token nella risposta e sui registri di utilizzo.

4. Generazione multipla

gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst e gpt-image-2:reverse sono fatturati in base al numero di immagini riuscite; gpt-image-2:official, gpt-image-2.5-flare:official e gpt-image-2.5-sunburst:official sono fatturati in base ai Token effettivi di input testuale e output immagine nella risposta. Il prezzo visualizzato è una stima prima della richiesta; il risultato finale si basa sui registri di utilizzo.

5. Callback asincrono

Dopo aver aggiunto callback_url al corpo della richiesta, l’interfaccia restituisce prima {"task_id": "..."} e invia il risultato finale tramite POST a quell’URL al completamento; le richieste sincrone restituiscono comunque created e data:
Il destinatario del callback deve usare task_id per eliminare i duplicati e verificare l’origine della richiesta e il formato dei dati.

6. Risoluzione dei problemi

La risposta di errore include error.code, error.message e trace_id. Quando segnali un problema, fornisci trace_id, non fornire l’API Key. Per i campi completi e le enumerazioni in tempo reale, fai riferimento alla pagina OpenAI Images Generations API. Per la modifica delle immagini, consulta Modifica immagini GPT Image 2 / 2.5.