In breve
L'API di Mango esegue Mango 3 e altre 4 varianti tramite Mage su POST https://api.mage.space/v1/mango/generate. Una richiesta con le impostazioni predefinite costa 135 Gems (circa $0.135), senza abbonamento. Mango accetta personaggi salvati e riferimenti tramite @handle nel prompt.
Immagine
Output
5
Varianti
135
Gems per immagine, predefinito
$0.135
Circa, in USD
Panoramica
Cosa fa l'API di Mango
La nostra famiglia di modelli di immagini per personaggi coerenti, modifiche precise e scene create unendo molti riferimenti o Characters. Mango 3 guida la famiglia; Mango 3 Turbo è il più veloce ed economico, e Mango 3S arriva a 3K.
La famiglia di modelli di immagini di punta di Mage, per personaggi coerenti, modifiche precise e scene create unendo molti riferimenti. Mango 3 (`mango-v3`) è il modello attuale; Mango 3 Turbo (`mango-v3-turbo`) è il più veloce ed economico, e Mango 3S (`mango-v3s`) arriva a 3K.
Accetta come input image, additional_images.
Guida rapida
Chiama l'API di Mango
Imposta MAGE_API_KEY, invia la richiesta a /mango/generate e interroga status_url finché la richiesta non è completata.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/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": "mango-v3"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v3',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3",
})
print(request["result"]["url"])Modelli
Valori model_id di Mango
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| mango | Mango | |
| mango-v2 | Mango 2 | |
| mango-v3s | Mango 3S | |
| mango-v3 | Mango 3 | Sì |
| mango-v3-turbo | Mango 3 Turbo |
Opzioni
Parametri di Mango
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, 3K, 4K |
Input
Input multimediali accettati da Mango
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. |
Altri modelli di immagini
Altre API di generazione di immagini su Mage
Immagine · da 68 Gems
API Nano Banana 2
Testo nitido e leggibile, fino a 4K
Immagine · da 15 Gems
API di SDXL Plus
SDXL con volti e mani corretti
Immagine · da 10 Gems
API di Stable Diffusion v1.5
Il classico, a prezzo contenuto
Immagine · da 10 Gems
API di Stable Diffusion v3.5 Large
Lo Stable Diffusion che ascolta meglio
Immagine · da 10 Gems
API di Stable Diffusion XL
SDXL ottimizzato per il fotorealismo
Immagine · da 10 Gems
API di Z-Image
Il modello di immagini più veloce su Mage
FAQ
Domande frequenti
Quanto costa l'API di Mango?
Una richiesta a Mango con le impostazioni predefinite (Mango 3) costa 135 Gems, circa $0.135. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica l'addebito esatto. Una generazione non riuscita viene rimborsata; una bloccata dalla content policy di Mage no.
Qual è l'endpoint dell'API di Mango?
POST https://api.mage.space/v1/mango/generate con un header Authorization: Bearer che contiene la tua chiave API di Mage. La risposta include uno status_url da interrogare per ottenere il risultato.
Quali modelli di Mango posso chiamare?
mango (Mango), mango-v2 (Mango 2), mango-v3s (Mango 3S), mango-v3 (Mango 3), mango-v3-turbo (Mango 3 Turbo). Il modello predefinito è Mango 3.
Mango supporta immagini di riferimento o personaggi?
Mango accetta image, additional_images. Mango accetta personaggi salvati e riferimenti tramite @handle nel prompt.
Posso usare Mango da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Mango per nome. Il tuo assistente legge le opzioni con get_model e ti indica il prezzo prima di generare.
Per quanto tempo vengono conservati i risultati di Mango?
Risultati e input vengono conservati per 30 giorni. Scarica tutto ciò che vuoi tenere nel tuo spazio di archiviazione.
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.