Treci la conținut

Mage API · Model de imagine

API Mango

Familia noastră principală de modele de imagini

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

Pe scurt

API-ul Mango rulează Mango 3 și alte 4 variante prin Mage la POST https://api.mage.space/v1/mango/generate. O cerere cu setările implicite costă 135 Gems (aproximativ 0,135 USD), fără abonament. Mango acceptă personaje salvate și referințe prin @handle în prompt.

  • ImagineRezultat
  • 5Variante
  • 135Gems per imagine, implicit
  • $0.135Aproximativ, în USD

Prezentare generală

Ce face API-ul Mango

Familia noastră de modele de imagini pentru personaje consecvente, editări precise și scene îmbinate din multe referințe sau Characters. Mango 3 conduce familia; Mango 3 Turbo este cel mai rapid și mai ieftin, iar Mango 3S ajunge la 3K.

Familia principală de modele de imagini de la Mage, pentru personaje consecvente, editări precise și scene îmbinate din multe referințe. Mango 3 (`mango-v3`) este modelul actual; Mango 3 Turbo (`mango-v3-turbo`) este cel mai rapid și mai ieftin, iar Mango 3S (`mango-v3s`) ajunge la 3K.

Acceptă ca intrări image, additional_images.

Pornire rapidă

Apelează API-ul Mango

Setează MAGE_API_KEY, trimite cererea la /mango/generate și interoghează status_url până când cererea se finalizează.

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"])

Modele

Valorile model_id pentru Mango

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
mangoMango
mango-v2Mango 2
mango-v3sMango 3S
mango-v3Mango 3Da
mango-v3-turboMango 3 Turbo

Opțiuni

Parametrii Mango

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Intrări

Fișiere media acceptate de Mango

Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.

CâmpRol
imageImaginea de referință.
additional_imagesImagini de referință suplimentare.

Mai multe modele de imagini

Alte API-uri de generare de imagini pe Mage

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul Mango?
O cerere Mango cu setările implicite (Mango 3) costă 135 Gems, aproximativ 0,135 USD. Alte rezoluții, durate și variante modifică prețul; răspunsul indică costul exact. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpoint-ul API-ului Mango?
POST https://api.mage.space/v1/mango/generate cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi pentru rezultat.
Ce modele Mango pot apela?
mango (Mango), mango-v2 (Mango 2), mango-v3s (Mango 3S), mango-v3 (Mango 3), mango-v3-turbo (Mango 3 Turbo). Modelul implicit este Mango 3.
Mango acceptă imagini de referință sau personaje?
Mango acceptă image, additional_images. Mango acceptă personaje salvate și referințe prin @handle în prompt.
Pot folosi Mango din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Mango pe nume. Asistentul tău își citește opțiunile cu get_model și îți spune prețul înainte să genereze.
Cât timp sunt păstrate rezultatele Mango?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.