Přeskočit na obsah

Mage API · Model pro obrázky

Nano Banana 2 API

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

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

Stručně

Nano Banana 2 API spouští Nano Banana 2.1 a 1 další variantu přes Mage na POST https://api.mage.space/v1/nano_banana_v2/generate. Požadavek s výchozím nastavením stojí 51 Gems (asi 0,051 $), bez předplatného. Nano Banana 2 přijímá uložené postavy a reference přes @handle v promptu.

  • ObrázekVýstup
  • 2Varianty
  • 51Gems za obrázek, výchozí
  • $0.051Přibližně v USD

Přehled

Co umí Nano Banana 2 API

Obrazové modely od Googlu pro grafiku a marketingový obsah s čitelným textem. Nano Banana 2.1 je v rodině na špici; oba generují nebo upravují až ze 14 referenčních obrázků až ve 4K. Platí bezpečnostní filtr Googlu.

Modely Nano Banana od Googlu pro grafiku s čitelným textem a úpravy až ze 14 referenčních obrázků, až do 4K. Nano Banana 2.1 (`nano-banana-v2.1`), výchozí, stojí méně; Nano Banana 2 (`nano-banana-v2`) umí vykreslovat i v 512. Platí bezpečnostní filtr Googlu.

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

Rychlý start

Volání Nano Banana 2 API

Nastav MAGE_API_KEY, odešli požadavek na /nano_banana_v2/generate a opakovaně kontroluj status_url, dokud se požadavek nedokončí.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/nano_banana_v2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "1:1",
  "model_id": "nano-banana-v2.1"
}' | 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('nano_banana_v2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '1:1',
  model_id: 'nano-banana-v2.1',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("nano_banana_v2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "1:1",
    "model_id": "nano-banana-v2.1",
})

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

Modely

Hodnoty model_id pro Nano Banana 2

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

model_idNázevVýchozí
nano-banana-v2Nano Banana 2
nano-banana-v2.1Nano Banana 2.1Ano

Možnosti

Parametry Nano Banana 2

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_ratio1:1, 3:2, 2:3, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9
resolution512, 1K, 2K, 4K

Vstupy

Vstupní média, která Nano Banana 2 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í Nano Banana 2 API?
Požadavek na Nano Banana 2 s výchozím nastavením (Nano Banana 2.1) stojí 51 Gems, tedy asi 0,051 $. Jiná rozlišení, délky a varianty cenu mění; přesnou částku najdeš v odpovědi. Gems za neúspěšné generování se vrací, za generování zablokované zásadami obsahu Mage ne.
Jaký je endpoint Nano Banana 2 API?
POST https://api.mage.space/v1/nano_banana_v2/generate s hlavičkou Authorization: Bearer, která obsahuje tvůj API klíč Mage. Odpověď obsahuje status_url, na kterém si výsledek vyzvedneš.
Které modely Nano Banana 2 můžu volat?
nano-banana-v2 (Nano Banana 2), nano-banana-v2.1 (Nano Banana 2.1). Výchozí je Nano Banana 2.1.
Podporuje Nano Banana 2 referenční obrázky nebo postavy?
Nano Banana 2 přijímá image, additional_images. Uložené postavy a reference můžeš do promptu vložit přes @handle.
Můžu Nano Banana 2 používat z Claude nebo ChatGPT?
Ano. Připoj server Mage MCP ke Claude, ChatGPT, Claude Code, Grok nebo Cursoru a požádej o Nano Banana 2 jménem. Asistent si přes get_model přečte jeho možnosti a před generováním oznámí cenu.
Jak dlouho se výsledky Nano Banana 2 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š.