Руководство по генерации изображений через LLM API Gateway
Всё об API генерации изображений, выборе модели, настройке параметров и способах вызова.
В LLM API Gateway уже доступна генерация изображений.
Обложки для официальных аккаунтов, иллюстрации продуктов, значки приложений, изображения товаров и автоматические иллюстрации для Agent — всё это можно создавать напрямую через единый API.
API генерации изображений:POST https://api.llm-token.cn/v1/images/generations
1. Главное: для начала нужны всего 3 вещи ✨
| Что потребуется | Как указать |
|---|---|
| Ключ LLM API Gateway | Укажите в заголовке запроса Authorization: Bearer 你的new-api-token |
| API генерации изображений | https://api.llm-token.cn/v1/images/generations |
| Модель генерации изображений | image-01 или image-01-live |
LLM API Gateway уже объединяет подключение моделей, адаптацию API, управление лимитами и правила тарификации. Достаточно собственного ключа LLM API Gateway, чтобы вызывать генерацию изображений через единый API.
2. Запуск за 1 минуту: пример curl 🚀
Замените YOUR_NEW_API_TOKEN ниже на собственный ключ LLM API Gateway — и можно сразу тестировать.
curl https://api.llm-token.cn/v1/images/generations \
-H "Authorization: Bearer YOUR_NEW_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "image-01",
"prompt": "一张可爱的蓝色 AI 小机器人图标,白色背景,极简 3D 风格,居中构图,不要文字",
"response_format": "url",
"n": 1,
"aspect_ratio": "1:1",
"prompt_optimizer": false
}'Для первого теста рекомендуем сгенерировать 1 изображение, то есть указать n: 1. Убедившись, что генерация работает, настройте пропорции, стиль и количество по необходимости.
3. Как заполнить параметры запроса? 🧩
| Параметр | Обязательный | Типичное значение | Описание |
|---|---|---|---|
model | Да | image-01 | Название модели генерации изображений. Для генерации с более актуальными данными можно указать image-01-live. |
prompt | Да | В соответствии с требованиями к изображению | Описание нужного изображения. Рекомендуем указать объект, стиль, цвета, композицию и назначение. |
response_format | Нет | url | Рекомендуется url: он возвращает прямую ссылку на изображение. При необходимости можно использовать base64. |
n | Нет | 1 | Количество изображений за один запрос. Для обычного теста рекомендуем начать с 1. |
aspect_ratio | Нет | 1:1 | Соотношение сторон. Частые варианты: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9. |
prompt_optimizer | Нет | false | Включает оптимизацию промпта. Если важно точнее следовать исходному тексту, рекомендуем false. |
seed | Нет | Целое число | Повышает воспроизводимость. Чтобы несколько раз получать похожий результат, используйте одно значение seed. |
width / height | Нет | Обычно не требуется | В большинстве случаев достаточно aspect_ratio; передавайте эти параметры только для точной ширины и высоты. |
Если ответ содержит URL изображения, рекомендуем сразу сохранить файл. Ссылка подходит для временного просмотра и скачивания, но не как постоянный адрес исходного материала.
4. Почему LLM API Gateway удобнее? 🍬
При обычном подключении приходится постоянно переключаться между платформами моделей: разные ключи, API и способы тарификации усложняют разработку и поддержку.
LLM API Gateway объединяет всё это. Один ключ LLM API Gateway позволяет вызывать генерацию изображений через единый API. Расход, коэффициент и баланс отображаются в панели LLM API Gateway, поэтому ими удобно управлять.
| Возможность | Описание |
|---|---|
| Единый API | Генерация изображений выполняется через https://api.llm-token.cn/v1/images/generations, что упрощает интеграцию. |
| Единый ключ | Используйте new-api-token, созданный в панели LLM API Gateway, без переключения между платформами. |
| Единая тарификация | Расход, коэффициент и баланс определяются данными панели LLM API Gateway, упрощая контроль затрат команды. |
| Подходит для интеграции в продукты | Подходит для иллюстраций официальных аккаунтов, изображений товаров, обложек продуктов, автоматических иллюстраций Agent и массового создания материалов. |
Коротко: один ключ LLM API Gateway и один API — и генерация изображений встроена в ваш продукт или рабочий процесс.
5. Как использовать image-01-live? ⚡
image-01-live работает через тот же API генерации изображений. Остальные параметры не меняются: достаточно заменить model на image-01-live.
{
"model": "image-01-live",
"prompt": "一张赛博风格的蓝色产品宣传图,干净背景,科技感,适合公众号封面",
"response_format": "url",
"n": 1,
"aspect_ratio": "16:9",
"prompt_optimizer": false
}Если модель доступна для вашей учётной записи, её можно вызывать именно так.
6. Пример на Python: использование в проекте 🐍
import requests
url = "https://api.llm-token.cn/v1/images/generations"
headers = {
"Authorization": "Bearer YOUR_NEW_API_TOKEN",
"Content-Type": "application/json",
}
payload = {
"model": "image-01",
"prompt": "一张科技感很强的蓝色应用图标,白色背景,极简 3D 风格,居中构图,不要文字",
"response_format": "url",
"n": 1,
"aspect_ratio": "1:1",
"prompt_optimizer": False,
}
resp = requests.post(url, headers=headers, json=payload, timeout=120)
resp.raise_for_status()
print(resp.json())Генерация изображений занимает больше времени, чем обычный текстовый диалог. Рекомендуем установить тайм-аут клиента примерно на 120 секунд, чтобы он не разорвал запрос до завершения генерации.
7. Как описать изображение для лучшего результата? 🪄
Для более стабильного результата описывайте изображение в следующем порядке:
- Объект: что нужно изобразить, например «синий робот AI» или «аналитический плакат чемпионата мира».
- Сцена: где находится объект, например «на белом фоне», «под светом стадиона» или «на офисном столе».
- Стиль: минимализм, реализм, 3D, иллюстрация, рекламный плакат, фотографическая эстетика и т. п.
- Композиция: по центру, вид сверху, поясной план, свободное пространство, горизонтальная обложка и т. п.
- Цвета: основные и дополнительные, например синий с белым, чёрный с золотым или контраст красного и синего.
- Ограничения: например «без текста», «без водяного знака», «чистый фон».
Можно использовать этот небольшой шаблон:
一张【比例】的【用途】图片,主体是【主体】,场景是【场景】,整体风格为【风格】,主色为【颜色】,构图【构图要求】,细节要求【限制或补充】。Пример:
一张 1:1 的应用图标,主体是蓝色发光的 AI 芯片,白色背景,极简 3D 风格,居中构图,边缘清晰,不要文字。8. Если возникла проблема 🛟
| Симптом | Решение |
|---|---|
| Ошибка аутентификации | Проверьте, что заголовок записан как Authorization: Bearer YOUR_NEW_API_TOKEN, и убедитесь, что вместе с token не скопированы лишние пробелы. |
| Модель не найдена | Убедитесь, что имя модели указано точно как image-01 или image-01-live, с тем же регистром. |
| Неверное соотношение сторон | Сначала измените aspect_ratio. Для типичной обложки официального аккаунта подойдёт 16:9, для аватара или значка — 1:1. |
| Ссылка на изображение не открывается | Возможно, срок действия URL изображения истёк. Скачивайте результат сразу после генерации или сохраняйте в собственной медиатеке. |
| Запрос долго выполняется | Генерация требует времени; рекомендуем установить тайм-аут запроса не менее 120 секунд. |
| Результат недостаточно стабилен | Опишите требования подробнее и устраните противоречия; для похожих результатов можно зафиксировать seed. |
9. Версия, которую можно сразу отправить разработчику 📮
Мы используем генерацию изображений через LLM API Gateway и API POST https://api.llm-token.cn/v1/images/generations. В заголовке запроса передаётся Authorization: Bearer YOUR_NEW_API_TOKEN, а в теле — model: image-01 или model: image-01-live вместе с параметрами prompt, response_format: url, n, aspect_ratio и другими.
10. Для каких задач подходит? 📚
| Сценарий | Как использовать |
|---|---|
| Иллюстрации для официальных аккаунтов / Xiaohongshu | Быстро создавайте обложки, главные изображения, афиши мероприятий и иллюстрации к статьям. |
| Страницы продуктов и SaaS | Создавайте значки приложений, иллюстрации функций, баннеры и иллюстрации пустых состояний. |
| Материалы для электронной коммерции и товаров | Создавайте фоны товаров, промоизображения и атмосферные иллюстрации для страниц с описанием. |
| Автоматизированные процессы Agent | Позвольте агенту автоматически создавать иллюстрации по содержанию и ускорьте выпуск контента. |