Vai al contenuto

API di Mage · Modello per immagini

API di Mango

La nostra famiglia di modelli di immagini di punta

POST https://api.mage.space/v1/mango/generate

In breve

L'API Mango esegue Mango 4 e altre 5 varianti tramite Mage all'indirizzo POST https://api.mage.space/v1/mango/generate. Una richiesta con le impostazioni predefinite costa 42 Gems (circa 0,042 $), senza abbonamento. Mango supporta i personaggi salvati e i riferimenti tramite @handle nel prompt.

  • ImmagineOutput
  • 6Varianti
  • 42Gems per immagine, predefinito
  • $0.042Circa, in USD

Panoramica

Cosa fa l'API di Mango

La nostra famiglia di modelli per immagini con personaggi coerenti, modifiche precise e scene create unendo più riferimenti o Characters. Mango 4 guida la famiglia, con la luce e la pelle più realistiche e il testo piccolo più nitido; Mango 3 Turbo crea bozze a prezzo fisso, riferimenti inclusi, e Mango 3S arriva a 3K.

La famiglia di modelli per immagini di punta di Mage, per personaggi coerenti, modifiche precise e scene create unendo più riferimenti. Mango 4 (`mango-v4`) è il modello predefinito e il più recente, con la luce e la pelle più realistiche e il testo piccolo più nitido; Mango 3 (`mango-v3`) è il precedente modello di punta; Mango 3 Turbo (`mango-v3-turbo`) crea bozze a prezzo fisso, riferimenti inclusi, 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-v4"
}' | 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-v4',
});

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-v4",
})

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_idNomePredefinito
mangoMango
mango-v2Mango 2
mango-v3sMango 3S
mango-v3Mango 3
mango-v3-turboMango 3 Turbo
mango-v4Mango 4Sì

Opzioni

Parametri di Mango

Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.

CampoValori
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Input

Input multimediali accettati da Mango

Invia ciascuno come URL https, data URL o upload fino a 100 MB.

CampoRuolo
imageL'immagine di riferimento.
additional_imagesImmagini di riferimento aggiuntive.

Altri modelli di immagini

Altre API di generazione di immagini su Mage

FAQ

Domande frequenti

Quanto costa l'API di Mango?
Una richiesta Mango con le impostazioni predefinite (Mango 4) costa 42 Gems, circa 0,042 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica l'addebito esatto. Se una generazione non riesce, ti viene rimborsata; se viene 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), mango-v4 (Mango 4). Il modello predefinito è Mango 4.
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.

CharactersCommunity