Краткий ответ
Фраза image gen api openai может означать две разные вещи, и полезно их разделить. Одна — это собственный сервис генерации изображений OpenAI, который принадлежит OpenAI и к которому вы обращаетесь с учетной записью OpenAI. Другая — любой сервис, копирующий формат запросов OpenAI, чтобы существующие SDK и инструменты продолжали работать. Этот сайт относится ко второму типу и предназначен только для текста.
Здесь вы получаете размещенный API текстовой LLM без цензуры. Вы указываете клиент OpenAI на базовый URL ниже, устанавливаете модель в uncensored и получаете завершения чата. Пиксели не возвращаются. Нет генерации изображений, аудио или видео, нет эмбеддингов и нет дообучения, и ни одно из этого не планируется в рамках того, что описано на этих страницах.
Что совместимо, а что нет
Слово «совместимый» часто растягивают в маркетинге, поэтому вот точная поверхность. Базовый URL — https://api.imagegenapi.com/v1, аутентификация — Authorization: Bearer <key>, и существует два метода.
| Эндпоинт | Доступно здесь | Примечания |
|---|---|---|
POST /v1/chat/completions | Да | Потоковая передача, вызов функций, JSON-режим |
GET /v1/models | Да | Список: uncensored |
| Эндпоинты генерации изображений | Нет | Сервис только для текста |
| Эмбеддинги, аудио, дообучение | Нет | Не предлагается |
Если ваш код обращается к пути изображения на этом базовом URL, ожидайте ошибку, а не картинку. То же самое относится к любой функции OpenAI вне двух вышеуказанных методов. Известные вам параметры сэмплирования работают: temperature, top_p, stop, seed, и штрафы передаются, и ответ может использовать полное контекстное окно на 100 000 токенов, разделяемое между промптом и завершением.
Также стоит прояснить вопрос идентичности. Модель за uncensored — это одна модель с открытыми весами, запускаемая независимым провайдером. Это не API OpenAI, он не проксирует модели OpenAI и не связан с OpenAI. Соответствующая страница на этом сайте, GPT image API и uncensored text, рассматривает это различие с точки зрения названий моделей изображений.
Почему возникает этот вопрос
Люди попадают на такие страницы по понятным причинам. Инструменты для изображений управляются текстовыми промптами, текстовые промпты пишутся языковыми моделями, и многие шлюзы языковых моделей используют один формат запросов. Естественное предположение — что один API делает и то, и другое.
На практике эти две задачи — отдельные системы с отдельными ключами, отдельным ценообразованием и отдельными правилами. Служба изображений принимает промпт и возвращает изображение. Текстовая служба принимает сообщения и возвращает больше текста. Связь между ними — это вы или написанный вами скрипт, передающий текст от одного к другому. Как только вы увидите это так, полезный вопрос изменится с «делает ли этот API изображения» на «может ли этот API писать лучшие промпты для модели изображений, которую я уже использую».
Это реальный сценарий использования, и место, где может иметь значение текстовая модель без цензуры. Универсальные помощники часто переписывают, смягчают или отказываются от запросов на промпты, касающиеся тем для взрослых в художественной литературе, насилия в сеттинге истории или темной эстетики. Модель, настроенная на ответ на законные запросы взрослых без отказов, обычно выполняет задачу написания так, как требуется. Жесткое ограничение остается: нет сексуального контента с участием несовершеннолетних ни при каком оформлении.
Использование текстового API для написания промптов для изображений
Вот небольшой рабочий пример. Он просит модель создать подробный промпт, который вы затем вставляете в любой генератор изображений, который вы используете. Код использует официальный Python SDK OpenAI против этого базового URL.
from openai import OpenAI
client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")
reply = client.chat.completions.create(
model="uncensored",
temperature=0.8,
messages=[
{"role": "system", "content": "You write prompts for text-to-image models. Reply with one paragraph: subject, composition, lighting, palette, lens or style. No preamble."},
{"role": "user", "content": "A ruined lighthouse at dusk for a dark fantasy book cover."},
],
)
print(reply.choices[0].message.content)Тот же вызов из командной строки:
curl https://api.imagegenapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Write a one-paragraph image prompt: a ruined lighthouse at dusk, dark fantasy cover art."}]}'Делает вывод пригодным для использования
Генераторы изображений различаются тем, что они принимают, поэтому формируйте результат с помощью системного сообщения. Запросите фиксированную структуру, ограничение на количество слов и список того, чего следует избегать. Если вам нужен промпт внутри конвейера, запросите JSON с response_format, установленным в тип json_object, и запросите ключи, такие как prompt и negative. Затем разберите его и передайте поля в ваш клиент изображений. Установка seed и низкого temperature дает более воспроизводимый результат при итерациях над формулировками.
Пакетный процесс с реальными цифрами
Предположим, вы генерируете промпты для 1 000 сцен. Каждый запрос отправляет около 300 токенов (инструкции плюс краткая заметка о сцене) и получает промпт примерно на 200 токенов. Тарификация составляет $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов.
- Один запрос, вход: 300 / 1 000 000 x $0,15 = $0,000045.
- Один запрос, выход: 200 / 1 000 000 x $0,50 = $0,0001.
- Один запрос всего: $0,000145.
- 1 000 запросов: 1 000 x $0,000145 = $0,145.
Так что тысяча промптов стоит около 14,5 цента, а текстовый шаг обычно составляет небольшую часть счёта по сравнению с самой генерацией изображений, цену на которую следует уточнить у этого провайдера. Полный ключ позволяет 8 параллельных запросов и 300 запросов в минуту, так что 1 000 запросов помещаются за несколько минут с небольшим пулом воркеров. Обрабатывайте HTTP 429 ожиданием; заголовок Retry-After: 5 указывает, сколько ждать при временной перегрузке.
Вы можете попробовать всё это без оплаты. После регистрации на странице API-ключ есть пробный баланс $0,50 в один клик, действительный в течение 7 дней. В долгосрочной перспективе пополнения варьируются от $20 до $500 и оплачиваются криптовалютой (USDT на TRC20 или USDC на Base); см. тарифы для уровней бонусов.
Ошибки, которых следует избегать
Несколько ошибок повторяются снова и снова, когда кто-то пытается использовать эндпоинт в стиле OpenAI для задач с изображениями.
- Обращение к пути изображения и ожидание картинки. Здесь доступны только два задокументированных метода. Проверьте тело ошибки, а не повторяйте попытку, потому что повторные попытки не изменят результат.
- Попросить текстовую модель «нарисовать» что-то. Она может ответить ASCII-артом, описанием или извинением. Если вам нужна картинка, отправьте промпт, который она напишет, в настоящий генератор изображений.
- Пропуск списка моделей. Быстрый вызов
GET /v1/modelsподтверждает, что ключ работает и что единственной моделью являетсяuncensored. Это ничего не стоит. - Игнорирование ответов 429. Пробный ключ позволяет 2 параллельных запроса, поэтому цикл с десятью рабочими процессами быстро завершится ошибкой. Ограничьте количество рабочих процессов или добавьте короткую задержку.
- Отправка очень больших тел запросов. Лимит составляет 8 МБ на запрос. Запросы на написание промптов крошечные, поэтому это редко имеет значение, но вставленные документы могут достичь этого лимита.
Ни одна из этих ошибок не сложна в исправлении, и самое быстрое лекарство — десятистрочный тестовый скрипт, запущенный перед тем, как подключить что-либо в более крупный инструмент.
Когда другой сервис подходит лучше
Будьте практичны в выборе. Если вам нужна сама картинка, вам нужен поставщик изображений, и OpenAI — один из нескольких; посмотрите его текущую документацию и тарификацию для деталей того, что он предлагает. Если ваша единственная цель — чистый промпт в общепринятом стиле, стандартного помощника может быть достаточно, и вам вообще не понадобится этот сервис.
Этот API лучше подходит, когда текстовый шаг является узким местом: помощник, который вы используете, отказывается или смягчает ваши запросы промптов, вам нужен большой объем промптов по предсказуемой цене за токен, или вы хотите совместимый с OpenAI эндпоинт для художественной литературы, ролевых игр и инструментов-компаньонов для законного использования взрослыми без переписывания кода клиента. Для получения полной информации о параметрах в документации есть формат запроса и коды ошибок.
Еще одна практическая заметка: промпты, отправленные в этот API, не используются для обучения. Тем не менее, относитесь к любой размещенной службе как к внешней по отношению к вашему компьютеру и избегайте отправки секретов, которые вы не стали бы вставлять в веб-форму.
