PL ▾

API tekstu bez cenzury do Twojego pipeline

Jak korzystać z przepływów API Nano Banana z tekstowym LLM

Ta strona nie generuje obrazów. To API LLM kompatybilne z OpenAI, tylko tekstowe, używane wraz z narzędziami do obrazów do pisania promptów, opisów i skryptów. Oto jak je skonfigurować i użyć.

Zaktualizowano

Izometryczna ilustracja kart tekstowych płynących w stronę pustej ramki, pokazująca zasilanie przepływu obrazu promptami

Kluczowe punkty

  • API zwraca tylko tekst: bez generowania obrazów, audio ani wideo.
  • Użyj bazowego URL https://api.nanobananaapis.com/v1, ID modelu uncensored i klucza Bearer.
  • Typowe zastosowanie to zamiana surowych pomysłów na ustrukturyzowane prompty do obrazów w trybie JSON.
  • Koszt wejścia to $0.15, a wyjścia $0.50 za 1M tokenów, a nieudane zapytania są darmowe.

Przeczytaj to najpierw: czym jest to API, a czym nie

Jeśli trafiłeś tutaj, zastanawiając się, jak używać nano banana api do generowania obrazów, szczera odpowiedź brzmi, że ta usługa nie potrafi tego robić. "Nano Banana" to nazwa, którą ludzie często przypisują modelowi do generowania obrazów, a generowanie obrazów nie jest tutaj oferowane. nanobananaapis.com sprzedaje dostęp do modelu językowego tekstu przez endpoint kompatybilny z OpenAI.

To nadal pasuje do wielu przepływów pracy z obrazami, ponieważ narzędzia graficzne są tak dobre, jak tekst, który im podasz. Model tekstowy może pisać prompty, modyfikować je, sprawdzać względem arkusza stylów, generować opisy i tekst alternatywny oraz tworzyć skrypty łączące potok pracy. Ta strona omawia właśnie takie zastosowanie. Jeśli potrzebujesz tylko obrazów, wybierz usługę graficzną i połącz ją z tą.

Model to pojedynczy model o otwartych wagach, uruchamiany przez niezależnego dostawcę, dostrojony do odpowiadania bez odmów treści dla legalnego użytku dorosłych. Nie jest to oficjalne API żadnego dużego dostawcy. Jedno twarde ograniczenie: brak treści seksualnych z udziałem nieletnich.

Krok 1: uzyskaj klucz

Zarejestruj się przez Google lub podając adres e-mail i hasło, a następnie otwórz stronicę klucza API. Zobaczysz przycisk do jednorazowego kliknięcia, aby odebrać $0.50 kredytu próbnego. Jest ważny przez 7 dni, nie wymaga karty i można go uzyskać raz na osobę. Klucz próbny pozwala na 2 równoległe zapytania i 60 zapytań na minutę, co w zupełności wystarcza do wypróbowania możliwości.

Skopiuj klucz i trzymaj go z dala od repozytorium. W powłoce możesz go przechowywać w ten sposób:

export NANOBANANA_KEY="paste-your-key-here"

Krok 2: wyślij swoje pierwsze zapytanie

Trzy wartości mają znaczenie: bazowy URL, ID modelu i nagłówek Authorization. Wszystko inne podąża za formatem chat-completions OpenAI. Oto pierwsze wywołanie z curl:

curl https://api.nanobananaapis.com/v1/chat/completions   -H "Authorization: Bearer $NANOBANANA_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}
    ],
    "max_tokens": 200
  }'

To samo w Pythonie z oficjalnym pakietem openai:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
)

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}],
)
print(r.choices[0].message.content)

A w Node:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.nanobananaapis.com/v1",
  apiKey: process.env.NANOBANANA_KEY,
});

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write one detailed image prompt for a foggy harbor at dawn." }],
});
console.log(r.choices[0].message.content);

Sprawdź nagłówki odpowiedzi raz. X-Balance-USD pokazuje twój pozostały kredyt, a X-Request-Id identyfikuje wywołanie, jeśli potrzebujesz pomocy. Strona dokumentacji wymienia wszystkie obsługiwane parametry.

Krok 3: zamiana pomysłów na ustrukturyzowane prompty

Najbardziej przydatny trik dla potoku obrazów to zmuszenie modelu do zwracania danych ustrukturyzowanych zamiast swobodnego tekstu. Tryb JSON to robi. Opisujesz schemat w wiadomości systemowej, a odpowiedź parsuje się bezpośrednio do kodu, więc lista surowych pomysłów staje się tabelą promptów z ustalonymi polami.

import json, os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
)

SYSTEM = (
    "You write prompts for an image model. Reply with JSON only: "
    '{"prompts": [{"subject": str, "style": str, "lighting": str, "negative": str, "full": str}]}'
)

def expand(idea: str, n: int = 3):
    r = client.chat.completions.create(
        model="uncensored",
        response_format={"type": "json_object"},
        temperature=0.9,
        messages=[
            {"role": "system", "content": SYSTEM},
            {"role": "user", "content": f"Give {n} distinct prompts for: {idea}"},
        ],
    )
    return json.loads(r.choices[0].message.content)["prompts"]

for p in expand("a lighthouse keeper's kitchen in winter"):
    print(p["full"])

Podnieś temperaturę, gdy chcesz różnorodności, i obniż ją dla spójności. Parametr seed jest przekazywany dalej, więc możesz go zablokować, gdy musisz odtworzyć wcześniejszą partię. Zawsze owijaj json.loads w bloku try i ponów zapytanie raz, jeśli parsowanie się nie powiedzie, ponieważ każdy model językowy może się pomylić.

Strona ma również powiązany przewodnik po stronie obrazów: generowanie promptów i post-processing. Obejmuje to, jak krok tekstowy łączy się z generatorem.

Inne zadania, które model tekstowy wykonuje dobrze w przepływie obrazów

  • Arkusze stylów. Trzymaj jedną wiadomość systemową ze stałymi zasadami stylu i podawaj każdy nowy temat przez nią, aby cała seria była wizualnie spójna.
  • Opisy i tekst alternatywny. Po istnieniu obrazów, opisz je kilkoma słowami każdy. Podaj własny opis obrazu jako wejście; model nie widzi obrazów, ponieważ API przyjmuje tylko tekst.
  • Listy ujęć i scenariusze. Do storyboordu lub krótkiego filmu przygotuj listę scen, lektor i tekst ujęć na ekranie.
  • Krytyka promptów. Wklej prompt, który daje złe wyniki, i poproś o trzy przekształcenia z wyjaśnieniem zmian.
  • Fikcja i praca z postaciami dla dorosłych. Arkusze postaci, tła i dialogi do opowiadań i aplikacji towarzyszących, z modelem nie odmawiając legalnych tematów dla dorosłych.

Dla długich zadań, strumieniuj wyjście z stream: true, aby interfejs użytkownika mógł pokazywać tekst, gdy przybywa. Wywoływanie funkcji jest również obsługiwane, co pozwala modelowi zdecydować, kiedy wywołać twoją własną funkcję, na przykład taką, która przesyła prompt do usługi obrazów, której używasz.

Ograniczenia i koszt uruchomienia

Znaj liczby przed zbudowaniem partii. Pełny klucz pozwala na 8 równoległych zapytań i 300 zapytań na minutę. Okno kontekstu to 100 000 tokenów obejmujących prompt i uzupełnienie, maksymalne ciało zapytania to 8 MB, a max_tokens jest opcjonalne. Przekroczenie limitu zapytań zwraca HTTP 429 z kodem rate_limited lub concurrency; poczekaj i ponów próbę.

Ceny to $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych. Powiedzmy, że generujesz 500 zestawów promptów, każdy z wejściem 400 tokenów i wyjściem 600 tokenów:

  • Wejście: 500 x 400 = 200 000 tokenów x $0,15 / 1M = $0,03
  • Wyjście: 500 x 600 = 300 000 tokenów x $0,50 / 1M = $0,15
  • Razem: $0,18

Więc kredyt próbny $0,50 pokrywa około 1 300 zestawów tego rozmiaru. Do regularnego użytku doładowaj dowolną kwotę całkowitą od $20 do $500, kryptowalutami (USDT na TRC20, USDC na Base). Bonusy to 5% od $50, 10% od $100 i 15% od $200. Zobacz stronę cenową dla tabeli. Kredyt nie wygasa.

Integracja z usługą obrazów

Typowa konfiguracja ma dwa etapy. Etap tekstowy używa tego API do generowania promptów. Etap obrazu wysyła te prompty do dowolnego generatora obrazów, którego używasz, a ten generator ma swoje własne konto, swoje własne ceny i swoje własne zasady, które powinieneś przeczytać na jego stronie. Trzymaj dwa etapy w oddzielnych funkcjach, abyś mógł zmienić którąkolwiek stronę bez przepisywania drugiej.

Praktyczna wskazówka: zapisuj każdy prompt wraz z seedem i temperaturą, których użyłeś do jego utworzenia. Gdy obraz wyjdzie dobrze, możesz go wyśledzić do dokładnego tekstu, który go wygenerował, a gdy partia zawiedzie, możesz zobaczyć, czy wina leży w pomysle, pisarzu promptów czy modelu obrazów. Daje to również tani sposób porównania dwóch wiadomości systemowych, uruchamiając obie na tej samej liście pomysłów i oceniając dwa zestawy promptów obok siebie.

Krótki skrypt end-to-end

Aby połączyć kawałki, oto krótki skrypt, który czyta plik surowych pomysłów, rozszerza każdy z nich w prompty z trybem JSON i zapisuje wynik do pliku, który narzędzie do obrazów może czytać. Obsługuje jeden tryb awarii, który w przeciwnym razie cię ugryzie: odpowiedź, która nie jest poprawnym JSON.

import json, os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
)

def one(idea: str):
    for _ in range(2):
        r = client.chat.completions.create(
            model="uncensored",
            response_format={"type": "json_object"},
            messages=[
                {"role": "system", "content": 'Reply with JSON only: {"prompt": str}'},
                {"role": "user", "content": f"Write a vivid, specific image prompt for: {idea}"},
            ],
            max_tokens=250,
        )
        try:
            return json.loads(r.choices[0].message.content)["prompt"]
        except (json.JSONDecodeError, KeyError):
            continue
    return None

ideas = [line.strip() for line in open("ideas.txt") if line.strip()]
out = {i: one(i) for i in ideas}
json.dump(out, open("prompts.json", "w"), indent=2)

Uruchom go na pięciu pomysłach najpierw i przeczytaj wyniki okiem. Dostosuj wiadomość systemową, aż prompty będą pasować do stylu, którego chcesz, a następnie zwiększ skalę. Ponieważ każde zapytanie tutaj jest małe, tysiąc pomysłów zakończy się szybko i będzie kosztować grosze.

Błędy początkujących

  • Oczekiwanie na obrazy. Odpowiedź jest zawsze tekstem. Jeśli Twój kod próbuje zapisać binarny obraz z odpowiedzi, zakończy się niepowodzeniem, ponieważ go nie ma.
  • Szukanie innej nazwy modelu. Jest jeden model, a jego ID to uncensored. Skopiowanie nazwy modelu dostawcy z samouczka daje błąd nie znaleziono.
  • Pomijanie wiadomości systemowej. Bez niej model nie ma wskazówek stylu i dryfuje między krótkimi a długimi promptami. Umieść tam swoje zasady.
  • Wysyłanie sekretów w promptach. Prompty nie są używane do szkolenia, ale nadal powinieneś unikać wklejania haseł lub kluczy prywatnych do dowolnego wejścia modelu.
  • Uruchamianie stu zapytań naraz. Pełny klucz pozwala na 8 naraz. Użyj puli lub semafora i dodaj ponowną próbę dla 429.

Jeśli coś zachowuje się dziwnie, na stronie wsparcia możesz zadać pytanie, a identyfikator żądania z nagłówków odpowiedzi znacznie ułatwia jego rozwiązanie.

Pytania i odpowiedzi

Czy to API może generować obrazy Nano Banana?

Nie. To API LLM tylko dla tekstu. Może pisać prompty, opisy i scenariusze do przepływów pracy z obrazami, ale nie generuje obrazów, dźwięku ani wideo.

Jako jaką nazwę modelu wpisać?

Użyj uncensored jako ID modelu, z bazowym URL https://api.nanobananaapis.com/v1 i swoim kluczem jako tokenem Bearer.

Czy mogę przetestować usługę bez płacenia?

Tak. Nowi użytkownicy mogą otrzymać $0,50 kredytu próbnego jednym kliknięciem na stronie klucza API. Nie wymaga karty i jest ważny przez 7 dni.

Czy model widzi moje obrazy?

Nie. Odczytuje tylko tekst. Jeśli potrzebujesz pomocy z obrazem, opisz go w wiadomości.

Czy moje prompty są wykorzystywane do trenowania?

Nie. Prompty nie są używane do trenowania.

Twój klucz jest o jeden formularz stąd

Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.

Pobierz klucz API