Список медиа-моделей CreativeLab

Авторизация

Для отправки запросов нужен API ключ — см. раздел С чего начать?

Запрос списка моделей

GET https://gptunnel.ru/api/v2/media/models

Возвращает модели, доступные вашему API-ключу (с учётом списка разрешённых моделей, если он задан для ключа), вместе со схемой параметров (params), схемой входных файлов (inputs) и ценой. Эта схема — источник истины: используйте её, чтобы понять, какие params и inputs принимает конкретная модель.

Исключение — параметр voice у моделей озвучки: его значения живут в отдельном каталоге, см. список голосов.

Query-параметры

Параметр	Тип	Описание
type	string	Фильтр по типу модели (например IMAGE, VIDEO, AUDIO)

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

cURL

curl --request GET \
  --url 'https://gptunnel.ru/api/v2/media/models' \
  --header 'Authorization: YOUR_API_KEY'

Node.js

import axios from 'axios'

const { data } = await axios.get('https://gptunnel.ru/api/v2/media/models', {
  headers: { Authorization: 'YOUR_API_KEY' },
})

console.log(data)

Python

import requests

response = requests.get(
    'https://gptunnel.ru/api/v2/media/models',
    headers={'Authorization': 'YOUR_API_KEY'},
)

print(response.json())

Пример ответа

Набор моделей и их параметры могут отличаться от актуальных — ориентируйтесь на ответ эндпоинта.

{
  "code": 0,
  "models": [
    {
      "id": "kling-v3",
      "code": "kling-v3",
      "type": "VIDEO",
      "price": 210,
      "price_unit": "per_generation",
      "moderation": "auto",
      "prompt": "required",
      "params": [
        {
          "key": "resolution",
          "type": "enum",
          "label": "Разрешение",
          "default": "1080p",
          "options": [
            { "value": "720p", "label": "720p" },
            { "value": "1080p", "label": "1080p" }
          ]
        },
        {
          "key": "duration",
          "type": "number",
          "label": "Длительность",
          "default": 5,
          "min": 5,
          "max": 10,
          "step": 5,
          "integer": true,
          "unit": "s"
        },
        {
          "key": "aspect_ratio",
          "type": "enum",
          "label": "Соотношение сторон",
          "default": "16:9",
          "options": [
            { "value": "16:9", "label": "16:9" },
            { "value": "9:16", "label": "9:16" }
          ]
        }
      ],
      "inputs": [
        {
          "key": "image",
          "kind": "image",
          "role": "first_frame",
          "required": false,
          "count": { "min": 0, "max": 1 },
          "formats": ["jpg", "png", "webp"]
        }
      ]
    }
  ]
}

Поля модели

Параметр	Тип	Описание
id*	string	Идентификатор модели — передаётся в поле model при создании задачи
type	string	Тип модели (IMAGE, VIDEO, AUDIO)
price*	number	Цена в рублях с учётом действующих скидок — за то, что названо в price_unit. У per_generation это цена одной генерации; у per_second, per_megapixel и per_1k_tokens — ставка, которую умножат на длительность, площадь или число токенов. В любом случае это не итог: точную сумму за конкретную комбинацию параметров считает /media/price. У моделей, которые тарифицируются по входу, выходной оси нет — приходит 0, а поля price_unit нет
price_unit	string	За что берётся price: per_generation (генерация целиком), per_second (секунда результата), per_megapixel (мегапиксель результата) или per_1k_tokens (1000 токенов ответа). Список пополняется, см. оговорку ниже. Поля нет — цены за выход у модели нет, счёт идёт по входу (см. price_input)
price_input	number	Входная ставка в рублях с учётом действующих скидок — для моделей, которые тарифицируются по присланному вами: символам промпта, его токенам, мегапикселям приложенных изображений. За что она берётся, говорит price_input_unit
price_input_unit	string	За что берётся price_input: per_character, per_1k_characters, per_token, per_1k_tokens или per_megapixel. Список пополняется, см. оговорку ниже. Поля нет — вход отдельной позицией счёта не является
discount_percent	number	Процент скидки, уже учтённый в обеих ставках — price и price_input — и посчитанный для той же комбинации параметров. У моделей со счётом по входу price нулевой, и скидка видна только в price_input. Поля нет, когда скидки нет
pricing	object	Тарифное правило модели: как цена собирается из параметров. Всегда база ДО скидок. Есть не у всех моделей
prompt*	string	Требование к промпту: required, optional или none
params*	array	Схема настраиваемых параметров генерации: ключ, тип, допустимые значения, значение по умолчанию
inputs	array	Схема входных файлов: роль, форматы, число файлов, ограничения
deprecated	boolean	Дата снятия уже наступила — запросы выполняются на аналоге либо возвращают 410. Пока false, модель работает как обычно
deprecated_at	string	Дата и время снятия модели провайдером в формате ISO 8601. Дата в будущем — анонс: модель ещё работает, но время на переход ограничено
deprecation_redirect_to	string | null	id модели-аналога, на которой будут выполняться задачи после даты снятия — деньги при этом списываются по запрошенной модели. null — аналога нет, после даты создание вернёт 410

Точную цену считает /price

Карточка модели называет ставку, а не сумму: итог зависит от параметров — разрешения, длительности, длины текста, выбранного голоса — и от ваших скидок. Пошлите model, prompt и params — те же, что уйдут в задачу, — в расчёт цены и получите точную сумму до копейки, без запуска задачи и без списания.

Ноль в price не значит «бесплатно»

У моделей, которые тарифицируются по входу, цены за одну генерацию не существует: price приходит нулём, а price_unit в ответе отсутствует. Настоящая ставка лежит в price_input, а за что она берётся — в price_input_unit.

Так устроена озвучка tts2: price_input: 0.06 при price_input_unit: "per_character" — это 0.06 ₽ за символ промпта, то есть 26 символов стоят 1.56 ₽.

{
  "id": "tts2",
  "type": "MUSIC",
  "price": 0,
  "price_input": 0.06,
  "price_input_unit": "per_character",
  "prompt": "required"
}

Обратный случай тоже встречается: price: 0 вместе с price_unit — это честно бесплатная генерация, а не отсутствие цены. Различает их наличие единицы, а не значение: единица есть — ось есть, и ставка на ней нулевая; единицы нет — цену надо искать на входной оси.

Единицы у разных ставок не совпадают, поэтому сравнивать сами числа нельзя — только вместе с единицей. Ставка голоса в списке голосов объявлена за 1000 символов (price_per_1k_chars): если у выбранного голоса она есть, задача считается по ней, а не по price_input модели.

Единицы цены — список открытый

price_unit и price_input_unit называют ось тарификации, и набор осей растёт вместе с моделями: за секунду, за мегапиксель, за символ, за токен — каждая новая форма тарифа приносит новое значение. Перечисленные выше — всё, что API отдаёт сегодня.

Поэтому не отбрасывайте модель с незнакомой единицей и не считайте её ошибкой: цену для неё всегда назовёт расчёт цены — он принимает те же params, что уйдут в задачу.

Единицы у разных ставок разные, поэтому числа сравнимы только вместе с единицей: 0.06 при per_character и 0.06 при per_1k_tokens — величины разного порядка.

Поля депрекации приходят вместе

Три поля депрекации появляются только у моделей, снятие которых объявлено, и всегда втроём. У живой модели их в ответе нет вовсе.

Пример модели с запланированным снятием:

{
  "id": "kling-v2",
  "code": "kling-v2",
  "type": "VIDEO",
  "price": 210,
  "deprecated": false,
  "deprecated_at": "2026-09-01T00:00:00.000Z",
  "deprecation_redirect_to": "kling-v3"
}

Снятые модели

После даты из deprecated_at задачи выполняются на модели из deprecation_redirect_to, а о подмене сообщают заголовки ответа. Если аналога нет, создание вернёт 410 с code: 21 — см. справочник ошибок. Как это устроено во всех API — в разделе Устаревшие модели.

Не все параметры модели настраиваются

В params перечислено только то, что вы вправе задать сами. У модели могут быть и параметры с фиксированным значением: их выбирает не клиент, а сама модель.

Такие параметры в схеме не публикуются, но применяются к каждой генерации и возвращаются в ответе — в поле params у расчёта цены и у объекта задачи. Так что увидеть их фактическое значение можно, а изменить нельзя: присланное для них значение игнорируется, ошибки при этом не будет.