Przejdź do treści

Mage API · Model obrazu

Nano Banana 2 API

Wyraźny, czytelny tekst, do 4K

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

W skrócie

Nano Banana 2 API uruchamia Nano Banana 2.1 i jeden inny wariant przez Mage pod adresem POST https://api.mage.space/v1/nano_banana_v2/generate. Zapytanie z ustawieniami domyślnymi kosztuje 51 Gems (ok. 0,051 $), bez subskrypcji. Nano Banana 2 obsługuje zapisane postacie i referencje wywoływane w prompcie przez @handle.

  • ObrazWynik
  • 2Warianty
  • 51Gems za obraz, domyślnie
  • $0.051Około, w USD

Przegląd

Co potrafi Nano Banana 2 API

Modele obrazów Google do grafik i treści marketingowych z czytelnym tekstem. Nano Banana 2.1 jest liderem rodziny; oba modele generują lub edytują obrazy na podstawie maksymalnie 14 obrazów referencyjnych w rozdzielczości do 4K. Obowiązuje filtr bezpieczeństwa Google.

Modele Nano Banana od Google do grafik z czytelnym tekstem i edycji na podstawie maksymalnie 14 obrazów referencyjnych, do 4K. Nano Banana 2.1 (`nano-banana-v2.1`), czyli model domyślny, kosztuje mniej; Nano Banana 2 (`nano-banana-v2`) renderuje też w rozdzielczości 512. Obowiązuje filtr bezpieczeństwa Google.

Przyjmuje dane wejściowe: image, additional_images.

Szybki start

Wywołanie API Nano Banana 2

Ustaw MAGE_API_KEY, wyślij żądanie do /nano_banana_v2/generate i odpytuj status_url, aż żądanie się zakończy.

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

Modele

Wartości model_id dla Nano Banana 2

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
nano-banana-v2Nano Banana 2
nano-banana-v2.1Nano Banana 2.1Tak

Opcje

Parametry Nano Banana 2

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
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

Dane wejściowe

Pliki wejściowe obsługiwane przez Nano Banana 2

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

PoleRola
imageObraz referencyjny.
additional_imagesDodatkowe obrazy referencyjne.

Więcej modeli obrazów

Inne API do generowania obrazów w Mage

FAQ

Najczęściej zadawane pytania

Ile kosztuje API Nano Banana 2?
Zapytanie do Nano Banana 2 z ustawieniami domyślnymi (Nano Banana 2.1) kosztuje 51 Gems, czyli ok. 0,051 $. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę; dokładną kwotę znajdziesz w odpowiedzi. Za nieudane generowanie zwracamy koszt; za to, które zablokuje polityka treści Mage, nie zwracamy.
Jaki jest endpoint API Nano Banana 2?
POST https://api.mage.space/v1/nano_banana_v2/generate z nagłówkiem Authorization: Bearer zawierającym twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz, aby pobrać wynik.
Które modele Nano Banana 2 mogę wywołać?
nano-banana-v2 (Nano Banana 2), nano-banana-v2.1 (Nano Banana 2.1). Domyślnie używany jest Nano Banana 2.1.
Czy Nano Banana 2 obsługuje obrazy referencyjne lub postacie?
Nano Banana 2 przyjmuje image, additional_images. Zapisane postacie i referencje możesz wywołać w prompcie przez @handle.
Czy mogę używać Nano Banana 2 w Claude lub ChatGPT?
Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Nano Banana 2 po nazwie. Asystent odczyta jego opcje przez get_model i poda cenę przed generowaniem.
Jak długo przechowywane są wyniki Nano Banana 2?
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.

CharactersSpołeczność