Обзор API
Базовые адреса шлюза, список эндпоинтов и какой формат запроса подходит модели.
Base URL
OpenAI-совместимые инструменты и SDK (base URL уже содержит /v1):
https://ai-seller.vibe-codes.ru/v1Anthropic SDK и Claude Code (SDK сам добавит /v1/messages):
https://ai-seller.vibe-codes.ruЭндпоинты
| Эндпоинт | Описание |
|---|---|
POST /v1/chat/completions | Chat Completions — базовый OpenAI-формат, поддерживает стриминг |
POST /v1/responses | Responses — формат Codex, поддерживает стриминг |
POST /v1/messages | Messages — формат Anthropic и Claude Code, поддерживает стриминг |
POST /v1/images/generations | Генерация изображений, тарификация за изображение |
POST /v1/videos | Создание видео-задачи: 202 + id для поллинга; тарификация за секунду по завершении |
GET /v1/videos/{id} | Статус видео-задачи |
GET /v1/videos/{id}/content | Скачивание готового видео — после того как GET /v1/videos/{id} вернул статус completed |
GET /v1/models | Каталог моделей (ключ необязателен; с ключом — включая модели, открытые вашему аккаунту) |
GET /v1/balance | Текущий баланс (по API-ключу) |
Других эндпоинтов нет: например, /v1/embeddings и /v1/messages/count_tokens
отвечают 404 not_found.
Все запросы авторизуются ключом — см. Ключи и авторизация.
В каждом ответе есть заголовок x-request-id — тот же идентификатор, что
request_id в теле ошибки; указывайте его при обращении в поддержку.
Формат запроса и модель
Шлюз не переводит запросы из одного формата в другой: запрос к
/v1/chat/completions, /v1/messages или /v1/responses уходит провайдеру
модели в том же формате. Поэтому модель отвечает на эндпоинте, только если его
формат поддерживает её провайдер. Если модель возвращает ошибку на одном
текстовом эндпоинте, попробуйте другой — чаще всего провайдеры поддерживают
/v1/chat/completions.
Тип модели должен совпадать с эндпоинтом: модель изображений на чате (и
наоборот) отвечает 404 model_not_found, как несуществующая.
Что шлюз меняет в запросе
Модели уходят только поддерживаемые параметры, а идентификаторы клиента
заменяются на идентификаторы шлюза — подробно на странице
Параметры запроса. Заголовки вашего запроса (например,
OpenAI-Beta или anthropic-beta) провайдеру не передаются. Историю разговора
передавайте целиком в каждом запросе: состояние на стороне провайдера шлюз не
хранит.
Обновлено 29 сентября 2026 г.