API di Mage · Modello per immagini
API di GPT Image 2
Prompt precisi e testo leggibile
POST https://api.mage.space/v1/gpt_image_2/generateIn breve
L'API di GPT Image 2 esegue GPT Image 2 e altre 4 varianti tramite Mage su POST https://api.mage.space/v1/gpt_image_2/generate. Una richiesta con le impostazioni predefinite costa 9 Gems (circa 0,009 $), senza abbonamento. GPT Image 2 accetta personaggi salvati e riferimenti tramite @handle nel prompt.
- ImmagineOutput
- 5Varianti
- 9Gems per immagine, predefinito
- $0.009Circa, in USD
Panoramica
Cosa fa l'API di GPT Image 2
I modelli GPT Image di OpenAI, che seguono il prompt alla lettera e generano testo leggibile. Genera o modifica partendo da molte immagini di riferimento, oppure crea GIF animate con GPT Image 2.6. Si applica il filtro di sicurezza di OpenAI.
I modelli GPT Image di OpenAI per generare e modificare immagini: GPT Image 2, GPT Image 2.5 Flare e Sunburst, e GPT Image 2.6 Flare e Sunburst, che creano anche GIF animate. Si applica il filtro di sicurezza di OpenAI.
Accetta come input image, additional_images.
Guida rapida
Chiama l'API di GPT Image 2
Imposta MAGE_API_KEY, invia la richiesta a /gpt_image_2/generate e controlla status_url finché la richiesta non è completata.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "gpt-image-2"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('gpt_image_2', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'gpt-image-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("gpt_image_2", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "gpt-image-2",
})
print(request["result"]["url"])Modelli
Valori di model_id per GPT Image 2
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| gpt-image-2 | GPT Image 2 | Sì |
| gpt-image-2.5-flare | GPT Image 2.5 Flare | |
| gpt-image-2.5-sunburst | GPT Image 2.5 Sunburst | |
| gpt-image-2.6-flare | GPT Image 2.6 Flare | |
| gpt-image-2.6-sunburst | GPT Image 2.6 Sunburst |
Opzioni
Parametri di GPT Image 2
Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.
| Campo | Valori |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
| output_format | jpeg, gif |
Input
Input multimediali accettati da GPT Image 2
Invia ciascuno come URL https, data URL o upload fino a 100 MB.
| Campo | Ruolo |
|---|---|
| image | L'immagine di riferimento. |
| additional_images | Immagini di riferimento aggiuntive. |
Regole
Cosa applica l'API di GPT Image 2
- Ogni modello offre solo alcuni livelli di `quality`: un livello che il modello scelto non prevede viene rifiutato.
- Imposta `output_format` su `gif` con un modello GPT Image 2.6 per ottenere una GIF animata, con `frame_count` da 2 a 16 (predefinito 9) e `frame_duration_ms` da 20 a 2000 (predefinito 200). Gli altri modelli la rifiutano. `resolution` non si applica: ogni `aspect_ratio` ha una sola dimensione del fotogramma, intorno ai 640 pixel. Il risultato è un file `.gif` e il suo `type` resta `image`.
- Il prezzo di una GIF dipende da `quality` e dall'intervallo di fotogrammi in cui rientra (da 2 a 8, 9, da 10 a 12 o da 13 a 16), non dal singolo fotogramma. La tabella dei prezzi qui sotto mostra le immagini statiche: per una GIF controlla il prezzo nella stima dei costi.
- Una GIF su Mage, ad esempio un risultato precedente, usata come input immagine viene elaborata a partire dal primo frame. Una GIF proveniente da qualsiasi altra fonte viene rifiutata: gli input immagine devono essere JPEG o PNG.
Altri modelli di immagini
Altre API di generazione di immagini su Mage
API Grok Image
Grok Imagine, in due livelli
API Guava
Un fotorealismo che sembra una vera fotografia
API HiDream
Veloce e versatile, con prompt negativi
API di Krea 2
Estetica stupenda in pochi secondi
API Mango
La nostra famiglia di modelli immagine di punta
MiniMax H3 Image API
Immagini native da 16 megapixel, pesi aperti
FAQ
Domande frequenti
Quanto costa l'API di GPT Image 2?
Qual è l'endpoint dell'API di GPT Image 2?
Quali modelli GPT Image 2 posso chiamare?
GPT Image 2 supporta immagini di riferimento o personaggi?
Posso usare GPT Image 2 da Claude o ChatGPT?
Per quanto tempo vengono conservati i risultati di GPT Image 2?
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.