Přeskočit na obsah

Mage API · Model pro obrázky

API Guava

Fotorealismus, který projde jako fotografie

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

Stručně

API Guava spouští Guava a 4 další varianty přes Mage na POST https://api.mage.space/v1/guava/generate. Požadavek s výchozím nastavením stojí 37 Gems (asi 0,037 $), bez předplatného. Guava umí používat uložené postavy a reference pomocí @handle v promptu.

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

Přehled

Co API Guava umí

Naše rodina fotorealistických modelů pro portréty, módu a produktové fotky s věrnou pokožkou, látkami a světlem. Přijímá reference nebo Characters, až do 2K.

Fotorealistická řada od Mage pro portréty, módu a produktové snímky, které projdou jako fotografie, s referenčními obrázky. Aktuální dvojice je Guava 2 a Guava 2 Pro.

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

Rychlý start

Volání Guava API

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/guava/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": "guava"
}' | 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('guava', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'guava',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("guava", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "guava",
})

print(request["result"]["url"])

Modely

Hodnoty model_id pro Guava

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

model_idNázevVýchozí
guavaGuavaAno
guava-proGuava Pro
guava-pro-v1-5Guava Pro 1.5
guava-2Guava 2
guava-2-proGuava 2 Pro

Možnosti

Parametry Guava

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

Vstupy

Mediální vstupy, které Guava 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

  • Obrázky · od 20 Gems

    HiDream API

    Rychlý a univerzální, s negativními prompty

  • Obrázky · od 20 Gems

    Krea 2 API

    Nádherná estetika během pár sekund

  • Obrázek · od 135 Gems

    Mango API

    Naše vlajková řada obrázkových modelů

  • Obrázek · od 51 Gems

    Nano Banana 2 API

    Ostrý, čitelný text až do 4K

  • Obrázek · od 15 Gems

    API SDXL Plus

    SDXL s opravenými obličeji a rukama

  • Obrázek · od 10 Gems

    Stable Diffusion v1.5 API

    Klasika za málo peněz

Časté dotazy

Často kladené otázky

Kolik stojí Guava API?
Požadavek na Guava ve výchozím nastavení (Guava) stojí 37 Gems, tedy asi 0,037 $. Jiná rozlišení, délky a varianty cenu mění; přesnou částku uvádí odpověď. Za neúspěšné generování dostaneš Gems zpět; za generování zablokované zásadami obsahu Mage ne.
Jaký je endpoint Guava API?
POST https://api.mage.space/v1/guava/generate s hlavičkou Authorization: Bearer obsahující tvůj API klíč Mage. Odpověď obsahuje status_url, na kterém se dotazuješ na výsledek.
Které modely Guava můžu volat?
guava (Guava), guava-pro (Guava Pro), guava-pro-v1-5 (Guava Pro 1.5), guava-2 (Guava 2), guava-2-pro (Guava 2 Pro). Výchozí je Guava.
Podporuje Guava referenční obrázky nebo postavy?
Guava přijímá image, additional_images. Guava bere uložené postavy a reference přes @handle v promptu.
Můžu používat Guava z Claude nebo ChatGPT?
Ano. Připoj server Mage MCP ke Claude, ChatGPT, Claude Code, Grok nebo Cursor a požádej o Guava jejím názvem. Tvůj asistent si přečte její možnosti přes get_model a před generováním uvede cenu.
Jak dlouho se výsledky Guava 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š.