Список моделей

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

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

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

Query-параметры

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

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

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

import axios from 'axios'

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

console.log(data)

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,
      "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`	Базовая цена в рублях; итоговая зависит от параметров (см. /media/price)
`prompt`*	`string`	Требование к промпту: required, optional или none
`params`*	`array`	Схема параметров генерации: ключ, тип, допустимые значения, значение по умолчанию
`inputs`	`array`	Схема входных файлов: роль, форматы, число файлов, ограничения