Генерация изображений: запрос, base64 и сохранение файла

Как это устроено

Публичный Images API Токенмоста создаёт изображения по текстовому prompt и возвращает результат в data[].b64_json. Нужны Bearer-ключ с доступом к Images, положительный баланс, точный ID image-модели и уникальный Idempotency-Key. Редактирование входного изображения этим методом не поддерживается.

Что потребуется

• Положительный доступный баланс и API-ключ с областью Images.
• Точный ID image-модели из каталога; текстовая модель не получает поддержку изображений автоматически.
• Достаточно памяти и места для декодирования base64 вне журналов приложения.

Порядок работы

1. Проверьте image-модель, опубликованный тариф и доступные для неё размеры в каталоге или песочнице.
2. Отправьте POST /v1/images/generations с model, непустым prompt, n, size и response_format: b64_json.
3. Сохраните исходный Idempotency-Key вместе с телом. При неопределённом исходе повторяйте только ту же пару ключа и тела.
4. Проверьте HTTP-статус, длину data и media_type. Декодируйте b64_json в бинарный файл; не записывайте base64 в журнал.
5. Сверьте итоговую операцию и списание в кабинете. Обрабатывайте фактический массив data: результатов может быть меньше n.

Готовая конфигурация

curl "https://tokenmost.ru/v1/images/generations" \
  -H "Authorization: Bearer $TOKENMOST_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: image-demo-0001" \
  -d '{
    "model": "google/gemini-3.1-flash-image",
    "prompt": "Синий стеклянный мост над спокойной рекой, мягкий утренний свет",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json"
  }' > image-response.json

import { readFile, writeFile } from "node:fs/promises";

const response = JSON.parse(await readFile("image-response.json", "utf8"));
if (!response.data?.[0]?.b64_json) throw new Error("Изображение отсутствует");
const bytes = Buffer.from(response.data[0].b64_json, "base64");
await writeFile("result.png", bytes);
console.log({ id: response.id, bytes: bytes.length });

$response = Get-Content .image-response.json -Raw | ConvertFrom-Json
if (-not $response.data[0].b64_json) { throw "Изображение отсутствует" }
[IO.File]::WriteAllBytes(
  (Join-Path $PWD "result.png"),
  [Convert]::FromBase64String($response.data[0].b64_json)
)

Пример запроса

Укажите TOKENMOST_BASE_URL=https://tokenmost.ru/v1, ключ проекта и точный ID модели из каталога. Пример отправляет запрос в публичный API и может списать средства с баланса по тарифу модели.

curl "https://tokenmost.ru/v1/images/generations" \
  -H "Authorization: Bearer $TOKENMOST_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: image-example-0001" \
  -d '{
    "model": "IMAGE_MODEL_ID_FROM_CATALOG",
    "prompt": "Минималистичная иллюстрация синего моста на светлом фоне",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

Что учесть

Генерация выполняет реальный платный запрос. Начните с n: 1, поддерживаемого размера и отдельного ключа с небольшим бюджетом. Не записывайте API-ключ или b64_json в логи.

Ошибки и диагностика

Источники и связанные инструкции

• Справочник публичного API
• Idempotency-Key
• Баланс и стоимость
• API-песочница

Читайте дальше

• Эмбеддинги: подготовка семантического поиска
• Rerank: повторная оценка найденных документов
• PDF: подготовка документа к анализу моделью
• Модели и цены Токенмоста