LLM API dla promptów Flux: Praktyczny przepływ pracy
Jeśli chcesz użyć LLM API do promptów Flux, zadanie jest proste: wyślij krótki pomysł do modelu tekstowego i otrzymaj szczegółowy prompt, który usługa graficzna może wykorzystać. Na tej stronie znajdziesz prompt systemowy, ustawienia i kod, a także wyjaśniamy, czego model tekstowy nie zrobi.
Zaktualizowano

Kluczowe punkty
- Użyj wiadomości systemowej, aby raz ustalić format i styl, a następnie wysyłaj tylko krótki pomysł w każdym zapytaniu.
- Tryb JSON zwraca listę wariantów promptów, które skrypt może przetwarzać w pętli bez parsowania tekstu.
- Okno kontekstu o rozmiarze 100 000 tokenów pozwala wkleić do zapytania przewodnik stylu lub wcześniejsze prompty.
- Pełne rozwinięcie kosztuje ułamek centa, a model nie widzi ani nie tworzy obrazu.
Krótka wersja
Utwórz klucz, wskaż klientowi OpenAI adres https://api.fluxapikey.com/v1, ustaw model na uncensored i umieść reguły promptu w wiadomości systemowej. Każda wiadomość użytkownika to tylko pomysł: kilka słów, scena, postać. Odpowiedzią jest gotowy prompt. Skopiuj go do dowolnego narzędzia do generowania obrazów, które ma własny klucz i własne rozliczenie.
Nic tutaj nie generuje obrazów. API obsługuje tylko tekst, nie jest to usługa dostawcy obrazów i nie może oglądać twoich renderów. To, co robi dobrze, to pisanie: struktura, słownictwo, spójność w ramach wsadu. Reszta tej strony to szczegóły praktyczne.
Dlaczego używać modelu językowego do generowania promptów
Modele obrazowe nagradzają konkretne wejście i karzą za niejasne. Linia typu „zamek” da ci średni zamek. Akapit, który wymienia materiał ścian, porę dnia, obiektyw i paletę barw, da coś bliższego obrazowi w twojej głowie. Pisanie tego akapitu ręcznie dla każdego obrazu jest wolne, a ty za każdym razem zapominasz o tych samych szczegółach.
Model językowy świetnie radzi sobie z tego rodzaju rozszerzaniem. Doda brakujące szczegóły, zachowa stałą kolejność elementów i utrzyma styl redakcyjny w setkach zapytań. Ponieważ ten model nie odrzuca domyślnie treści, radzi sobie też z fikcją, mrocznymi tematami i tworzeniem postaci dla dorosłych, które ostrożniejsze hostowane modele często odrzucają. Obowiązuje zwykłe ograniczenie: tylko zgodne z prawem użycie przez dorosłych i brak treści seksualnych z udziałem nieletnich w żadnej formie.
Działający prompt systemowy
Większość jakości zależy od wiadomości systemowej. Powinna być krótka, konkretna i testowalna. Oto punkt startowy, który możesz edytować:
SYSTEM = '''You write prompts for a text-to-image model.
Output exactly one prompt, one paragraph, no preamble, no quotes.
Order: subject, action, setting, lighting, camera or medium, palette, mood.
Use concrete nouns and visual adjectives. Avoid abstract words like beautiful.
Do not mention the words prompt, image or render.
Keep it under 90 words.'''
Zwróć uwagę, czego wiadomość NIE mówi. Nie zawiera długiego wykładu o kreatywności ani listy zakazanych tematów. Krótkie reguły z ustaloną kolejnością są łatwiejsze do wykonania dla modelu i łatwiejsze do debugowania przez Ciebie. Jeśli wynik odbiega od oczekiwań, zmień jedną linię i uruchom ten sam pomysł ponownie. Jeśli chcesz inny styl dla innego projektu, utrzymaj drugą wiadomość systemową i wybieraj ją w zależności od zapytania.
Pokaż, nie opisuj
Gdy same reguły nie wystarczają, dodaj jedną lub dwie pary przykładów jako wcześniejsze wiadomości w rozmowie: krótki pomysł jako wiadomość użytkownika i preferowany prompt jako wiadomość asystenta. Para lub dwie pary zwykle lepiej ustalają ton niż kolejny akapit reguł.
Wysyłanie zapytania
Wywołanie to standardowe uzupełnienie czatu. Ustawienia mające największe znaczenie dla kreatywnego rozszerzania to temperatura i seed.
from openai import OpenAI
client = OpenAI(base_url="https://api.fluxapikey.com/v1", api_key="YOUR_KEY")
def expand(idea, seed=None):
r = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": SYSTEM},
{"role": "user", "content": idea},
],
temperature=0.9,
top_p=0.95,
max_tokens=200,
seed=seed,
)
return r.choices[0].message.content.strip()
print(expand("an abandoned observatory on a cliff", seed=7))
Temperatura w zakresie 0,8–1,0 daje zróżnicowane sformułowania, co jest pożądane przy burzy mózgów. Obniż ją do ok. 0,3, gdy potrzebujesz niemal identycznego wyniku dla powtarzanego szablonu. Parametry seed, top_p, stop oraz parametry kar są przekazywane do modelu, więc możesz używać ich tak samo jak gdzie indziej. Limit max_tokens jest opcjonalny; ustawienie go blisko spodziewanej długości zapobiega rozrastaniu się odpowiedzi. Zobacz dokumentację, aby poznać wszystkie obsługiwane parametry.
Wsady wariantów w trybie JSON
W przypadku wsadu poproś o listę i włącz tryb JSON z response_format. Wiadomość systemowa nadal musi określać strukturę wyniku, ponieważ tryb JSON sprawia, że wynik jest poprawnym JSON-em, ale nie wybiera za ciebie kluczy.
# client as above: base_url https://api.fluxapikey.com/v1
import json
def variations(idea, n=8):
r = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
messages=[
{"role": "system", "content": SYSTEM + f"\nReturn JSON: {{\"prompts\": [{n} strings]}}."},
{"role": "user", "content": idea},
],
temperature=1.0,
)
return json.loads(r.choices[0].message.content)["prompts"]
for p in variations("a night market in the rain"):
print(p)
Zawsze owijaj json.loads blokiem try. Jeśli odpowiedź zostanie ucięta przez bardzo niski max_tokens, nie zostanie poprawnie przeanalizowana, więc ustaw ten parametr hojnie dla zapytań o listę. Każdy prompt na liście można od razu przekazać do twojej usługi obrazowej w pętli.
Używanie okna 100 000 tokenów
Okno kontekstu ma 100 000 tokenów, licząc prompt plus uzupełnienie. Dla pracy z promptami to więcej niż potrzebujesz w jednym zapytaniu, ale przydaje się na dwa sposoby. Możesz wkleić długi przewodnik stylu, kartę postaci lub listę działających promptów, a model będzie się ich trzymać. Możesz też prowadzić ciągłą rozmowę: poproś o prompt, napisz „ciemniej, dodaj mgłę” i otrzymaj poprawiony prompt, który pamięta poprzedni.
Długie wejście kosztuje, więc ogranicz stały przewodnik stylu do tego, co zmienia wynik. 500 tokenów zasad jest tanie. 50 000 tokenów starych promptów wysyłanych z każdym zapytaniem sumuje się, jak pokazuje sekcja kosztów poniżej: 50 000 dodatkowych tokenów wejściowych to $0,0075 za zapytanie, czyli $3,75 przy 500 zapytaniach.
Wzorce promptów do typowych zadań
Ten sam endpoint obsługuje wiele różnych zadań. Zmienia się tylko wiadomość systemowa.
- Karty postaci. Zachowaj stały opis powracającej postaci (włosy, ubranie, wiek, budowa) w wiadomości systemowej i poleć modelowi, aby powtarzał go dosłownie w każdym prompcie. To najtańszy sposób na rozpoznawalność postaci w serii renderów.
- Transfer stylu słowami. Podaj listę preferowanych terminów stylistycznych, np. "gouache, stonowana paleta, ziarno", i poproś o ich umieszczenie w ostatnim zdaniu każdego promptu.
- Sformułowania negatywne. Jeśli Twoje narzędzie do obrazów przyjmuje oddzielny prompt negatywny, poproś model o zwrócenie dwóch pól w trybie JSON:
promptinegative. Lista negatywna powinna być krótka i konkretna. - Skracanie. Niektóre narzędzia obcinają długie wejście. Dodaj limit słów do reguł i przetestuj go, ponieważ modele liczą słowa w przybliżeniu.
Dojrzała fikcja i sztuka do odgrywania ról dla dorosłych to uzasadniony przypadek użycia. Model napisze opis sceny prostym, nieeksplicytnym językiem, jeśli o to poprosisz. Jeśli pracujesz na platformie z własnymi regułami treści, umieść je również w wiadomości systemowej, aby prompty pasowały do miejsca publikacji obrazów.
Testowanie i dostrajanie pętli
Traktuj wiadomość systemową jak kod. Wybierz pięć testowych pomysłów pokrywających Twój zwykły zakres, uruchom je ze stałym seed i niską temperaturą i zapisz wyniki. Po każdej zmianie reguł uruchom ponownie te pięć i porównaj wyniki. Pozwoli to wychwycić częsty błąd, w którym poprawka dla jednego przypadku psuje inny.
Szukaj trzech objawów. Prompty powtarzające te same słowa na początku w ramach wsadu oznaczają, że temperatura jest zbyt niska lub przykłady są zbyt jednolite. Prompty ignorujące limit słów oznaczają, że zasada jest ukryta; przenieś ją na koniec wiadomości. Prompty zawierające gadatliwe wstępy typu „Oto twój prompt” oznaczają, że reguła formatu musi być ściślejsza, albo możesz usunąć pierwszą linię w kodzie. Strumieniowanie z stream: true jest dostępne, jeśli pokazujesz wyniki w interfejsie, a zużycie jest raportowane na końcu strumienia.
Limity, które musisz uwzględnić w planowaniu
Trzy uczciwe limity. Po pierwsze, model jest tylko tekstowy: nie widzi obrazu, więc nie może ocenić, czy prompt wygenerował dobry obraz. Ty jesteś sędzią, a pętla to: napisz, wyrenderuj, dostosuj zasady. Po drugie, nie zna specyfiki twojego konkretnego modelu obrazowego, chyba że mu ją powiesz, więc umieść te specyficzne cechy w wiadomości systemowej. Po trzecie, limity zapytań: pełny klucz pozwala na 8 zapytań równoległych i 300 na minutę, a klucz próbny na 2 i 60. Jeśli pętla przekroczy ten limit, otrzymasz HTTP 429 z kodem concurrency lub rate_limited; poczekaj chwilę i spróbuj ponownie. 429 z nagłówkiem Retry-After: 5 oznacza tymczasowe przeciążenie i stosuje się tę samą radę.
Koszt generowania jednego promptu
Ceny to $0,15 za 1 mln tokenów wejściowych i $0,50 za 1 mln tokenów wyjściowych. Załóżmy, że każde zapytanie wysyła 800-tokenową wiadomość systemową plus pomysł i zwraca 200-tokenowy prompt. Przy 500 zapytaniach jest to 400 000 tokenów wejściowych i 100 000 tokenów wyjściowych. Wejście: 0,4 x $0,15 = $0,06. Wyjście: 0,1 x $0,50 = $0,05. Łącznie: $0,11 za 500 promptów.
Powyższy wsad JSON, przy około 400 tokenach wejściowych i 700 wyjściowych na wywołanie, kosztuje 0,0004 x $0,15 plus 0,0007 x $0,50, czyli $0,00006 + $0,00035 = $0,00041 za osiem promptów. Kredyt próbny to $0,50, odbierany jednym kliknięciem po rejestracji. Doładowania zaczynają się od $20; zobacz stronę z cenami, aby poznać poziomy bonusów, oraz stronę klucza, aby rozpocząć.
Więcej przewodników
Pytania i odpowiedzi
Czy model może generować prompty dla dowolnego generatora obrazów?
Tak, ponieważ generuje tylko tekst. W wiadomości systemowej określasz format preferowany przez narzędzie do obrazów, a następnie kopiujesz wynik.
Czy odrzuci treści dla dorosłych lub mroczne tematy?
Model jest dostrojony do odpowiadania bez odrzucania treści dla zgodnego z prawem użytku przez dorosłych. Treści seksualne z udziałem nieletnich są zawsze zabronione.
Ile promptów mogę wygenerować na minutę?
Pełny klucz pozwala na 300 zapytań na minutę i 8 jednocześnie. W trybie JSON jedno zapytanie może zwrócić wiele promptów.
Czy generuje też obrazy?
Nie. API obsługuje tylko tekst, bez generowania obrazu, dźwięku ani wideo.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.