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

Ключевые моменты
- Ключ для сервиса изображений Flux и ключ для текстового LLM API — это две разные вещи, выданные двумя разными провайдерами.
- Этот сайт работает только с текстом: нет генерации изображений, аудио или видео, и им не управляет ни один вендор моделей изображений.
- Ключ для текста полезен рядом с ключом для изображений, потому что написание промпта — это текстовая задача, за которую вы платите за каждый токен.
- Вы меняете один базовый URL и один ключ в любом клиенте, совместимом с OpenAI, чтобы начать, а пробный баланс покрывает первые тесты.
Что обычно имеют в виду под ключом Flux
Flux — это название семейства моделей генерации изображений по тексту. Когда кто-то вводит в поисковую строку flux api key, он почти всегда хочет получить учетные данные, которые позволят его коду отправить промпт в сервис, хостящий одну из этих моделей изображений, и получить картинку. Эти учетные данные выдаются той компанией, которая управляет эндпоинтом изображений, который вы выбрали. Они привязаны к их аккаунту, их биллингу и их условиям.
Вы увидите, что эта фраза используется в нескольких немного разных значениях, и полезно разобраться в них, прежде чем вставлять ключ куда-либо:
- Ключ от хостера изображений, который обслуживает модели Flux, используемый в запросе, возвращающем изображение.
- Ключ для локальной или самохостинговой настройки, где вы создаете токен самостоятельно, и ничего не покидает вашу машину.
- Ключ для другого инструмента в вашем конвейере, например текстовой модели, которая пишет промпты, которую называют Flux только потому, что проект так называется.
Только первые два создают картинки. Третий — это то, чем занимается этот сайт. Мы запускаем хостинговое LLM API, совместимое с OpenAI, и ключ, который вы получите здесь, работает только с этим API и ничем другим.
Почему ключ для изображений не вызывает чат-модель
Два вида ключей выглядят похоже, так как оба представляют собой длинные строки, которые вы отправляете в заголовке Authorization, но они открывают разные двери. Ключ провайдера изображений проверяется провайдером изображений. Если вы отправите его в чат-эндпоинт, вы получите ошибку аутентификации, и наоборот: ключ с этого сайта вернет ошибку, если вы отправите его хостеру изображений.
Тела запросов также различаются. Запрос на изображение обычно содержит промпт, размеры, сид и количество картинок. Запрос на чат содержит список сообщений с ролями и возвращает текст. Нет общей схемы, поэтому нет ничего, что можно было бы перевести между ними. Если у вас есть скрипт, работающий с хостером изображений, оставьте этот скрипт и его ключ точно такими, какие они есть. Добавьте текстовый вызов как отдельный шаг перед ним.
Что этот сервис не делает
Чтобы ожидания были ясными: API здесь только текстовый. Он не генерирует изображения, аудио или видео, не создает эмбеддинги и не предлагает дообучение. Это не официальный API какого-либо вендора моделей и не роутер между вендорами. Он обслуживает одну модель с открытыми весами, настроенную на ответы без отказов по контенту для законного использования взрослыми, и запущен независимым провайдером. ID модели, которую вы передаете, — uncensored.
Где текстовый API подходит рядом с ключом для изображений
Написание промптов — очевидное место встречи. Модели изображений хорошо реагируют на конкретные, структурированные описания: субъект, обстановка, объектив, освещение, цвет, настроение. Большинство людей пишут их вручную, а затем переписывают после неудачного результата. Текстовая модель может сделать первый черновик, расширить идею из трех слов до полного описания или создать двадцать вариаций на тему, пока вы идете за кофе.
Несколько задач, которые хорошо подходят:
- Расширение. Превратите короткую идею в подробный промпт в стиле, который вы один раз задали в системном сообщении.
- Вариации. Запросите десять разных вариантов на одну тему, возвращенных в виде списка JSON, который ваш скрипт может перебирать.
- Очистка. Переписайте беспорядочный промпт, написанный клиентом, в промпт, который модель изображений обработает лучше.
- Скрипты и подписи. Напишите озвучку, список кадров или подпись, которая идет рядом с картинкой.
Поскольку модель здесь по умолчанию не отказывает, она подходит для художественной прозы, дизайна персонажей и зрелых тем, которые другие хостинговые модели часто отклоняют, если использование законно и касается взрослых. Одно жесткое ограничение применяется везде: нет сексуального контента с участием несовершеннолетних. Запросы такого типа мы не поддерживаем ни в каком виде.
Первый запрос за минуту
Любой SDK OpenAI или HTTP-клиент работает после замены базового URL и ключа. Эндпоинт для чата — POST /v1/chat/completions, а GET /v1/models перечисляет модель. Вот тот же запрос в curl и на Python.
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)
Любая возвращенная строка — это то, что вы передаете своему сервису изображений, используя ключ этого сервиса. Эти два сервиса никогда не соприкасаются. Полный список параметров, включая потоковую передачу, вызов функций и JSON-режим, см. в API документации.
Нужны ли вам оба ключа?
Это зависит от того, что вы строите. Таблица ниже — быстрый способ принять решение.
| Ваша цель | Ключ для изображений | Текстовый ключ |
|---|---|---|
| Генерировать картинки из промптов, которые вы пишете сами | Да | Нет |
| Генерировать картинки из промптов, которые пишет или расширяет модель | Да | Да |
| Писать только истории, диалоги или сценарии | Нет | Да |
| Создать чат или приложение для ролевой игры для взрослых | Нет | Да |
| Пакетно создавать сотни вариаций промптов | Опционально | Да |
Если вы всегда вводите свои собственные промпты и довольны ими, текстовый ключ добавляет мало. Если вы обнаруживаете, что переписываете промпты весь день или вам нужен объем, он быстро окупает свою стоимость. У нас также есть краткое руководство по использованию текстовой LLM в рабочих процессах видео, которое следует той же идее текстового шага перед медиа-шагом.
Ошибки, возникающие из-за путаницы ключей
Большинство проблем в двухсервисной настройке невелики и легко обнаруживаются, если знать, что искать.
- Неверный базовый URL. Если ваш клиент все еще указывает на старый хостер, новый ключ будет отклонен. Проверьте, что базовый URL заканчивается на
/v1и совпадает с тем, что в примере выше. - Неверное имя модели. Единственный ID модели здесь —
uncensored. Передача имени модели изображений возвращает ошибку, потому что такой модели в этом API нет. - Ключи в одной переменной окружения. Дайте каждому сервису свою переменную, например
TEXT_API_KEYиIMAGE_API_KEY. Использование одного имени — это то, как ключ попадает не на тот хостер. - Ожидание картинок в ответе. Ответ — это обычный текст в
choices[0].message.content. Если вам нужна картинка, этот текст должен быть отправлен в ваш сервис изображений как второй вызов. - Игнорирование 429. Всплеск выше 8 параллельных запросов возвращает код 429 с ошибкой
concurrency, а свыше 300 запросов в минуту — с ошибкойrate_limited. Сделайте небольшую паузу и повторите запрос. Потоковый запрос удерживает слот до завершения потока, поэтому закрывайте потоки, которые вы больше не читаете.
Пробный ключ имеет более низкие пределы: 2 параллельных запроса и 60 в минуту. Этого достаточно для тестирования шага написания промптов вручную, но большая пакетная обработка должна ждать пополненного ключа.
Сколько стоит написание промпта
Оплата идёт за токены и вносится заранее: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов, без подписки. Задачи по промптам небольшие, поэтому суммы тоже небольшие. Возьмём запрос с системным сообщением и идеей (вход) на 600 токенов и расширенным промптом (выход) на 250 токенов. Входные данные обойдутся в 600 / 1 000 000 × $0,15 = $0,00009. Выходные данные обойдутся в 250 / 1 000 000 × $0,50 = $0,000125. Один запрос стоит $0,000215.
Пакет из 1 000 таких запросов стоит около $0,215. Пробный баланс в размере $0,50, который вы можете получить одним кликом на странице ключа после регистрации, покрывает примерно 2 300 таких запросов (0,50 / 0,000215). Карта не нужна, срок действия — 7 дней. За неудачные или отклонённые запросы не списываются средства, а добавленный вами баланс не сгорает. Подробности на странице тарифов.
Получение текстового ключа
Зарегистрируйтесь через Google или с помощью электронной почты и пароля, затем откройте страницу API-ключа. Получите пробный баланс там, если хотите сначала протестировать. Платные пополнения начинаются от $20 до $500 любой целой суммой, с бонусом +5% от $50, +10% от $100 и +15% от $200. Вы можете оплатить криптовалютой (USDT на TRC20, USDC на Base).
Храните ключ в стороне от клиентского кода и публичных репозиториев. Промпты, которые вы отправляете, не используются для обучения, но утечка ключа приведёт к расходу вашего баланса. Полный ключ позволяет выполнять 8 параллельных запросов и 300 запросов в минуту, поэтому пакет промптов может выполняться параллельно без дополнительных усилий.
Дополнительные руководства
Вопросы и ответы
Могу ли я использовать этот ключ для генерации изображений с помощью Flux?
Нет. Ключ работает только с текстовым API этого сайта. Генерация изображений требует ключа от провайдера, который хостит модель изображений.
Это официальный API Flux?
Нет. Это независимое хостинговое текстовое API, совместимое с OpenAI, с одной моделью под названием uncensored. Оно не управляется ни одним поставщиком моделей изображений и не перепродаёт их услуги.
Может ли текстовая модель писать промпты для моего инструмента для изображений?
Да. Запросите промпт в системном сообщении, возьмите текст ответа и вставьте или отправьте его в ваш сервис изображений. Два сервиса остаются независимыми.
Нужна ли карта, чтобы попробовать?
Нет. Новые пользователи могут получить $0,50 пробного баланса одним кликом на странице ключа, сроком на 7 дней, без необходимости привязки карты.
До вашего ключа — всего одна форма
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.