W skrócie
Mango API uruchamia Mango 3 i 4 inne warianty w Mage pod adresem POST https://api.mage.space/v1/mango/generate. Żądanie z ustawieniami domyślnymi kosztuje 135 Gems (około 0,135 USD), bez subskrypcji. Mango obsługuje zapisane postacie i referencje przez @handle w prompcie.
Obraz
Wynik
5
Warianty
135
Gems za obraz, domyślnie
$0.135
Około, w USD
Przegląd
Co potrafi Mango API
Nasza rodzina modeli obrazów do spójnych postaci, precyzyjnych edycji i scen łączących wiele referencji lub Characters. Mango 3 przewodzi rodzinie; Mango 3 Turbo jest najszybszy i najtańszy, a Mango 3S osiąga 3K.
Flagowa rodzina modeli obrazów Mage do spójnych postaci, precyzyjnych edycji i scen łączących wiele referencji. Mango 3 (`mango-v3`) to aktualny model; Mango 3 Turbo (`mango-v3-turbo`) jest najszybszy i najtańszy, a Mango 3S (`mango-v3s`) osiąga 3K.
Przyjmuje dane wejściowe: image, additional_images.
Szybki start
Wywołaj Mango API
Ustaw MAGE_API_KEY, wyślij żądanie na /mango/generate i odpytuj status_url, aż żądanie się zakończy.
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
Wartości model_id dla Mango
Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.
| model_id | Nazwa | Domyślny |
|---|---|---|
| mango | Mango | |
| mango-v2 | Mango 2 | |
| mango-v3s | Mango 3S | |
| mango-v3 | Mango 3 | Tak |
| mango-v3-turbo | Mango 3 Turbo |
Opcje
Parametry Mango
Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.
| Pole | Wartości |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K, 3K, 4K |
Dane wejściowe
Pliki multimedialne akceptowane przez Mango
Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.
| Pole | Rola |
|---|---|
| image | Obraz referencyjny. |
| additional_images | Dodatkowe obrazy referencyjne. |
Więcej modeli obrazów
Inne API do generowania obrazów w Mage
Obraz · od 68 Gems
Nano Banana 2 API
Wyraźny, czytelny tekst, do 4K
Obraz · od 15 Gems
API SDXL Plus
SDXL z poprawionymi twarzami i dłońmi
Obraz · od 10 Gems
Stable Diffusion v1.5 API
Klasyk w przystępnej cenie
Obraz · od 10 Gems
Stable Diffusion v3.5 Large API
Stable Diffusion, który najlepiej słucha poleceń
Obraz · od 10 Gems
Stable Diffusion XL API
SDXL dostrojony do fotorealizmu
Obraz · od 10 Gems
Z-Image API
Najszybszy model obrazów w Mage
FAQ
Najczęściej zadawane pytania
Ile kosztuje Mango API?
Żądanie Mango z ustawieniami domyślnymi (Mango 3) kosztuje 135 Gems, czyli około 0,135 USD. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę; dokładną opłatę podaje odpowiedź. Za nieudane generowanie zwracamy koszt, za zablokowane przez zasady treści Mage – nie.
Jaki jest endpoint Mango API?
POST https://api.mage.space/v1/mango/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz, aby pobrać wynik.
Jakie modele Mango mogę wywołać?
mango (Mango), mango-v2 (Mango 2), mango-v3s (Mango 3S), mango-v3 (Mango 3), mango-v3-turbo (Mango 3 Turbo). Domyślny jest Mango 3.
Czy Mango obsługuje obrazy referencyjne lub postacie?
Mango przyjmuje image, additional_images. Mango obsługuje zapisane postacie i referencje przez @handle w prompcie.
Czy mogę używać Mango w Claude lub ChatGPT?
Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Mango po nazwie. Twój asystent odczyta opcje modelu przez get_model i poda cenę przed wygenerowaniem.
Jak długo przechowywane są wyniki Mango?
Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.