Справочник по API¶

Claudin.io — это API, совместимый с OpenAI. Если вы уже работали с OpenAI API, всё здесь будет знакомо — просто укажите базовый URL Claudin.io и используйте модель claudinio.

Базовый URL¶

https://api.claudin.io

Маршруты в стиле OpenAI находятся по пути /v1.

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

Отправляйте ваш API-ключ с каждым запросом в виде заголовка:

Authorization: Bearer YOUR_API_KEY

x-api-key: YOUR_API_KEY

Модель¶

Идентификатор модели	Контекстное окно
`claudinio`	256K токенов

Используйте claudinio везде. (Некоторые клиенты ожидают формат provider/model — для них используйте claudinio/claudinio.)

Эндпоинты¶

Метод и путь	Описание
`POST /v1/chat/completions`	Чат-дополнения — основной эндпоинт
`POST /v1/completions`	Устаревшие текстовые дополнения
`POST /v1/messages`	Формат сообщений Anthropic
`POST /v1/responses`	API ответов (Codex)
`POST /v1/embeddings`	Текстовые эмбеддинги
`GET /v1/models`	Список доступных моделей

Чат-дополнения¶

curl https://api.claudin.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claudinio",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Write a haiku about proxies."}
    ],
    "temperature": 0.7
  }'

Поддерживаются стандартные параметры OpenAI: messages, temperature, top_p, max_tokens, stream, stop, tools / tool_choice (вызов функций), response_format и так далее.

Потоковая передача¶

Установите "stream": true, чтобы получать события, отправляемые сервером, в формате потоковой передачи OpenAI (data: {...} блоки, завершающиеся data: [DONE]).

Вызов инструментов / функций¶

claudinio поддерживает вызов инструментов. Передавайте tools и считывайте tool_calls из ответа — точно так же, как в OpenAI API. Именно это обеспечивает его работу внутри агентских редакторов, таких как Claude Code, Kilo и Cursor.

Мультимодальный ввод¶

claudinio — текстовая модель, но Claudin.io прозрачно обрабатывает блоки изображений, аудио и видео: если вы их отправляете, прокси преобразует их в текстовые описания/расшифровки до того, как модель их увидит. Вам не нужно делать ничего особенного — отправляйте стандартные блоки контента OpenAI, и всё работает.

Ошибки¶

Ошибки соответствуют структуре ошибок OpenAI:

{ "error": { "message": "…", "type": "…", "code": "…" } }

Статус	Значение	Что делать
`401`	Неверный или отсутствующий API-ключ	Проверьте ключ и заголовок аутентификации
`403`	Эндпоинт не разрешён	Используйте один из поддерживаемых путей `/v1/*`
`429`	Достигнут лимит бюджета или превышено ограничение скорости	Дождитесь сброса окна или обновите тариф
`400`	Некорректный запрос	Проверьте ваш JSON / параметры
`5xx`	Сбой провайдера выше по цепочке	Повторите с задержкой

Данные провайдера скрыты намеренно

Сообщения об ошибках очищаются, чтобы не раскрывать нижележащего провайдера модели. Вы всегда будете видеть ошибки в стиле OpenAI под брендом Claudin.io.

Достижение лимита бюджета¶

Когда вы исчерпаете защиту расходов текущего окна, запросы начнут возвращать ошибку бюджета (обычно 429). На панели управления отображается точное время сброса и оставшийся бюджет. См. Тарифы и лимиты для описания работы окон.

Ограничение скорости¶

Claudin.io не блокирует обычное использование жёстко. Чрезмерно частые запросы замедляются (прозрачный троттлинг), а не отклоняются, поэтому корректные клиенты никогда не штрафуются. На практике вам ничего не нужно делать — просто повторите при редком 429.