Přeskočit na obsah

Mage API · Model pro obrázky

Mango API

Naše vlajková rodina obrazových modelů

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

Stručně

Mango API spouští Mango 3 a další 4 varianty přes Mage na POST https://api.mage.space/v1/mango/generate. Požadavek s výchozím nastavením stojí 135 Gems (asi 0,135 $), bez předplatného. Mango přijímá uložené postavy a reference přes @handle v promptu.

  • ObrázekVýstup
  • 5Varianty
  • 135Gems za obrázek, výchozí
  • $0.135Přibližně v USD

Přehled

Co umí Mango API

Naše rodina obrazových modelů pro konzistentní postavy, přesné úpravy a scény složené z mnoha referencí nebo Characters. Mango 3 je v rodině na špici; Mango 3 Turbo je nejrychlejší a nejlevnější a Mango 3S dosahuje 3K.

Vlajková rodina obrazových modelů Mage pro konzistentní postavy, přesné úpravy a scény složené z mnoha referencí. Mango 3 (`mango-v3`) je aktuální model; Mango 3 Turbo (`mango-v3-turbo`) je nejrychlejší a nejlevnější a Mango 3S (`mango-v3s`) dosahuje 3K.

Jako vstupy přijímá image, additional_images.

Rychlý start

Volání Mango API

Nastav MAGE_API_KEY, odešli požadavek na /mango/generate a dotazuj se na status_url, dokud se požadavek nedokončí.

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

Modely

Hodnoty model_id pro Mango

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
mangoMango
mango-v2Mango 2
mango-v3sMango 3S
mango-v3Mango 3Ano
mango-v3-turboMango 3 Turbo

Možnosti

Parametry Mango

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

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

Vstupy

Mediální vstupy, které Mango přijímá

Každý pošli jako https URL, data URL nebo nahraj soubor o velikosti do 100 MB.

PoleRole
imageReferenční obrázek.
additional_imagesDalší referenční obrázky.

Další modely pro obrázky

Další API pro generování obrázků na Mage

Časté dotazy

Často kladené otázky

Kolik stojí Mango API?
Požadavek na Mango s výchozím nastavením (Mango 3) stojí 135 Gems, asi 0,135 $. Jiná rozlišení, délky a varianty cenu mění; přesnou částku uvádí odpověď. Za neúspěšné generování se platba vrací, za generování zablokované zásadami obsahu Mage ne.
Jaký je endpoint Mango API?
POST https://api.mage.space/v1/mango/generate s hlavičkou Authorization: Bearer obsahující tvůj API klíč Mage. Odpověď obsahuje status_url, na kterém si můžeš zjistit výsledek.
Které modely Mango můžu volat?
mango (Mango), mango-v2 (Mango 2), mango-v3s (Mango 3S), mango-v3 (Mango 3), mango-v3-turbo (Mango 3 Turbo). Výchozí je Mango 3.
Podporuje Mango referenční obrázky nebo postavy?
Mango přijímá image, additional_images. Mango přijímá uložené postavy a reference přes @handle v promptu.
Můžu Mango používat z Claude nebo ChatGPT?
Ano. Připoj Mage MCP server ke Claude, ChatGPT, Claude Code, Grok nebo Cursor a požádej o Mango jménem. Tvůj asistent si přes get_model přečte možnosti a před generováním uvede cenu.
Jak dlouho se výsledky Mango uchovávají?
Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.