Uwierzytelnianie i URL bazowy
Uzyskaj dostęp do nano banana api, kierując klienta pod https://api.nanobananaapis.com/v1. Potrzebujesz ważnego klucza API w nagłówku Authorization. Zarejestruj się na stronie Pobierz klucz API podając tylko e-mail i hasło, aby natychmiast otrzymać klucz. Klucz jest wyświetlany natychmiast po rejestracji. Jeśli go zgubisz, wygeneruj ponownie nowy z panelu; stary klucz przestaje działać natychmiast.
Użyj Bearer YOUR_API_KEY w każdym zapytaniu. ID modelu to zawsze uncensored. Ten endpoint obsługuje tekst na wejściu i wyjściu. Nie generuje obrazów, audio ani wideo. Dla potoków multimodalnych użyj tego API do pisania promptów, generowania skryptów i postprodukcji.
Pierwsze zapytanie
Wyślij standardowe zapytanie o uzupełnienie czatu. API obsługuje format OpenAI. Zastąp YOUR_API_KEY swoim właściwym kluczem. Ten przykład wysyła prostą wiadomość do modelu bez cenzury.
curl https://api.nanobananaapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Odpowiedź zawiera wygenerowany tekst. Możesz sprawdzić zużycie tokenów w ciele odpowiedzi. Okno kontekstu wynosi łącznie 100 000 tokenów na prompt i wygenerowaną odpowiedź. Trzymaj się payloadów poniżej 8 MB.
Przykład SDK Python
Użyj oficjalnego SDK Python OpenAI. Ustaw URL bazowy na endpoint nanobananaapis. Przekaż swój klucz API jako api_key. Klient automatycznie sformatuje zapytania poprawnie. Ta metoda jest idealna dla skryptów backendowych przetwarzających tekst przed wysłaniem go do usługi generowania obrazów lub wideo.
from openai import OpenAI
client = OpenAI(base_url="https://api.nanobananaapis.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)SDK obsługuje za Ciebie strumieniowanie i parsowanie. Możesz iterować po chunkach, jeśli włączysz tryb strumieniowania. To podejście utrzymuje czysty kod i kompatybilność z innymi usługami OpenAI, jeśli zmienisz dostawcę.
Przykład SDK Node.js
SDK Node.js działa podobnie. Zainicjuj klienta swoim URL bazowym i kluczem. Wywołaj metodę chat.completions.create. Jest to przydatne dla funkcji serverless lub serwerów WWW generujących skrypty dynamicznie.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nanobananaapis.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Upewnij się, że poprawnie obsługujesz błędy. Typowe błędy obejmują błędy uwierzytelniania (401), jeśli klucz jest nieprawidłowy lub wygasł, oraz limity zapytań (429), jeśli przekroczysz 300 zapytań na minutę. Klucz API jest powiązany z Twoim kontem, więc chroń go w zmiennych środowiskowych.
Odpowiedzi strumieniowe
Włącz strumieniowanie, ustawiając stream: true w zapytaniu. API zwraca strumień Server-Sent Events (SSE). Każdy chunk zawiera część wygenerowanego tekstu. Jest to kluczowe dla aplikacji w czasie rzeczywistym lub przy generowaniu długich skryptów.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Parsuj zdarzenia SSE po stronie klienta. Strumień kończy się, gdy model zakończy generowanie lub osiągnie limit kontekstu. Strumieniowanie zmniejsza postrzeganą latencję dla użytkowników. Nie zmienia to cennika; nadal płacisz za token.
Limity, błędy i modele
Sprawdź dostępne modele przez GET /v1/models. Dostępny jest tylko model uncensored. Limit zapytań to 300 zapytań na minutę na klucz. Ciało zapytania musi być mniejsze niż 8 MB. Cena to $0,25 za 1M tokenów wejściowych i $1,00 za 1M tokenów wyjściowych. Kredyt nigdy nie wygasa. Jeśli się skończy, doładowaj od $10. Błędy: 401 za złe klucze, 402 za niewystarczający kredyt, 429 za przekroczenie limitu. Nie ma SLA ani gwarancji dostępności. Model blokuje treści seksualne z udziałem małoletnich. Nie odrzuca innych legalnych tematów dla dorosłych lub kontrowersyjnych.
