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

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

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

Что нужно

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

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

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

Chat Completions

Полностью совместим с OpenAI API. Поддерживает stream и non-stream, tool calling, системные сообщения.

curl -X POST https://klox.blitznet.tech/v1/chat/completions \
  -H "Authorization: Bearer klox-ваш-ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kloxai/klox-0.33",
    "messages": [
      {"role": "system", "content": "Ты — аналитический агент."},
      {"role": "user", "content": "Проанализируй этот код"}
    ],
    "temperature": 0.7,
    "max_tokens": 2000,
    "stream": true
  }'

Параметры

Эндпоинты

Модели

Tool Calling

Klox поддерживает вызов инструментов через стандартный OpenAI-формат tools. Передайте описание инструментов в запросе, модель сама решит, когда их вызвать.

curl -X POST https://klox.blitznet.tech/v1/chat/completions \
  -H "Authorization: Bearer klox-ваш-ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kloxai/klox-0.33",
    "messages": [{"role": "user", "content": "Сколько файлов в /tmp?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "bash",
        "description": "Выполнить bash-команду",
        "parameters": {
          "type": "object",
          "properties": {
            "command": {"type": "string"}
          }
        }
      }
    }]
  }'

OpenCode

OpenCode — AI-терминал с поддержкой кастомных провайдеров. Рекомендованный инструмент для Klox.

Установка

# Linux / macOS
npm install -g @opencode-ai/cli

# macOS через brew
brew install opencode

Конфигурация

Создайте ~/.config/opencode/opencode.json:

{
  "provider": {
    "klox": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Klox AI",
      "options": {
        "baseURL": "https://klox.blitznet.tech",
        "apiKey": "ваш-ключ"
      },
      "models": {
        "kloxai/klox-0.33": {
          "name": "Klox",
          "contextLength": 256000,
          "supportsReasoning": true
        }
      }
    }
  }
}

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

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

VS Code

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

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

Cursor

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

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

JetBrains

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

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

Windsurf

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

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

Neovim

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

-- avante.nvim (lazy.nvim)
{
  "yetone/avante.nvim",
  opts: {
    provider: "openai",
    openai: {
      endpoint: "https://klox.blitznet.tech/v1",
      api_key: "ваш-ключ",
      model: "kloxai/klox-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://klox.blitznet.tech/v1, Model: kloxai/klox-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://klox.blitznet.tech/v1, Model: kloxai/klox-0.33.

SDK / Примеры

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

Python

import openai

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

response = client.chat.completions.create(
    model="kloxai/klox-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://klox.blitznet.tech/v1",
});

const stream = await client.chat.completions.create({
  model: "kloxai/klox-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/klox-0.33 — основная с аналитическим промптом. kloxapi/klox — базовая.

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

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

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

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

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

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

Telegram

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

Команды

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