Przejdź do głównej treści

​
Wprowadzenie

Nano Banana to usługa AI do generowania obrazów oferowana przez Ace Data Cloud, oparta na usłudze generowania obrazów Gemini. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Nano Banana za pomocą Pythona, realizując funkcje takie jak generowanie obrazów na podstawie tekstu, edycja obrazów, różne proporcje oraz wysoką rozdzielczość.

​
Wymagania wstępne

  • Konto w Ace Data Cloud oraz uzyskany token API
  • Środowisko Python 3.7 lub nowsze
  • Zainstalowana biblioteka requests: pip install requests

​
Podstawowe użycie

Główny endpoint API Nano Banana to: 
POST https://api.acedata.cloud/nano-banana/images
W tym przykładzie używamy modelu nano-banana-2. Dostępne modele to: nano-banana, nano-banana-2, nano-banana-pro. Pełny przykład kodu w Python: 
import requests

url = "https://api.acedata.cloud/nano-banana/images"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "action": "generate",
    "prompt": "A white siamese cat",
    "model": "nano-banana-2",
    "aspect_ratio": "1:1"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

​
Obsługa odpowiedzi

Po pomyślnym wywołaniu API zwraca dane w formacie JSON. Zaleca się sprawdzenie kodu statusu HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Wywołanie zakończone sukcesem:", result)
else:
    print(f"Wywołanie nie powiodło się, kod statusu: {response.status_code}")
    print(response.text)

​
Zaawansowane użycie

Dla API obsługujących zadania asynchroniczne można uzyskać wynik przez URL zwrotny (callback): 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Wynik zostanie przesłany na Twój serwer przez URL zwrotny

​
Obsługa błędów

Najczęściej występujące kody błędów:
Kod statusuOpis
401Nieautoryzowany, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczono limit zapytań
500Błąd wewnętrzny serwera

​
Inne endpointy

Usługa Nano Banana udostępnia również następujące endpointy:
  • POST https://api.acedata.cloud/nano-banana/tasks

​
Kolejne kroki