Справочник API

Все запросы используют базовый URL https://tokenpass.cloud/v1.

Аутентификация

Передавайте API-ключ TokenPass как Bearer-токен:

Authorization: Bearer <TOKENPASS_API_KEY>

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

GET /v1/models возвращает идентификаторы моделей, доступные текущему API-ключу.

curl https://tokenpass.cloud/v1/models \
  -H "Authorization: Bearer $TOKENPASS_API_KEY"

Chat Completions

POST /v1/chat/completions принимает OpenAI-совместимый список сообщений.

{
  "model": "gpt-5-mini",
  "messages": [
    { "role": "system", "content": "Отвечай кратко." },
    { "role": "user", "content": "Объясни кэширование токенов." }
  ],
  "stream": false
}

Основные поля: model, messages, stream, tools, tool_choice, response_format, а также поддерживаемые моделью параметры выборки и рассуждения.

Responses

POST /v1/responses требуется для моделей, работающих только через Responses, включая gpt-5.4-pro.

curl https://tokenpass.cloud/v1/responses \
  -H "Authorization: Bearer $TOKENPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-pro",
    "input": "Найди возможные отказы в этой архитектуре."
  }'

Messages

POST /v1/messages принимает Anthropic-совместимый запрос.

curl https://tokenpass.cloud/v1/messages \
  -H "Authorization: Bearer $TOKENPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Потоковые ответы

Установите stream: true, если выбранные модель и интерфейс поддерживают потоковый режим. Клиент должен последовательно обрабатывать события Server-Sent Events до завершающего события соответствующего интерфейса.

Ошибки

HTTP	Значение	Действие
400	Ошибка JSON или параметров	Проверьте схему и параметры модели.
401	API-ключ отсутствует или недействителен	Проверьте Bearer-токен и состояние ключа.
402/403	Баланс, квота или доступ	Проверьте консоль и доступ к модели.
404	Неизвестная модель или метод	Обновите ID через GET /v1/models.
429	Ограничение частоты	Используйте экспоненциальную задержку и jitter.
502/503	Временная недоступность upstream	Ограниченно повторите безопасный запрос.

Слишком большой ввод также может превысить эффективный контекст выбранной модели и интерфейса.