Расчёт цены

POST https://gptunnel.ru/api/v2/media/price

Возвращает стоимость генерации по телу { model, prompt, params, inputs } без запуска задачи и без списания средств. Считается тем же способом, что и фактическое списание при создании задачи.

У моделей озвучки цена зависит от голоса и длины текста, поэтому в запрос нужно положить prompt и params.voice — те же значения, что уйдут в задачу. Голос проверяется так же, как при создании: неизвестный или недоступный вернёт 400.

У моделей, где в цену входят токены промпта (gpt-image), prompt не обязателен, но на сумму влияет: без него котировка посчитает только цену генерации. Присылайте тот же текст, что уйдёт в задачу.

Request Body

Параметр	Тип	Описание
`model`*	`string`	Идентификатор модели
`prompt`	`string`	Текст будущей генерации. У озвучки обязателен, потому что цена зависит от его длины — без него такой запрос вернёт 400. У моделей со счётом по токенам промпта (gpt-image) не обязателен, но входит в цену: без него сумма выйдет ниже фактического списания. На остальные модели не влияет
`params`	`object`	Параметры генерации (влияют на цену: длительность, разрешение и т.п.)
`inputs`	`object`	Входные файлы по ролям — в том же виде, что и при создании задачи. Нужны только для подсчёта: у моделей с надбавкой за референсы цена зависит от числа вложений. Файлы отсюда не скачиваются и на доступность не проверяются — достаточно перенести `inputs` из будущего запроса на генерацию

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

curl --request POST \
  --url 'https://gptunnel.ru/api/v2/media/price' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-v3",
    "params": { "resolution": "1080p", "duration": 5, "aspect_ratio": "16:9" }
  }'

import axios from 'axios'

const { data } = await axios.post(
  'https://gptunnel.ru/api/v2/media/price',
  {
    model: 'kling-v3',
    params: { resolution: '1080p', duration: 5, aspect_ratio: '16:9' },
  },
  { headers: { Authorization: 'YOUR_API_KEY' } },
)

console.log(data)

import requests

response = requests.post(
    'https://gptunnel.ru/api/v2/media/price',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={
        'model': 'kling-v3',
        'params': {'resolution': '1080p', 'duration': 5, 'aspect_ratio': '16:9'},
    },
)

print(response.json())

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

{
  "code": 0,
  "model": "kling-v3",
  "price": 210,
  "currency": "RUB",
  "params": { "resolution": "1080p", "duration": 5, "aspect_ratio": "16:9" }
}

Внутри params неизвестный модели ключ и ключ, значение которого задаёт сама модель, не отклоняются: запрос выполняется, а такие ключи перечисляются в ignored_params ответа с причиной.

Ошибкой внутри params остаётся только недопустимое значение параметра, который модель принимает: duration: 999 при пределе 10 — это 400, а не молчаливая подстановка.

Строгими остаются поля верхнего уровня (model, prompt, webhook_url, idempotency_key, wait) и роли в inputs. Неизвестное поле верхнего уровня возвращает 400 с code: 3, его имя перечислено в details. Если переносите код с v1 или шлёте поля «про запас» — сверьтесь со схемой запроса.

Перечислены поля создания задачи. webhook_url, idempotency_key и wait относятся к запуску, которого здесь нет, и вернут 400. Из тела /tasks в /price переносятся model, prompt, params и inputs.

На query-строку GET /media/models строгость НЕ распространяется: лишние параметры там (кэш-бастеры вроде _=<timestamp>, пагинация, utm-метки) добавляют инструменты клиента, а не разработчик, и они по-прежнему игнорируются.

Проверить своё тело запроса можно на расчёте цены: ignored_params возвращается и там, то есть до списания.