Документация Klox AI

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

Klox работает в двух режимах — Telegram-юзербот и OpenAI-совместимый API. Вы можете использовать его через Telegram, любую IDE с поддержкой AI, или напрямую через curl/code.

Что нужно

1. API-ключ — получить в дашборде
2. Баланс — первые 25 запросов каждый день бесплатно
3. Модель — kloxai/zhida-0.33 (флагманская) или kloxai/zhida-0.33 (базовая)

Проверка через curl

curl -X POST https://api.klox.blitznet.tech/v1/chat/completions \
  -H "Authorization: Bearer klox-ваш-ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kloxai/zhida-0.33",
    "messages": [{"role": "user", "content": "Напиши hello world на Python"}]
}

Запустите opencode, переключитесь на kloxai/zhida-0.33. Для режима агента: /build.

Подробнее: /instructions

OpenCode

OpenCode — AI-агент в терминале. Работает с любым OpenAI-совместимым API.

Установка

npm install -g @kloxai/opencode-provider

Настройка IDE

OpenCode

kloxai setup opencode

Cursor

kloxai setup cursor

VS Code (Continue.dev)

kloxai setup vscode

Windsurf

kloxai setup windsurf

Neovim

kloxai setup neovim

JetBrains

kloxai setup jetbrains

API-ключ

kloxai key klox-ваш-ключ

VS Code

Установите расширение Continue из маркетплейса, затем настройте ~/.continue/config.json:

{
  "models": [{
    "title": "Klox",
    "provider": "openai",
    "apiBase": "https://api.klox.blitznet.tech/v1",
    "apiKey": "ваш-ключ",
    "model": "kloxai/zhida-0.33"
  }]
}

Cursor

Settings → Features → OpenAI-compatible → добавить:

Name: Klox
Endpoint: https://api.klox.blitznet.tech/v1
API Key: ваш-ключ
Model: kloxai/zhida-0.33

JetBrains

Установите плагин Continue через маркетплейс плагинов JetBrains. Конфиг тот же: ~/.continue/config.json.

После установки выберите Klox в списке моделей Continue.

Windsurf

Настройки провайдера в ~/.windsurf/config.json:

{
  "providers": [{
    "name": "klox",
    "type": "openai",
    "baseUrl": "https://api.klox.blitznet.tech/v1",
    "apiKey": "ваш-ключ",
    "models": [{"name": "kloxai/zhida-0.33"}]
  }]
}

Neovim

Через плагины avante.nvim или llm.nvim.

-- avante.nvim (lazy.nvim)
{
  "yetone/avante.nvim",
  opts: {
    provider: "openai",
    openai: {
      endpoint: "https://api.klox.blitznet.tech/v1",
      api_key: "ваш-ключ",
      model: "kloxai/zhida-0.33",
    }
  }
}

Linux

Установка OpenCode

npm install -g @opencode-ai/cli
mkdir -p ~/.config/opencode

Конфиг: ~/.config/opencode/opencode.json (см. раздел OpenCode).

VS Code / Continue

Установите расширение Continue из маркетплейса, конфиг: ~/.continue/config.json.

Neovim

Через avante.nvim — см. раздел Neovim.

macOS

Установка OpenCode

# Через brew
brew install opencode

# Или через npm
npm install -g @opencode-ai/cli

Конфиг: ~/.config/opencode/opencode.json.

VS Code / Continue

Cmd+Shift+X → Continue. Конфиг: ~/.continue/config.json.

Cursor

Cursor → Settings → Features → OpenAI-compatible. Endpoint: https://api.klox.blitznet.tech/v1, Model: kloxai/zhida-0.33.

Windows

Установка OpenCode

# Установите Node.js с nodejs.org, затем:
npm install -g @opencode-ai/cli

Конфиг: %USERPROFILE%\.config\opencode\opencode.json.

VS Code / Continue

Ctrl+Shift+X → Continue. Конфиг: %USERPROFILE%\.continue\config.json.

Cursor

File → Settings → Features → OpenAI-compatible. Endpoint: https://api.klox.blitznet.tech/v1, Model: kloxai/zhida-0.33.

SDK / Примеры

Благодаря полной совместимости с OpenAI API, можно использовать любой SDK.

Python

import openai

client = openai.OpenAI(
    api_key="klox-ваш-ключ",
    base_url="https://api.klox.blitznet.tech/v1"
)

response = client.chat.completions.create(
    model="kloxai/zhida-0.33",
    messages=[{"role": "user", "content": "Напиши парсер CSV"}],
    stream=True
)
for chunk in response:
    print(chunk.choices[0].delta.content, end="")

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "klox-ваш-ключ",
  baseURL: "https://api.klox.blitznet.tech/v1",
});

const stream = await client.chat.completions.create({
  model: "kloxai/zhida-0.33",
  messages: [{ role: "user", content: "Напиши парсер CSV" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

FAQ

Как получить API-ключ?

Зайдите в дашборд, войдите через Telegram и скопируйте ключ.

Сколько стоит?

Первые 25 запросов каждый день — бесплатно. Тариф Pro — 990 ₽/мес (50 000 запросов/день). Enterprise — индивидуально.

Какие модели доступны?

kloxai/zhida-0.33 — основная с аналитическим промптом. kloxapi/klox — базовая.

Поддерживает streaming?

Да, SSE streaming через параметр "stream": true.

Как работает tool calling?

Через стандартный OpenAI-формат tools. Модель возвращает tool_calls в ответе.

Есть поддержка русского?

Да, Klox Zhida полностью поддерживает русский язык.

Telegram

Klox работает как Telegram-юзербот. Напишите ему в личные сообщения или добавьте в группу.

Команды

Команда	Описание
/start	Начать диалог
/help	Справка
/balance	Баланс ключей
/model	Текущая модель
/reset	Сбросить историю

Инструменты (XML-теги)