Один ключ.
Все маршруты.

Руководства по темам

Эта страница помогает быстро начать. Подробные объяснения, конфигурации и готовые файлы собраны в отдельных разделах.

Ключ и адрес API

Зарегистрируйтесь или войдите в личный кабинет, откройте «API-ключи» и нажмите «Создать ключ». Скопируйте значение wio-live-… и храните его вне исходного кода. Ключ можно отозвать в кабинете.

Маршруты, каталог и лимит

Поле model — полный ID маршрута. Одна модель может встречаться с разными префиксами; это отдельные пути к ней. Актуальные ID смотрите в каталоге кабинета или получите через GET /api/v1/models.

curl https://api.ai.wiky.su/v1/models \
  -H "Authorization: Bearer $WIO_API_KEY"

Chat Completions

Основной адрес для чатов и большинства OpenAI-совместимых приложений: POST /api/v1/chat/completions. Передайте model и массив messages. В примере ниже указан вымышленный ID модели: замените его на доступный маршрут из каталога.

export WIO_API_KEY="wio-live-ВАШ_КЛЮЧ"

curl https://api.ai.wiky.su/v1/chat/completions \
  -H "Authorization: Bearer $WIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"provider/example-model","messages":[{"role":"user","content":"Привет! Ответь одним предложением."}]}'

Ответ содержит choices[0].message.content и блок usage с учётом токенов. Поддерживаются привычные параметры temperature, top_p, max_tokens; вызовы инструментов зависят от конкретной модели и маршрута.

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

Передайте "stream":true, чтобы получать части ответа по мере генерации. Для cURL флаг -N отключает буферизацию вывода.

curl -N https://api.ai.wiky.su/v1/chat/completions \
  -H "Authorization: Bearer $WIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"provider/example-model","stream":true,"messages":[{"role":"user","content":"Напиши короткое приветствие"}]}'

Поток использует SSE-события data: … и завершается маркером [DONE]. Если нужен один JSON-объект, укажите "stream":false.

Responses API

Адрес POST /api/v1/responses принимает model, input и при необходимости instructions. Он нужен клиентам, использующим формат Responses, включая Codex CLI. Поддержка сложных инструментов зависит от маршрута.

curl https://api.ai.wiky.su/v1/responses \
  -H "Authorization: Bearer $WIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"provider/example-model","input":"Объясни, что делает HTTP 429"}'

Anthropic Messages

Для Anthropic-совместимых клиентов используйте POST /api/v1/messages. Здесь базовый адрес клиента обычно https://api.ai.wiky.su, без /v1: клиент добавляет путь сам.

curl https://api.ai.wiky.su/v1/messages \
  -H "x-api-key: $WIO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"provider/example-model","max_tokens":512,"messages":[{"role":"user","content":"Привет!"}]}'

Поток доступен через "stream":true. Для Claude Code подставьте совместимый маршрут из актуального каталога; поведение функций зависит от него.

Codex CLI

Codex использует Responses API. Укажите WioRoute как пользовательского провайдера в ~/.codex/config.toml и передайте ключ через переменную окружения. Этот же пользовательский конфиг использует расширение Codex для IDE.

export WIO_API_KEY="wio-live-ВАШ_КЛЮЧ"
codex

model = "provider/example-model"
model_provider = "wioroute"

[model_providers.wioroute]
name = "WioRoute"
base_url = "https://api.ai.wiky.su/v1"
env_key = "WIO_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false

Параметры провайдера сверены с официальной документацией Codex. Доступность возможностей агента определяется поддержкой Responses и инструментов у выбранного маршрута.

Claude Code

Claude Code ожидает Anthropic-совместимый API. Передайте адрес без суффикса /v1, ключ и полный ID маршрута Claude.

export ANTHROPIC_BASE_URL="https://api.ai.wiky.su"
export ANTHROPIC_AUTH_TOKEN="$WIO_API_KEY"
claude --model provider/example-model

Если ключ ещё не задан, сначала выполните export WIO_API_KEY="wio-live-ВАШ_КЛЮЧ". В Claude Code команда /status покажет активный базовый адрес и источник ключа. Расширение Claude Code для VS Code настраивает переменные через claudeCode.environmentVariables в пользовательских настройках редактора.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.ai.wiky.su" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "wio-live-ВАШ_КЛЮЧ" }
  ]
}

Переменные и настройка расширения описаны в официальном руководстве Claude Code. Держите пользовательские настройки с ключом вне публичного репозитория.

Continue для VS Code и JetBrains

В расширении Continue откройте локальный config.yaml, добавьте OpenAI-совместимую модель и замените ключ в примере. Затем выберите «WioRoute Example» в списке моделей чата.

name: WioRoute
version: 1.0.0
schema: v1
models:
  - name: WioRoute Example
    provider: openai
    model: provider/example-model
    apiBase: https://api.ai.wiky.su/v1
    apiKey: wio-live-ВАШ_КЛЮЧ
    roles:
      - chat
      - edit
      - apply

Этот пример включает чат и редактирование. Для Agent mode нужен маршрут с рабочим вызовом инструментов. Не добавляйте файл с настоящим ключом в git.

Формат apiBase и provider: openai сверены с документацией Continue.

Python и Node.js

Официальные OpenAI SDK принимают свой базовый URL. В примерах ниже ключ читается из переменной окружения и не хранится в файле скрипта.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["WIO_API_KEY"],
    base_url="https://api.ai.wiky.su/v1",
)

response = client.chat.completions.create(
    model="provider/example-model",
    messages=[{"role": "user", "content": "Объясни Python в двух предложениях"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.WIO_API_KEY,
  baseURL: "https://api.ai.wiky.su/v1",
});

const response = await client.chat.completions.create({
  model: "provider/example-model",
  messages: [{ role: "user", content: "Привет из Node.js" }],
});
console.log(response.choices[0].message.content);

Параметры SDK сверены с официальными пакетами openai-python и openai-node.

Ошибки и частые вопросы