LLM API для промптов Flux: практический рабочий процесс
Если вам нужен API LLM для промптов Flux, задача проста: отправьте короткую идею текстовой модели и получите подробный промпт, который ваша служба генерации изображений сможет использовать. На этой странице показаны системный промпт, настройки и код, а также ясно указано, что текстовая модель не может делать.
Обновлено

Ключевые моменты
- Используйте системное сообщение, чтобы один раз зафиксировать формат и стиль, а затем отправляйте только короткую идею в каждом запросе.
- JSON-режим возвращает список вариантов промптов, которые скрипт может перебирать без парсинга обычного текста.
- Контекстное окно на 100 000 токенов позволяет вставить руководство по стилю или предыдущие промпты в запрос.
- Полное расширение стоит доли цента, и модель никогда не видит и не создаёт изображение.
Краткая версия
Создайте ключ, направьте OpenAI-клиент на https://api.fluxapikey.com/v1, установите модель в uncensored и поместите правила промпта в системное сообщение. Каждое сообщение пользователя — это просто идея: несколько слов, сцена, персонаж. Ответ — готовый промпт. Скопируйте его в любой инструмент для изображений, который использует свой ключ и свою оплату.
Ничто здесь не генерирует изображения. API работает только с текстом, это не сервис поставщика изображений, и он не может просматривать ваши рендеры. То, что он делает хорошо, — это написание текста: структура, словарный запас, согласованность в пакете. Остальная часть этой страницы — практические детали.
Зачем вообще использовать языковую модель для промптов
Модели изображений поощряют конкретный ввод и наказывают за расплывчатый. Строка вроде «замок» даст вам средний замок. Абзац, в котором указаны материал стен, время суток, объектив и цветовая палитра, даст вам результат, ближе к изображению в вашей голове. Написание этого абзаца вручную для каждого изображения — медленно, и вы склонны забывать одни и те же детали каждый раз.
Языковая модель отлично справляется именно с таким видом расширения. Она добавит недостающие детали, сохранит фиксированный порядок элементов и придерживается фирменного стиля в сотнях запросов. Поскольку эта модель по умолчанию не отказывается, она также справляется с фантастикой, мрачными темами и работами с персонажами для взрослых, которые часто отклоняют более осторожные размещённые модели. Применяется обычное ограничение: законное использование взрослыми, и никакого сексуального контента с участием несовершеннолетних ни в каком виде.
Рабочий системный промпт
Большая часть качества зависит от системного сообщения. Держите его коротким, конкретным и проверяемым. Вот отправная точка, которую вы можете редактировать:
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.'''
Обратите внимание, чего не говорит сообщение. В нём нет длинной лекции о творчестве и нет списка запрещённых тем. Короткие правила с фиксированным порядком модели проще им следовать, а вам проще отлаживать. Если вывод отклоняется, измените одну строку и запустите ту же идею снова. Если вам нужен другой фирменный стиль для другого проекта, сохраните второе системное сообщение и выбирайте одно для каждого запроса.
Показывайте, а не описывайте
Когда одних правил недостаточно, добавьте одну или две пары примеров в виде предыдущих сообщений в разговоре: короткая идея как сообщение пользователя и промпт, который вам нравится, как сообщение ассистента. Пара примеров обычно лучше фиксирует тон, чем ещё один абзац правил.
Отправка запроса
Вызов — это стандартное завершение чата. Наиболее важные настройки для творческого расширения — это temperature и 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))
Температура около 0.8–1.0 даёт разнообразные формулировки, что и нужно при мозговом штурме. Уменьшите её до 0.3, когда нужен почти идентичный вывод для повторяющегося шаблона. seed, top_p, stop и параметры штрафов передаются модели, поэтому вы можете использовать их так же, как и в других местах. Лимит max_tokens необязателен; установка его близко к ожидаемой длине не даёт ответу неконтролируемо разрастись. См. документацию по всем поддерживаемым параметрам.
Пакеты вариантов в режиме JSON
Для пакетного запроса попросите список и включите JSON-режим с response_format. Системное сообщение всё ещё должно указывать модели, какую структуру возвращать, поскольку JSON-режим делает вывод валидным JSON, но не выбирает ваши ключи за вас.
# 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)
Всё равно оберните json.loads в блок try. Если ответ будет обрезан из-за очень низкого max_tokens, он не распарсится, поэтому оставляйте этот параметр щедрым для запросов списка. Каждый промпт в списке можно сразу передать в ваш сервис изображений в цикле.
Использование окна на 100 000 токенов
Контекстное окно составляет 100 000 токенов, включая промпт и завершение. Для работы с промптами это больше, чем нужно для одного запроса, но это полезно двумя способами. Вы можете вставить длинное руководство по стилю, лист персонажа или список прошлых промптов, которые сработали, и модель будет им следовать. И вы можете поддерживать рабочий разговор: запросите промпт, скажите «темнее, добавь туман» и получите пересмотренный вариант, который помнит первый.
Длинный ввод стоит денег, поэтому ограничивайте постоянное руководство по стилю тем, что действительно меняет вывод. Пятьсот токенов правил — это дёшево. Пятьдесят тысяч токенов старых промптов, отправляемых с каждым запросом, накапливаются, как показывает раздел стоимости ниже: 50 000 дополнительных входных токенов — это $0,0075 за запрос или $3,75 за 500 запросов.
Шаблоны промптов для типовых задач
Один и тот же эндпоинт покрывает несколько разных задач. Меняется только системное сообщение.
- Листы персонажей. Сохраняйте фиксированное описание повторяющегося персонажа (волосы, одежда, возраст, телосложение) в системном сообщении и инструктируйте модель повторять его слово в слово в каждом промпте. Это самый дешёвый способ сохранить узнаваемость персонажа в серии рендеров.
- Передача стиля словами. Дайте список терминов стиля, которые вам нравятся, например «гуашь, приглушённая палитра, зернистость», и попросите включить их в последнее предложение каждого промпта.
- Негативные формулировки. Если ваш инструмент для изображений принимает отдельный негативный промпт, попросите модель вернуть два поля в режиме JSON:
promptиnegative. Держите негативный список коротким и конкретным. - Сокращение. Некоторые инструменты обрезают длинный ввод. Добавьте лимит слов в правила и протестируйте его, поскольку модели считают слова приблизительно.
Зрелая проза и ролевой арт для взрослых — это законный случай здесь. Модель напишет описание сцены простым, без откровенных подробностей, если вы попросите её об этом. Если вы работаете на платформе со своими правилами контента, поместите эти правила в системное сообщение также, чтобы промпты соответствовали тому месту, где будут опубликованы картинки.
Тестирование и настройка цикла
Относитесь к системному сообщению как к коду. Выберите пять тестовых идей, охватывающих ваш обычный диапазон, запустите их с фиксированным seed и низкой температурой и сохраните выводы. После каждого изменения правил запустите те же пять и сравните. Это выявляет распространённый сбой, когда исправление для одного случая ломает другое.
Ищите три симптома. Промпты, повторяющие одни и те же начальные слова в пакете, означают, что температура слишком низкая или примеры слишком однородны. Промпты, игнорирующие ваш лимит слов, означают, что правило потеряно; переместите его в конец сообщения. Промпты, включающие болтливые вступления, такие как «Вот ваш промпт», означают, что правило формата должно быть строже, или вы можете удалить первую строку в коде. Потоковая передача с stream: true доступна, если вы показываете результаты в интерфейсе, а использование сообщается в конце потока.
Лимиты, которые нужно учитывать
Три честных ограничения. Во-первых, модель работает только с текстом: она не может видеть изображение, поэтому не может оценить, дал ли промпт хорошую картинку. Вы — судья, а цикл — написать, рендерить, настроить правила. Во-вторых, она ничего не знает о причудах вашей конкретной модели изображений, если вы ей не скажете, поэтому поместите эти причуды в системное сообщение. В-третьих, лимиты запросов: полный ключ позволяет 8 одновременных запросов и 300 в минуту, а пробный ключ — 2 и 60. Если цикл превышает это, вы получаете HTTP 429 с кодом concurrency или rate_limited; подождите немного и повторите попытку. 429 с заголовком Retry-After: 5 означает временную перегрузку, и применяется тот же совет.
Сколько это стоит за промпт
Тарификация составляет $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. Предположим, что каждый запрос отправляет системное сообщение и идею на 800 токенов и возвращает промпт на 200 токенов. За 500 запросов это 400 000 входных токенов и 100 000 выходных токенов. Вход: 0,4 x $0,15 = $0,06. Выход: 0,1 x $0,50 = $0,05. Итого: $0,11 за 500 промптов.
Вышеуказанный JSON-пакет, примерно 400 токенов на вход и 700 на выход за вызов, стоит 0,0004 x $0,15 плюс 0,0007 x $0,50, что составляет $0,00006 + $0,00035 = $0,00041 за восемь промптов. Пробный баланс составляет $0,50, который можно получить одним кликом после регистрации. Пополнения начинаются от $20; см. страницу с ценами для бонусных уровней и страницу ключей, чтобы начать.
Дополнительные руководства
Вопросы и ответы
Может ли модель писать промпты для любого генератора изображений?
Да, потому что она генерирует только текст. Вы указываете формат, который предпочитает ваш инструмент для изображений, в системном сообщении, а затем копируете результат.
Будет ли она отказываться от зрелых или мрачных тем?
Модель настроена на ответы без отказов в контенте для законного использования взрослыми. Сексуальный контент с участием несовершеннолетних всегда запрещен.
Сколько промптов я могу создавать в минуту?
Полный ключ позволяет 300 запросов в минуту и 8 одновременно. В режиме JSON один запрос может вернуть несколько промптов.
Генерирует ли она также картинки?
Нет. API работает только с текстом, без генерации изображений, аудио или видео.
До вашего ключа — всего одна форма
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.