Ga naar de inhoud

Mage API · Beeldmodel

Mango API

Onze vlaggenschipfamilie voor afbeeldingen

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

In één oogopslag

De Mango API draait Mango 4 en 5 andere varianten via Mage op POST https://api.mage.space/v1/mango/generate. Een verzoek met de standaardinstellingen kost 42 Gems (ongeveer $0,042), zonder abonnement. Mango ondersteunt opgeslagen personages en referenties via @handle in de prompt.

  • AfbeeldingUitvoer
  • 6Varianten
  • 42Gems per afbeelding, standaard
  • $0.042Ongeveer, in USD

Overzicht

Wat de Mango API doet

Onze afbeeldingsfamilie voor consistente personages, precieze bewerkingen en scènes die uit veel referenties of Characters zijn samengevoegd. Mango 4 voert de familie aan, met het meest levensechte licht en de meest levensechte huid en de scherpste kleine tekst; Mango 3 Turbo maakt snel schetsen voor een vast bedrag, referenties inbegrepen, en Mango 3S haalt 3K.

De vlaggenschipfamilie voor afbeeldingen van Mage, voor consistente personages, precieze bewerkingen en scènes die uit veel referenties zijn samengevoegd. Mango 4 (`mango-v4`) is de standaard en de nieuwste, met het meest levensechte licht en de meest levensechte huid en de scherpste kleine tekst; Mango 3 (`mango-v3`) is het vorige vlaggenschip; Mango 3 Turbo (`mango-v3-turbo`) maakt snel schetsen voor een vast bedrag, referenties inbegrepen, en Mango 3S (`mango-v3s`) haalt 3K.

Accepteert image, additional_images als invoer.

Snel starten

Roep de Mango API aan

Stel MAGE_API_KEY in, verstuur naar /mango/generate en poll status_url totdat het verzoek klaar is.

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

Modellen

Mango model_id-waarden

Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.

model_idNaamStandaard
mangoMango
mango-v2Mango 2
mango-v3sMango 3S
mango-v3Mango 3
mango-v3-turboMango 3 Turbo
mango-v4Mango 4Ja

Opties

Mango-parameters

Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.

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

Invoer

Mediainvoer die Mango accepteert

Stuur elk als https-URL, data-URL of upload tot 100 MB.

VeldRol
imageDe referentieafbeelding.
additional_imagesExtra referentieafbeeldingen.

Meer beeldmodellen

Andere API's voor beeldgeneratie op Mage

FAQ

Veelgestelde vragen

Wat kost de Mango API?
Een Mango-verzoek met de standaardinstellingen (Mango 4) kost 42 Gems, ongeveer $0,042. Andere resoluties, duur en varianten veranderen de prijs; in het antwoord staat het exacte bedrag. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.
Wat is het endpoint van de Mango API?
POST https://api.mage.space/v1/mango/generate met een Authorization: Bearer-header met je Mage API-sleutel. De respons bevat een status_url die je pollt voor het resultaat.
Welke Mango-modellen kan ik aanroepen?
mango (Mango), mango-v2 (Mango 2), mango-v3s (Mango 3S), mango-v3 (Mango 3), mango-v3-turbo (Mango 3 Turbo), mango-v4 (Mango 4). De standaard is Mango 4.
Ondersteunt Mango referentieafbeeldingen of personages?
Mango accepteert image, additional_images. Mango accepteert opgeslagen personages en referenties via @handle in de prompt.
Kan ik Mango gebruiken vanuit Claude of ChatGPT?
Ja. Verbind de Mage MCP-server met Claude, ChatGPT, Claude Code, Grok of Cursor en vraag bij naam naar Mango. Je assistent leest de opties uit met get_model en noemt de prijs voordat er iets wordt gegenereerd.
Hoe lang worden Mango-resultaten bewaard?
Resultaten en invoer worden 30 dagen bewaard. Download alles wat je wilt houden naar je eigen opslag.

Begin met bouwen met Mage

Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.

CharactersCommunity