Обзор API
Базовый URL, заголовки, аутентификация и общие соглашения Hubris API.
Hubris API совместим с OpenAI Chat Completions API. Все запросы — поверх HTTPS, авторизация через Bearer-токен, ответы — JSON с UTF-8.
Базовый URL
https://api.hubris.pw/v1Все эндпоинты идут от этого префикса. Например, https://api.hubris.pw/v1/chat/completions или https://api.hubris.pw/v1/models.
Заголовки
Обязательные:
Authorization: Bearer sk-gw-<32-hex>— ваш API-ключ. См. Аутентификацию.Content-Type: application/json— для всехPOST-запросов.
Опциональные:
Accept: application/json— явно ожидать JSON-ответ. По умолчанию мы и так отдаём JSON.Accept: text/event-stream— приstream: trueсервер автоматически переключается в SSE-режим.
Эндпоинты
| Метод | Путь | Описание |
|---|---|---|
| GET | /v1/models | Список доступных моделей с ценами в ₽ |
| POST | /v1/chat/completions | Создать ответ модели (с потоковой передачей или без) |
| POST | /v1/responses | Создать ответ через Responses API (бета) |
Версионирование
Префикс /v1 — стабильный. Все несовместимые изменения эндпоинтов будут идти под /v2/... (или новее), не ломая существующие интеграции.
Метка бета у /v1/responses относится только к составу внутренних блоков ответа (output[]) — туда со временем добавляются новые типы (рассуждения, вызовы инструментов и т.д.) по мере того, как их вводят провайдеры моделей. Авторизация, тарификация и потоковая передача — стабильны и подходят для продакшена. Если ваш клиент строго разбирает конкретные типы блоков, будьте готовы расширять обработку по мере их появления.
Идемпотентность
POST /v1/chat/completions и POST /v1/responses не идемпотентны — каждый запрос порождает новый ответ модели, независимо от тела. Если у вас на стороне клиента включены повторы при сбоях, помните: каждая повторная попытка спишет деньги, если первая прошла успешно (что иногда бывает при кратковременных сбоях сети).
GET /v1/models идемпотентен — ответ кешируется на стороне Hubris ~60 секунд.
Потоковая передача
При stream: true ответ приходит через Server-Sent Events. Подробности формата — на отдельной странице Потоковая передача.
Ошибки
Все ошибки в OpenAI-формате { error: { message, type, code } }. Полный список кодов — на странице Ошибки.
Что дальше
- POST /v1/chat/completions — основной эндпоинт.
- GET /v1/models — каталог.
- Потоковая передача — формат SSE.
- POST /v1/responses — бета-эндпоинт для Responses API (рассуждающие модели, Codex CLI и т.п.).
Обновлено: