От регистрации до первого ответа

Создайте аккаунт и ключ

1. Откройте страницу входа и зарегистрируйтесь. Во время регистрации подтвердите Telegram-аккаунт кодом.
2. Войдите в личный кабинет → API-ключи и нажмите «Создать ключ». Для платных моделей откройте настройки созданного ключа и включите платный доступ.
3. Назовите ключ по проекту: например, «Локальный CLI» или «VS Code». Скопируйте значение вида wio-live-….
4. Если устройство или проект больше не использует ключ, отзовите его в том же разделе. Актуальное число доступных ключей видно в кабинете.

Задайте ключ в терминале

Переменная WIO_API_KEY используется в примерах этой документации. Имя переменной в своих программах можно выбрать другое.

export WIO_API_KEY="wio-live-ВАШ_КЛЮЧ"
export WIO_BASE_URL="https://api.ai.wiky.su/v1"

$env:WIO_API_KEY = "wio-live-ВАШ_КЛЮЧ"
$env:WIO_BASE_URL = "https://api.ai.wiky.su/v1"

Такая настройка действует в текущем терминале. Для CI используйте секреты среды запуска, а для локальной разработки — своё защищённое хранилище переменных. Ключи для OpenAI-совместимых клиентов передаются через Authorization: Bearer.

Отправьте первый запрос

provider/example-model — вымышленный ID. Перед отправкой запроса скопируйте реальный маршрут из каталога моделей и замените значение поля model. Вымышленный ID сервер отклонит с кодом 400.

curl -sS 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":"Привет! Ответь одним предложением."}]}'

$headers = @{ Authorization = "Bearer $env:WIO_API_KEY" }
$body = @{
  model = "provider/example-model"
  messages = @(@{ role = "user"; content = "Привет!" })
} | ConvertTo-Json -Depth 4
Invoke-RestMethod -Uri "$env:WIO_BASE_URL/chat/completions" `
  -Method Post -Headers $headers -ContentType "application/json" -Body $body

Нужный текст находится в choices[0].message.content. Блок usage показывает входящие и исходящие токены ответа, если маршрут вернул их.

Проверьте подключение

Если первый запрос не прошёл, разделите проверку на два шага. Сначала убедитесь, что шлюз отвечает, затем проверьте ключ и список маршрутов.

curl -sS https://ai.wiky.su/health

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

• 200 на /health и 401 на /api/v1/models означают, что шлюз доступен, но ключ не принят.
• 429 означает исчерпанный бесплатный цикл; процент и время сброса видны в кабинете.
• 400 после запроса к модели часто указывает на неверный JSON, ID или параметр.

Подробная таблица кодов и шагов проверки — в руководстве по диагностике.