Panoramica dell'API Image

APIMaster fornisce API per immagini sotto https://apimaster.ai/v1. L'image-to-image non utilizza un formato di input universale valido per tutti i modelli. Scegli prima il modello, poi usa l'endpoint documentato e i campi di riferimento specifici.

Guida ai modelli e agli endpoint

Modello	Text-to-image	Image-to-image	Guida
gpt-image-2	JSON /images/generations	Multipart /images/edits, file image / image[]	GPT Image 2 / 2.5
gpt-image-2.5-sunburst	JSON /images/generations	Multipart /images/edits, file image / image[]	GPT Image 2 / 2.5
gpt-image-2.5-flare	JSON /images/generations	Multipart /images/edits, file image / image[]	GPT Image 2 / 2.5
gemini-3.1-flash-image-preview	JSON /images/generations	JSON /images/generations con image_urls	Gemini Flash Image
gemini-nano-banana-2.1	JSON /images/generations	multipart /images/edits / JSON image_urls	Nano Banana 2.1
grok-imagine-image-2.0	JSON /images/generations	JSON /images/generations con image_urls (fino a 5)	Grok Imagine Image 2.0
doubao-seedream-5-0-pro-260628	JSON /images/generations	JSON /images/generations con image	Seedream 5.0 Pro
midjourney-v8.2	Async /midjourney/generations	Riferimenti JSON image_urls	Midjourney v8.2 / Niji 7
midjourney-niji-7	Async /midjourney/generations	Riferimenti JSON image_urls	Midjourney v8.2 / Niji 7

Per Grok Imagine Image 2.0, usa /images/generations in modalità sincrona con image_urls. I percorsi asincroni del client e /images/edits non sono supportati; consulta la guida di Grok Imagine Image 2.0.

Per le immagini di riferimento di GPT, carica file reali su /images/edits per ottenere una risposta immagine oppure su /images/edits/async per ottenere una risposta di tipo task; non copiare il formato JSON di Gemini o Seedream. Menzionare i riferimenti nel prompt non equivale a un caricamento. GPT Image 2.5 è una famiglia di modelli separata, non un alias di GPT Image 2.

Midjourney v8.2 e Niji 7 creano attività asincrone tramite /midjourney/generations; esegui il polling con GET /tasks/{task_id}. Consulta la guida di Midjourney v8.2 / Niji 7 per parametri ed esempi.

Autenticazione e risposte

• Crea una chiave nella console; invia Authorization: Bearer YOUR_API_KEY.
• Le chiamate di generazione JSON usano Content-Type: application/json. Per le modifiche multipart, lascia che il client HTTP generi il Content-Type e il boundary.
• Le risposte sincrone delle immagini contengono data[] con url o b64_json; gestisci entrambi i formati. Scarica tempestivamente gli URL temporanei.
• I campi opzionali, i limiti dei riferimenti, le dimensioni e i prezzi dipendono dal modello e dalla route disponibile. Consulta la guida del modello e il marketplace.

Lavoro asincrono

POST /images/generations/async, POST /images/edits/async e GET /tasks/{task_id}?model=MODEL_ID forniscono flussi di lavoro per immagini basati su task per i modelli supportati. Questa non è una modalità universale per ogni operazione sulle immagini:

• Per GPT Image 2, Sunburst e Flare, usa generations/async in JSON per il text-to-image e edits/async in multipart per la modifica. Carica gli stessi file delle modifiche sincrone, poi esegui il polling con l'account che ha inviato la richiesta e con lo stesso ID modello.
• La generazione o la modifica può terminare prima che l'invio asincrono restituisca un ID task; non dare per scontato che l'invio sia istantaneo. Non inviare nuovamente un task esistente mentre ne stai facendo il polling. Lo stato di completamento può essere succeeded, success o completed; i risultati tracciati usano una url di tipo stringa, mentre i risultati legacy possono contenere un array di URL.
• Gemini ha il proprio flusso di generazione asincrona; segui la sua guida per gli input di riferimento.
• Seedream 5.0 Pro usa le generazioni sincrone e non supporta /images/generations/async.

Consulta le guide dei modelli per esempi completi in cURL/Python, stati di polling e risoluzione dei problemi. Una risposta HTTP 200 da sola non verifica la fedeltà dell'immagine di riferimento.