Карточка модели

GEThttps://api.souz.ai/v1/models/{id}

Что модель принимает (input_schema, params, rules), сколько стоит «от» (pricing), пределы и возможности. Стройте запрос по карточке, а не по памяти. Кеширование — как у GET /v1/models. С авторизацией возвращает цены текущего аккаунта; такой ответ — Cache-Control: private, no-cache.

Авторизация

BearerAuth

API-ключ из кабинета souz.ai — запускает модели. Ключ управления здесь не подходит: 403 forbidden с detail[].reason: requires_api_key.

ManagementKey

Ключ управления из кабинета souz.ai (выдают владелец и администратор аккаунта — себе или участнику). Даёт ровно то, что его держатель видит и может в кабинете: баланс, историю операций и запросов, расходы, обычные ключи, настройки аккаунта — с той же ролью, лимитами и цифрами. Модели не запускает. Обычный API-ключ здесь не подходит: 403 forbidden с detail[].reason: requires_management_key.

ClientSession

Сессия кабинета souz.ai в браузере — те же ручки, что у ключа управления.

Параметры пути

idstringобязательно

Id модели из каталога.

Пример: "nano-banana-pro"

Ответы

200Карточка.

application/json

Схема Model

added_atstring · dateобязательно

capabilitiesCapabilities

createdinteger · int64обязательно

Unix-время появления модели в каталоге (added_at) — поле models.list SDK OpenAI.

Пример: 1758758400

descriptionstringобязательно

display_namestringобязательно

idstringобязательно

То, что идёт в поле model запроса.

Пример: "nano-banana-pro"

input_schemaobjectобязательно

JSON Schema 2020-12 тела запроса к этой модели, включая условные пределы текста музыки: какие поля и значения она принимает. Годится как parameters инструмента и inputSchema MCP. Значения, которые у модели ничего не меняют, в ней тоже есть — они принимаются.

limitsLimitsобязательно

modalityModalityобязательно

objectstringобязательно

Значение: "model"

owned_bystringобязательно

Автор модели — vendor.id (пусто, если автор не указан); поле models.list SDK OpenAI.

Пример: "google"

paramsarray[ParamSpec]обязательно

Те же поля для витрины — с подписями и подсказками.

pricingPricingобязательно

released_atstring | null · dateобязательно

rulesarray[ParamRule]обязательно

Какие сочетания значений допустимы — то, что не выражает params.

stats_7dModelStatsSummaryобязательно

statusstringобязательно

Значения: active

tagsarray[string]обязательно

updated_atstring · date-timeобязательно

vendorVendor | nullобязательно

Автор модели; null, если не указан.

304Не изменилось с прошлого раза: `If-None-Match` совпал с `ETag`.

401Нет ключа или ключ недействителен.

application/json

Error

403Нельзя: у ключа не тот вид (модели запускает API-ключ, аккаунт — ключ управления), у роли

Нельзя: у ключа не тот вид (модели запускает API-ключ, аккаунт — ключ управления), у роли участника нет права или подпись ссылки на файл не сходится. detail[].reason говорит, что именно: requires_api_key, requires_management_key, cabinet_only (только в кабинете), insufficient_role (в allowed — роли, которым можно), not_key_author (секрет ключа открывает только тот, кто его создал).

application/json

Error

404Нет такого объекта у этого аккаунта.

application/json

Error

429Слишком часто — повторите через `Retry-After` секунд. Запуск моделей, задачи и файлы результатов частотой не ограничены (их ограничивают баланс и лимиты трат); здесь 429 — на поток запросов с ключом, который сервер не знает, с одного адреса, и на потоки сверх 1000 одновременных на аккаунт (события задачи, чат с `stream: true`). Пределы — раздел «Лимиты» руководства.

application/json

Error

Бесплатно, со своим ключом

Запрос

curl -X GET 'https://api.souz.ai/v1/models/{id}' \
  -H "Authorization: Bearer $SOUZ_API_KEY"

import os
import requests

response = requests.get(
    "https://api.souz.ai/v1/models/{id}",
    headers={"Authorization": f"Bearer {os.environ['SOUZ_API_KEY']}"},
)
print(response.json())

const response = await fetch("https://api.souz.ai/v1/models/{id}", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.SOUZ_API_KEY}` },
});
console.log(await response.json());

Ответ

{
  "error": {
    "code": "forbidden",
    "detail": [
      {
        "reason": "requires_api_key"
      }
    ],
    "message": "this endpoint takes an API key; a management key manages the account only",
    "type": "permission_error"
  }
}