Документация API

okboolean

true — запрос обработан.

versionstring

Версия API: v1.

okboolean

Успешный запрос.

balanceobject

Баланс владельца ключа.

balance.currencystring

Валюта: RUB.

balance.amountnumber

Доступная сумма в рублях; может быть дробной.

okboolean

Успешный запрос.

modelsarray<object>

Активные модели. Порядок и состав могут меняться.

models[].typestring

image, video или music.

models[].model_keystring

Ключ для создания генерации.

models[].titlestring

Название для интерфейса.

models[].price_rubnumber | object

Стоимость в рублях. Число — фиксированная цена; объект — таблица вариантов. Изображения: resolution → цена; GPT Image 2.5: generation_mode → text/reference → resolution → цена. Видео: resolution → duration_sec → цена, либо duration_sec → цена. Музыка: цена за одну задачу. Видео в таблице рассчитано без звука; режим Fast и звук могут менять стоимость.

models[].defaultsobject

Параметры по умолчанию для модели; null означает отсутствие настройки. Ключи описаны в параметрах генерации.

models[].parametersobject

Словарь parameter_name → описание параметра. null означает, что параметр не поддерживается.

models[].parameters.*.typestring

string, integer, number, boolean или array<string>.

models[].parameters.*.requiredboolean

Обязательность. Условные требования указаны в note; отсутствие поля не означает обязательность.

models[].parameters.*.valuesarray

Разрешённые значения, если параметр является перечислением.

models[].parameters.*.min / maxnumber

Числовые границы, число символов строки или максимум элементов массива. Поля могут отсутствовать.

models[].parameters.*.defaultany

Значение при отсутствии параметра; может отсутствовать.

models[].parameters.*.notestring

Дополнительные условия использования; может отсутствовать.

{
  "ok": true,
  "models": [
    {
      "type": "image",
      "model_key": "gpt-image-2.5",
      "title": "GPT-Image 2.5",
      "price_rub": {
        "fast": {
          "text": {
            "1K": 3,
            "2K": 5,
            "4K": 8
          },
          "reference": {
            "1K": 3,
            "2K": 5,
            "4K": 8
          }
        },
        "quality": {
          "text": {
            "1K": 3,
            "2K": 5,
            "4K": 8
          },
          "reference": {
            "1K": 3,
            "2K": 5,
            "4K": 8
          }
        }
      },
      "defaults": {
        "aspect_ratio": "9:16",
        "resolution": "1K",
        "count": 1,
        "generation_mode": "fast"
      },
      "parameters": {
        "prompt": {
          "type": "string",
          "required": true,
          "max": 20000,
          "min": 1
        },
        "aspect_ratio": {
          "type": "string",
          "values": [
            "auto",
            "1:1",
            "3:2",
            "2:3",
            "4:3",
            "3:4",
            "16:9",
            "9:16",
            "21:9",
            "27:16",
            "16:27",
            "9:8",
            "8:9"
          ],
          "default": "9:16"
        },
        "generation_mode": {
          "type": "string",
          "values": [
            "fast",
            "quality"
          ],
          "default": "fast",
          "note": "fast — Быстро, quality — Качественно. Цена зависит также от разрешения и наличия референсов."
        },
        "resolution": {
          "type": "string",
          "values": [
            "1K",
            "2K",
            "4K"
          ],
          "default": "1K"
        },
        "count": {
          "type": "integer",
          "min": 1,
          "max": 4,
          "default": 1
        },
        "reference_urls": {
          "type": "array<string>",
          "required": false,
          "max": 16,
          "note": "Только публичные HTTPS URL изображений."
        }
      }
    }
  ]
}

Показана одна модель. Реальный ответ содержит весь доступный каталог.

Используйте доступные по HTTPS ссылки на изображения. Не передавайте локальные пути, Telegram file_id, base64 или multipart. Сервер модели должен иметь возможность скачать файл без cookies и дополнительных заголовков.

Для временной ссылки оставьте запас срока действия на очередь и обработку. Замените все адреса example.com в примере на свои. Лимит количества референсов зависит от модели; лишние элементы сервер обрезает.

okboolean

true — задача принята.

job_idinteger | string

Номер задачи. У музыки строка music_123; у фото и видео — число. При count > 1 это первая задача.

job_idsarray<integer>

Все созданные задачи. Только для изображений, в том числе при count=1.

statusstring

queued — задача поставлена в очередь.

cost_rubnumber

Общая списанная стоимость запроса в рублях.

unit_cost_rubnumber

Цена одного изображения. Только для type=image.

{
  "ok": true,
  "job_id": 123,
  "job_ids": [
    123
  ],
  "status": "queued",
  "cost_rub": 8,
  "unit_cost_rub": 8
}

Номера задач, стоимость и ссылки в этом примере условные.

okboolean

Успешный запрос статуса. При job.status=error значение ok всё равно true.

jobobject

Состояние одной задачи.

job.job_idinteger | string

Номер задачи; строка music_123 для музыки.

job.typestring

image, video или music.

job.statusstring

queued — в очереди; generating — создаётся; done — готово; error — ошибка. При другом промежуточном статусе продолжайте проверку с паузой.

job.modelstring | null

Внутренний код модели. Может отличаться от входного model_key; для новых запросов используйте ключ из каталога.

job.model_titlestring | null

Название модели; для музыки может совпадать с её кодом.

job.aspect_ratiostring | null

Формат кадра. Отсутствует у музыки.

job.duration_secnumber | null

Запрошенная длительность видео. Отсутствует у музыки; у изображения обычно null.

job.cost_rubnumber

Стоимость этой задачи в рублях.

job.resultobject | null

Результат или null, пока файл не доступен. Проверяйте status, а затем наличие URL.

job.result.urlstring | null

HTTPS-ссылка на файл; у музыки — первый трек. Подписанные ссылки хранилища действуют 1 час с момента выдачи; новый GET выдаёт свежую ссылку.

job.result.mimestring | null

MIME-тип, например image/webp, video/mp4, audio/mpeg.

job.result.tracksarray<object>

Только музыка. Все доступные треки одной задачи.

job.result.tracks[].indexnumber

Порядковый номер трека, начиная с 1.

job.result.tracks[].titlestring

Название трека.

job.result.tracks[].durationnumber | null

Длительность трека в секундах, если известна.

job.result.tracks[].urlstring | null

Временная ссылка на аудио.

job.result.tracks[].mimestring

audio/mpeg.

job.result.tracks[].image_urlstring | null

Обложка, если получена от модели.

job.errorstring | null

Описание ошибки задачи; null при отсутствии ошибки.

job.created_atstring | null

Дата и время создания задачи.

{
  "ok": true,
  "job": {
    "job_id": 123,
    "type": "image",
    "status": "done",
    "model": "example-model-code",
    "model_title": "GPT-Image 2.5",
    "aspect_ratio": "1:1",
    "duration_sec": null,
    "cost_rub": 8,
    "result": {
      "url": "https://example.com/result.webp",
      "mime": "image/webp"
    },
    "error": null,
    "created_at": "2026-09-10T12:00:00.000Z"
  }
}

Номера задач, стоимость и ссылки в этом примере условные.

countimage

Округляется вниз и ограничивается диапазоном 1–4. По умолчанию 1.

resolutionimage / video

Неподдерживаемое значение заменяется на разрешение по умолчанию. Передавайте значение из каталога.

aspect_ratiovideo

Если значение не поддерживается, используется допустимый формат по умолчанию. У изображений неверный формат возвращает 400.

duration_secmusic

Для Chirp v5.5 целое число 10–360; неверное значение заменяется на 20. В других музыкальных моделях параметр не используется.

title / description / lyrics / custom_stylemusic

Пробелы по краям удаляются; текст обрезается до 120 / 1500 / 4000 / 700 символов соответственно. Режим по умолчанию — description. В custom_style свой стиль имеет приоритет над пресетом.

style_weight / weirdness_constraint / audio_weightmusic

Ограничиваются диапазоном 0–1 и округляются до двух знаков; по умолчанию 0.65.

booleanvideo / music

Рекомендуются JSON true/false. Для совместимости принимаются строки true/false, 1/0, yes/no, on/off.