1. Ottenere l’API Key
Apri l’elenco delle applicazioni di Ace Data Cloud, accedi a un’applicazione disponibile e copia l’API Key.
2. Inviare la prima richiesta
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):
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 aggiuntocallback_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:
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.
