PL ▾
Pobierz klucz API

Klucz API Flux: czym jest i gdzie pasuje API tekstowe

Klucz API Flux to dane logowania do usługi generowania obrazów, a ta strona nie sprzedaje takiego klucza. Sprzedaje ona inny klucz, do hostowanego tekstowego API LLM, które może tworzyć i rozwijać prompty podawane do modelu obrazowego.

Zaktualizowano

Dwa osobne klucze: jeden powiązany z ramką obrazu, drugi z dymkami czatu; dwa osobne API

Kluczowe punkty

  • Klucz do usługi obrazów Flux i klucz do API LLM tekstowego to dwie oddzielne rzeczy, wydawane przez dwóch różnych dostawców.
  • Ta strona obsługuje tylko tekst: nie generuje obrazów, dźwięku ani wideo, a nie jest prowadzona przez żadnego dostawcę modeli obrazowych.
  • Klucz tekstowy jest przydatny obok klucza do obrazów, ponieważ pisanie promptów to zadanie tekstowe, rozliczane za tokeny.
  • Zmieniasz jeden Base URL i jeden klucz w dowolnym kliencie OpenAI, aby zacząć, a kredyt próbny pokrywa pierwsze testy.

Co ludzie zwykle mają na myśli, mówiąc o kluczu Flux

Flux to nazwa rodziny modeli do generowania obrazów z tekstu. Gdy ktoś wpisuje flux api key w pole wyszukiwania, prawie zawsze chce poświadczenia, które pozwoli Twojemu kodowi wysłać prompt do usługi hostującej jeden z tych modeli obrazowych i otrzymać obraz. To poświadczenie pochodzi od firmy, która obsługuje endpoint obrazów, który wybrałeś. Jest powiązane z Twoim kontem, rozliczeniami i warunkami.

Spotkasz się z użyciem tego zwrotu na kilka nieco różnych sposobów, więc warto je rozróżnić przed wklejeniem klucza gdziekolwiek:

  • Klucz od hosta obrazów, który obsługuje modele Flux, używany w zapytaniu zwracającym obraz.
  • Klucz do lokalnej lub samodzielnie hostowanej konfiguracji, gdzie tworzysz token samodzielnie i nic nie opuszcza Twojej maszyny.
  • Klucz do innego narzędzia w Twoim potoku, np. modelu tekstowego, który pisze prompty, który nazywa się Flux tylko dlatego, że projekt nosi taką nazwę.

Tylko pierwsze dwa generują obrazy. Trzeci to miejsce, w którym działa ta strona. Prowadzimy hostowane, kompatybilne z OpenAI API LLM, a klucz, który otrzymasz tutaj, działa z tym API i niczym innym.

Dlaczego klucz do obrazów nie wywoła modelu czatu

Oba rodzaje kluczy wyglądają podobnie, ponieważ oba są długimi ciągami znaków wysyłanymi w nagłówku Authorization, ale otwierają różne drzwi. Klucz dostawcy obrazów jest weryfikowany przez dostawcę obrazów. Jeśli wyślesz go do endpointu czatu, otrzymasz błąd uwierzytelnienia, a odwrotne jest równie prawdziwe: klucz z tej strony zwróci błąd, jeśli wyślesz go do hosta obrazów.

Różnią się również treści (body) żądań. Wywołanie generowania obrazu zwykle zawiera prompt, wymiary, seed i liczbę obrazów. Wywołanie czatu zawiera listę wiadomości z rolami i zwraca tekst. Nie ma wspólnego schematu, więc nie ma nic do przetłumaczenia między nimi. Jeśli masz skrypt działający z dostawcą obrazów, zachowaj ten skrypt i jego klucz dokładnie takimi, jakie są. Dodaj wywołanie tekstowe jako osobny krok przed nim.

Czego ta usługa nie robi

Aby zachować jasność oczekiwań: API tutaj obsługuje tylko tekst. Nie generuje obrazów, dźwięku ani wideo, nie tworzy embeddingów i nie oferuje dostrajania. Nie jest to oficjalne API żadnego dostawcy modeli i nie jest routerem między dostawcami. Obsługuje jeden model o otwartych wagach, dostrojony do odpowiadania bez odmów dotyczących treści, do legalnego użytku przez dorosłych, prowadzony przez niezależnego dostawcę. ID modelu, które przekażesz, to uncensored.

Gdzie pasuje API tekstowe obok klucza do obrazów

Pisanie promptów to oczywiste miejsce spotkania. Modele obrazowe dobrze reagują na konkretne, ustrukturyzowane opisy: podmiot, otoczenie, obiektyw, oświetlenie, kolor, nastrój. Większość osób pisze je ręcznie, a następnie przepisuje po nieudanym wyniku. Model tekstowy może przygotować pierwszy szkic, rozwinąć trzysłowną ideę w pełny opis lub wygenerować dwadzieścia wariacji na ten sam temat, podczas gdy Ty idziesz po kawę.

Kilka zadań, które dobrze się sprawdzają:

  • Rozwinięcie. Zamień krótką ideę w szczegółowy prompt w stylu, który ustawisz raz w wiadomości systemowej.
  • Wariacje. Poproś o dziesięć różnych ujęć jednego tematu, zwróconych jako lista JSON, którą Twój skrypt może przetworzyć w pętli.
  • Oczyszczanie. Przepisz nieporządny prompt napisany przez klienta tak, aby model obrazowy radził sobie z nim lepiej.
  • Skrypty i opisy. Napisz narrację, listę ujęć lub opis, który pojawi się obok obrazu.

Ponieważ model tutaj nie odrzuca domyślnie, nadaje się do fikcji, projektowania postaci i dojrzałych tematów, które inne hostowane modele często odrzucają, o ile użycie jest zgodne z prawem i dotyczy dorosłych. Jedno ścisłe ograniczenie obowiązuje wszędzie: brak treści seksualnych z udziałem nieletnich. Zapytania takie nie są przez nas wspierane w żadnej formie.

Pierwsze zapytanie w mniej niż minutę

Każdy SDK OpenAI lub klient HTTP zadziała po podmianie base URL i klucza. Endpoint do czatu to POST /v1/chat/completions, a GET /v1/models wyświetla listę modeli. Oto to samo żądanie w curl i w Pythonie.

curl https://api.fluxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
      {"role": "user", "content": "a lighthouse in a storm, painterly"}
    ]
  }'
from openai import OpenAI

client = OpenAI(
    base_url="https://api.fluxapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
        {"role": "user", "content": "a lighthouse in a storm, painterly"},
    ],
)
print(reply.choices[0].message.content)

Każdy zwrócony ciąg znaków przekazujesz swojej usłudze obrazowej, używając jej własnego klucza. Te dwa nigdy ze sobą nie wchodzą w interakcję. Pełną listę parametrów, w tym strumieniowanie, wywoływanie funkcji i tryb JSON, znajdziesz w dokumentacji API.

Czy potrzebujesz obu kluczy?

Zależy od tego, co budujesz. Poniższa tabela to szybki sposób na podjęcie decyzji.

Twój celKlucz do obrazówKlucz tekstowy
Generuj obrazy z promptów, które piszesz samodzielnieTakNie
Generuj obrazy z promptów, które pisze lub rozwija modelTakTak
Pisz tylko opowieści, dialogi lub scenariuszeNieTak
Buduj aplikacje czatu lub roleplay dla dorosłychNieTak
Masowo produkuj setki wariacji promptówOpcjonalnieTak

Jeśli zawsze wpisujesz własne prompty i jesteś z nich zadowolony, klucz tekstowy niewiele wnosi. Jeśli zauważasz, że przepisujesz prompty całe popołudnie, lub potrzebujesz dużej ilości, szybko zwróci swoją cenę. Mamy też krótki przewodnik na temat używania LLM tekstowego w przepływach wideo, który podąża za tą samą ideą kroku tekstowego przed krokiem multimedialnym.

Błędy wynikające z mylenia kluczy

Większość problemów w konfiguracji z dwiema usługami to drobne i łatwe do zlokalizowania błędy, gdy wiesz, czego szukać.

  • Zły Base URL. Jeśli Twój klient nadal wskazuje na stary host, nowy klucz zostanie odrzucony. Sprawdź, czy Base URL kończy się na /v1 i pasuje do tego z powyższego przykładu.
  • Zła nazwa modelu. Jedynym ID modelu tutaj jest uncensored. Przekazanie nazwy modelu obrazowego zwróci błąd, ponieważ nie ma takiego modelu w tym API.
  • Klucze w jednej zmiennej środowiskowej. Przypisz każdej usłudze własną zmienną, np. TEXT_API_KEY i IMAGE_API_KEY. Używanie jednej nazwy dla wszystkich to sposób, na jaki klucz trafia do złego hosta.
  • Oczekiwanie obrazów w odpowiedzi. Odpowiedź to czysty tekst w choices[0].message.content. Jeśli potrzebujesz obrazu, ten tekst musi trafić do Twojej usługi obrazów jako drugie zapytanie.
  • Ignorowanie błędu 429. Przekroczenie 8 równoległych zapytań zwraca kod 429 z kodem błędu concurrency, a powyżej 300 zapytań na minutę z kodem rate_limited. Zredukuj tempo i spróbuj ponownie. Żądanie strumieniowe zajmuje slot do momentu zakończenia strumienia, więc zamykaj strumienie, których nie czytasz.

Klucz próbny ma niższe limity: 2 równoległe zapytania i 60 na minutę. To wystarczy do przetestowania kroku pisania promptów ręcznie, ale duża partia powinna poczekać na doładowany klucz.

Ile kosztuje pisanie promptów

Rozliczenie jest tokenowe i z góry opłacone: $0,15 za 1 mln tokenów wejściowych i $0,50 za 1 mln tokenów wyjściowych, bez subskrypcji. Zadania promptowe są małe, więc kwoty są niskie. Weź zapytanie z 600-tokenowym promptem systemowym plus pomysł (wejście) i 250-tokenowym rozwiniętym promptem (wyjście). Wejście kosztuje 600 / 1 000 000 x $0,15 = $0,00009. Wyjście kosztuje 250 / 1 000 000 x $0,50 = $0,000125. Jedno zapytanie to $0,000215.

Zatem partia 1000 takich żądań kosztuje około $0,215. $0,50 darmowego kredytu próbnego, który możesz otrzymać jednym kliknięciem na stronie klucza po rejestracji, pokrywa około 2300 takich żądań (0,50 / 0,000215). Nie wymaga karty i jest ważny przez 7 dni. Nieudane lub odrzucone żądania nie są rozliczane, a dodany później kredyt nigdy nie wygasa. Szczegóły znajdziesz na stronie z cenami.

Uzyskiwanie klucza tekstowego

Zarejestruj się przez Google lub podając adres e-mail i hasło, a następnie otwórz stronę klucza API. Odbierz kredyt próbny, jeśli chcesz najpierw przetestować. Płatne doładowania wynoszą od $20 do $500 w dowolnej całkowitej kwocie, z bonusem +5% od $50, +10% od $100 i +15% od $200. Możesz zapłacić kryptowalutami (USDT w sieci TRC20, USDC na Base).

Chroń klucz przed kodem po stronie klienta i publicznymi repozytoriami. Wysyłane przez Ciebie prompty nie są używane do trenowania, ale wyciek klucza spowoduje zużycie Twojego kredytu. Pełny klucz pozwala na 8 równoległych zapytań i 300 zapytań na minutę, więc partia promptów może działać równolegle bez dodatkowego wysiłku.

Pytania i odpowiedzi

Czy mogę użyć tego klucza do generowania obrazów za pomocą Flux?

Nie. Klucz działa tylko w tekstowym API tej strony. Generowanie obrazów wymaga klucza od dostawcy, który hostuje model obrazowy.

Czy to oficjalne API Flux?

Nie. Jest to niezależne, hostowane, kompatybilne z OpenAI tekstowe API z jednym modelem o nazwie uncensored. Nie jest obsługiwane przez żadnego dostawcę modeli obrazowych i nie odsprzedaje ich usług.

Czy model tekstowy może pisać prompty do mojego narzędzia do obrazów?

Tak. Poproś o prompt w wiadomości systemowej, pobierz tekst odpowiedzi i wklej lub wyślij go do swojej usługi generowania obrazów. Dwie usługi pozostają niezależne.

Czy potrzebuję karty, żeby przetestować?

Nie. Nowi użytkownicy mogą odebrać $0,50 kredytu próbnego jednym kliknięciem na stronie klucza, ważny przez 7 dni, bez konieczności podawania karty.

Twój klucz jest o jeden formularz stąd

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

Pobierz klucz API