Быстрый старт

Роутер Waibee принимает запросы в трёх форматах: OpenAI (POST /v1/chat/completions), Anthropic Messages (POST /v1/messages, его использует Claude Code) и Responses (POST /v1/responses, его использует Codex CLI). Для первого запроса нужен API-ключ (sk_live_...) и адрес https://api.waibee.com.

1. Установить ключ

export WAIBEE_API_KEY="sk_live_..."

2. Первый запрос (OpenAI-формат)

curl

chat-completion.sh

curl https://api.waibee.com/v1/chat/completions \
  -H "Authorization: Bearer $WAIBEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "messages": [{ "role": "user", "content": "Ответь одним словом: столица Франции?" }]
  }'

Python

client.py

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.waibee.com/v1",
    api_key=os.environ["WAIBEE_API_KEY"],
)

response = client.chat.completions.create(
    model="anthropic/claude-sonnet-4.6",
    messages=[{"role": "user", "content": "Ответь одним словом: столица Франции?"}],
)
print(response.choices[0].message.content)

Клиент ставится как pip install openai: роутер принимает официальный SDK без изменений.

Node

client.mjs

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.waibee.com/v1',
  apiKey: process.env.WAIBEE_API_KEY,
});

const response = await client.chat.completions.create({
  model: 'anthropic/claude-sonnet-4.6',
  messages: [{ role: 'user', content: 'Ответь одним словом: столица Франции?' }],
});

console.log(response.choices[0].message.content);

Клиент ставится как npm install openai.

Ответ:

response.json

{
  "id": "gen-...",
  "object": "chat.completion",
  "created": 1784025392,
  "model": "anthropic/claude-sonnet-4.6",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": { "role": "assistant", "content": "Париж" }
    }
  ],
  "usage": { "prompt_tokens": 22, "completion_tokens": 6, "total_tokens": 28 }
}

3. Anthropic-формат

Тот же запрос на POST /v1/messages: этот формат используют SDK Anthropic и Claude Code.

messages.sh

curl https://api.waibee.com/v1/messages \
  -H "x-api-key: $WAIBEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [{ "role": "user", "content": "Ответь одним словом: столица Франции?" }]
  }'

Поле max_tokens здесь обязательно, а ответ приходит в форме Anthropic: content, stop_reason, usage.

Формат идентификатора модели

model указывается строго как <провайдер>/<модель> и только из каталога /v1/models.

• anthropic/claude-sonnet-4.6
• openai/gpt-5.2
• waibee/auto (Autorouting: модель под запрос выбирает роутер)

Bare-имя без провайдера (claude-sonnet-4.6) на /v1/chat/completions отклоняется с 422 и кодом validation_error. На /v1/messages короткие имена моделей Claude принимаются: клиенты на Anthropic SDK присылают их по умолчанию. Полный список моделей:

curl https://api.waibee.com/v1/models \
  -H "Authorization: Bearer $WAIBEE_API_KEY"

Подключение вместо другого провайдера

В клиентах, совместимых с OpenAI или Anthropic API, для работы через Waibee меняются только базовый URL и ключ:

client = OpenAI(
    base_url="https://api.openai.com/v1",
    api_key=os.environ["OPENAI_API_KEY"],
    base_url="https://api.waibee.com/v1",
    api_key=os.environ["WAIBEE_API_KEY"],
)

Готовые инструкции под конкретные инструменты собраны в разделе Интеграции:

• Claude Code: через Anthropic Messages API.
• OpenCode: как OpenAI-совместимый провайдер.
• OpenAI-совместимые клиенты: SDK, Cline, Continue и другие.