Ugrás a tartalomhoz
PlaygroundDokumentációAPI-kulcs igénylése

Mage API · Képmodell

Mango API

Zászlóshajó képmodellcsaládunk

API-kulcs kérésePróbáld ki a Mango modellt a playgroundban
POST https://api.mage.space/v1/mango/generate

Dióhéjban

A Mango API a Mango 3 modellt és 4 másik változatot futtatja a Mage-en keresztül a POST https://api.mage.space/v1/mango/generate címen. Egy kérés az alapbeállításokkal 135 Gems (kb. $0,135), előfizetés nélkül. A Mango elmentett karaktereket és referenciákat fogad a promptban @handle-lel.

  • KépKimenet
  • 5Variánsok
  • 135Gem képenként, alapértelmezett
  • $0.135Körülbelül, USD-ben

Áttekintés

Mit tud a Mango API

Képmodellcsaládunk egységes karakterekhez, precíz szerkesztésekhez, valamint sok referenciából vagy Characters elemből összeállított jelenetekhez. A család éllovasa a Mango 3; a Mango 3 Turbo a leggyorsabb és legolcsóbb, a Mango 3S pedig eléri a 3K-t.

A Mage zászlóshajó képmodellcsaládja egységes karakterekhez, precíz szerkesztésekhez és sok referenciából összeállított jelenetekhez. A Mango 3 (`mango-v3`) az aktuális modell; a Mango 3 Turbo (`mango-v3-turbo`) a leggyorsabb és legolcsóbb, a Mango 3S (`mango-v3s`) pedig eléri a 3K-t.

Bemenetként az image és az additional_images mezőket fogadja.

Gyors kezdés

A Mango API meghívása

Állítsd be a MAGE_API_KEY-t, küldd el a kérést a /mango/generate végpontra, és kérdezd le a status_url-t, amíg a kérés be nem fejeződik.

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

Modellek

Mango model_id értékek

Küldj model_id-t a változat kiválasztásához. Ha nincs megadva, az alapértelmezett fut.

model_idNévAlapértelmezett
mangoMango
mango-v2Mango 2
mango-v3sMango 3S
mango-v3Mango 3Igen
mango-v3-turboMango 3 Turbo

Beállítások

Mango paraméterek

Az összes változatra megengedett értékek; egy változat kevesebbet kínálhat. A dokumentáció változatonként felsorolja a lehetőségeket.

MezőÉrtékek
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Bemenetek

A Mango által fogadott médiabemenetek

Mindegyiket küldheted https URL-ként, data URL-ként vagy legfeljebb 100 MB-os feltöltésként.

MezőSzerep
imageA referenciakép.
additional_imagesTovábbi referenciaképek.

További képmodellek

További képgeneráló API-k a Mage-en

GYIK

Gyakran ismételt kérdések

Mennyibe kerül a Mango API?
Egy Mango kérés az alapbeállításokkal (Mango 3) 135 Gems, kb. $0,135. Más felbontások, időtartamok és változatok módosítják az árat; a válasz megadja a pontos díjat. A sikertelen generálást visszatérítjük; azt, amelyet a Mage tartalmi szabályzata blokkol, nem.
Mi a Mango API végpontja?
POST https://api.mage.space/v1/mango/generate, az Authorization: Bearer fejlécben a Mage API-kulcsoddal. A válasz tartalmaz egy status_url-t, amelyet lekérdezhetsz az eredményért.
Mely Mango modelleket hívhatom meg?
mango (Mango), mango-v2 (Mango 2), mango-v3s (Mango 3S), mango-v3 (Mango 3), mango-v3-turbo (Mango 3 Turbo). Az alapértelmezett a Mango 3.
Támogatja a Mango a referenciaképeket vagy a karaktereket?
A Mango ezeket fogadja: image, additional_images. A Mango elmentett karaktereket és referenciákat fogad a promptban @handle-lel.
Használhatom a Mango modellt Claude-ból vagy ChatGPT-ből?
Igen. Csatlakoztasd a Mage MCP szervert Claude-hoz, ChatGPT-hez, Claude Code-hoz, Grokhoz vagy Cursorhoz, és kérd név szerint a Mango modellt. Az asszisztensed a get_model segítségével olvassa ki a beállításait, és generálás előtt megmondja az árat.
Meddig őrzik meg a Mango eredményeket?
Az eredményeket és a bemeneteket 30 napig őrizzük. Amit meg szeretnél tartani, töltsd le a saját tárhelyedre.

Kezdj el építeni a Mage-dzsel

Egy fiók, egy Gems-egyenleg, az összes modell. Csak azért fizetsz, amit legenerálsz.

API-kulcs kérésePróbáld ki a Mango modellt a playgroundban