Генерация изображений

ru-llm предоставляет модели изображений (gpt-image-2, gemini-3.1-flash-image) через OpenAI-совместимый эндпоинт генерации изображений.

Эндпоинт

POST https://api.ru-llm.relay2.xyz/v1/images/generations

Запрос

curl https://api.ru-llm.relay2.xyz/v1/images/generations \
  -H "Authorization: Bearer sk-ru-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A red panda coding at a laptop, soft studio lighting",
    "size": "1024x1024",
    "n": 1
  }'

Поле	Тип	Обязательно	Описание
`model`	string	Да	ID модели изображений (например, `gpt-image-2`, `gemini-3.1-flash-image`).
`prompt`	string	Да	Текстовое описание изображения для генерации.
`size`	string	Нет	Разрешение, например `1024x1024`.
`n`	integer	Нет	Число изображений. По умолчанию: 1.

Ответ

Ответ следует формату изображений OpenAI и возвращает данные изображения в base64:

{
  "created": 1710000000,
  "data": [
    {"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."}
  ]
}

Декодируйте первое изображение в файл PNG:

curl ... | python3 -c "import sys,json,base64; \
open('out.png','wb').write(base64.b64decode(json.load(sys.stdin)['data'][0]['b64_json']))"

Тарификация

Тарификация зависит от модели. gpt-image-2 тарифицируется потокенно (вход/выход), как и чат-модели. gemini-3.1-flash-image тарифицируется за каждое сгенерированное изображение (тариф per_image); списание происходит после создания изображения. Актуальные тарифы — на странице Модели и цены.

Устранение неполадок

Симптом	Причина	Решение
`404 Not Found`	Эндпоинт пока не смонтирован (см. примечание о превью)	Используйте chat/messages, пока поверхность изображений не выйдет.
`401 Unauthorized`	Ключ отсутствует или неверен	Передайте корректный ключ `sk-ru-…`.
`402 Payment Required`	Нулевой баланс	Пополните в консоли → Billing.
`400` неизвестная модель	ID не является моделью изображений	Используйте `gpt-image-2` или `gemini-3.1-flash-image`.