🚀 K2Think API Builder

Мощный JavaScript конструктор для создания кастомных JSON API на основе K2Think.ai

Создавайте структурированные API с валидацией JSON схем, готовыми шаблонами и полной кастомизацией для ваших проектов.

🎉 v1.2.0 - Универсальный диалог и JSON Builder!

🆕 Новые классы для полной гибкости:

🎯 UniversalDialog - Мульти-провайдерный диалог (K2Think, OpenAI, Anthropic, кастомные API)
🛠️ K2ThinkJsonBuilder - Полный контроль над JSON структурами запросов
📋 Универсальный формат - Стандартизированная структура сообщений
🎛️ Гибкая конфигурация - JSON config или переменные окружения

✨ Возможности v1.2.0:

🏗️ Построение кастомных JSON - Создавайте любые структуры запросов
🔄 Сохранение/загрузка JSON запросов в файлы
📊 История диалогов в универсальном формате
🌐 Поддержка разных AI провайдеров через единый интерфейс

🎉 v1.1.0 - Критические исправления!

✅ Исправлены проблемы с cookies:

❌ Invalid character in header content ["Cookie"] → ✅ Исправлено
❌ Библиотека падала без cookies.txt → ✅ Graceful fallback
❌ Специальные символы в cookies → ✅ URL encoding

🔧 Новые возможности:

🛡️ Graceful fallback - работает без AI функций
🔧 Опциональные cookies - { skipCookies: true }
✅ Валидация cookies - автоматическая проверка
📊 isAIEnabled() - проверка доступности AI

🚀 ВАЖНО: Настройка перед использованием

Перед началом работы необходимо настроить аутентификацию в K2Think.ai:

📋 Краткая инструкция (5 минут):

Регистрация: Зайдите на https://www.k2think.ai/ и авторизуйтесь
Расширение: Установите EditThisCookie (V3)
Cookies: На сайте k2think.ai нажмите на иконку расширения → Export → сохраните как Cookie.json
Конвертация: Запустите npm run cookies для конвертации cookies
Настройка: Выполните source set-cookies.sh для настройки окружения

🔗 Подробная инструкция: SETUP.md

⚠️ Важно: Без правильной настройки cookies библиотека не будет работать!

✨ Возможности

🎯 Универсальный диалог (v1.2.0)

🌐 Мульти-провайдер - K2Think.ai, OpenAI, Anthropic, кастомные API
📋 Универсальный формат - Стандартизированная структура сообщений
🎛️ Гибкая конфигурация - JSON config или переменные окружения
📊 История диалогов - Автоматическое сохранение контекста

🛠️ JSON Builder (v1.2.0)

🏗️ Полный контроль над JSON структурами запросов
🔄 Сохранение/загрузка JSON запросов в файлы
📝 Построение диалогов из истории сообщений
⚙️ Все параметры K2Think API под контролем

🔧 Основные возможности

🎯 Готовые шаблоны - 6 предустановленных JSON API для常见 задач
🔧 Кастомные API - Создавайте любые API с JSON схемами
✅ Валидация схем - Автоматическая проверка структуры ответов
📊 Структурированные ответы - Всегда валидный JSON с предсказуемой структурой
🚀 Фабричный метод - Быстрое создание и инициализация
📦 Экспорт API - Сохраняйте созданные методы в файлы
🧪 Покрытие тестами - Надежность и стабильность
📚 Подробная документация - Легко начать использовать

📦 Установка

npm install k2think-api-builder

⚠️ После установки: Обязательно выполните настройку аутентификации перед использованием!

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

✅ Graceful fallback (v1.1.0)

Библиотека теперь работает даже без cookies!

const { CustomAPIBuilder } = require('k2think-api-builder');

async function gracefulStart() {
    const builder = new CustomAPIBuilder();
    await builder.init(); // Всегда успешно!

    if (builder.isAIEnabled()) {
        console.log('✅ AI функции доступны');
        const analyzer = builder.createFromTemplate('textAnalyzer');
        const result = await analyzer.execute('Текст для анализа');
        console.log(result);
    } else {
        console.log('⚠️ AI функции недоступны');
        console.log('Настройте cookies для включения AI функций');
    }
}

🔧 Опциональные cookies (v1.1.0)

Явное отключение AI функций:

// Работаем без AI функций
const builder = new CustomAPIBuilder({ skipCookies: true });
await builder.init();
console.log('Библиотека готова к работе без AI');

Базовое использование

const { CustomAPIBuilder } = require('k2think-api-builder');

async function quickStart() {
    const builder = new CustomAPIBuilder();
    await builder.init();

    // Используем готовый шаблон
    const analyzer = builder.createFromTemplate('textAnalyzer');
    const result = await analyzer.execute('Этот продукт просто замечательный!');
    
    console.log(result);
    // Вывод:
    // {
    //   "sentiment": "позитивный",
    //   "themes": ["качество", "рекомендация"],
    //   "keywords": ["продукт", "замечательный"],
    //   "confidence": 0.95
    // }
}

Фабричный метод

const { create } = require('k2think-api-builder');

async function factoryExample() {
    const builder = await create(); // Автоматическая инициализация
    const api = builder.createFromTemplate('sentimentAnalyzer');
    const result = await api.execute('Отличный день!');
    
    console.log(result.sentiment); // "позитивный"
}

🎯 UniversalDialog (v1.2.0) - Универсальный диалог

Мульти-провайдерный диалог с поддержкой разных AI API через единый интерфейс:

const { UniversalDialog } = require('k2think-api-builder');

// Базовое использование с K2Think
const dialog = new UniversalDialog({
    provider: 'k2think',
    model: 'MBZUAI-IFM/K2-Think',
    systemPrompt: 'Ты - эксперт по программированию'
});

// Отправить сообщение
const response = await dialog.sendMessage('Что такое async/await?');
console.log(response.content);

// Работа с историей
const history = dialog.getHistory();
dialog.saveHistory('my-dialog.json');

🌐 Разные провайдеры

// OpenAI
const openaiDialog = new UniversalDialog({
    provider: 'openai',
    apiKey: 'sk-...',
    model: 'gpt-4'
});

// Anthropic  
const anthropicDialog = new UniversalDialog({
    provider: 'anthropic',
    apiKey: 'sk-ant-...',
    model: 'claude-3-sonnet-20240229'
});

// Кастомный API
const customDialog = new UniversalDialog({
    provider: 'custom',
    baseUrl: 'https://your-api.com',
    endpoint: '/v1/chat/completions',
    apiKey: 'your-key'
});

🛠️ K2ThinkJsonBuilder (v1.2.0) - Полный контроль над JSON

Создавайте любые JSON структуры для K2Think.ai API:

const { K2ThinkJsonBuilder } = require('k2think-api-builder');

const builder = new K2ThinkJsonBuilder(cookies);

// Создаем JSON запрос как вам нужно
let request = builder.createBaseRequest('MBZUAI-IFM/K2-Think');

// Добавляем сообщения в универсальном формате
request = builder.addSystemMessage(request, 'Ты - эксперт по JavaScript');
request = builder.addUserMessage(request, 'Объясни замыкания');
request = builder.addAssistantMessage(request, 'Замыкание - это функция...');
request = builder.addUserMessage(request, 'Приведи пример кода');

// Настраиваем параметры
request = builder.setModelParams(request, {
    temperature: 0.7,
    max_output_tokens: 2048,
    top_p: 0.9
});

// Сохраняем JSON для переиспользования
builder.saveRequest(request, 'my-custom-request.json');

// Отправляем запрос
const response = await builder.sendRequest(request);
console.log(response.response);

📋 Универсальный формат JSON

{
  "model": "MBZUAI-IFM/K2-Think",
  "input": [
    {
      "role": "system",
      "content": [
        {
          "type": "input_text",
          "text": "Системный промпт"
        }
      ]
    },
    {
      "role": "user", 
      "content": [
        {
          "type": "input_text",
          "text": "Сообщение пользователя"
        }
      ]
    },
    {
      "role": "assistant",
      "content": [
        {
          "type": "output_text", 
          "text": "Ответ ассистента"
        }
      ]
    }
  ],
  "text": {
    "format": {
      "type": "text"
    }
  },
  "reasoning": {},
  "tools": [],
  "temperature": 1,
  "max_output_tokens": 2048,
  "top_p": 1,
  "store": true,
  "include": ["web_search_call.action.sources"]
}

🎨 Создание кастомных API

const { create } = require('k2think-api-builder');

async function customAPI() {
    const builder = await create();

    // Создаем свой API для анализа продуктов
    const productAnalyzer = builder.createJSONMethod('productAnalyzer', {
        description: 'Анализ продуктов из отзывов',
        systemPrompt: 'Проанализируй отзыв о продукте и верни детальную информацию.',
        
        jsonSchema: {
            type: "object",
            required: ["product_name", "rating", "sentiment"],
            properties: {
                product_name: { type: "string" },
                rating: { type: "number", minimum: 1, maximum: 5 },
                sentiment: { 
                    type: "string", 
                    enum: ["позитивный", "негативный", "нейтральный"] 
                },
                pros: { type: "array", items: { type: "string" } },
                cons: { type: "array", items: { type: "string" } }
            }
        }
    });

    const result = await productAnalyzer.execute(
        'iPhone 15 Pro Max - отличный телефон, камера супер!'
    );
    
    console.log(result);
}

📊 Доступные шаблоны

Шаблон	Описание	Пример использования
`textAnalyzer`	Анализ текста с тональностью	Анализ отзывов, комментариев
`contentGenerator`	Генерация контента	Создание статей, постов
`classifier`	Классификация текста	Категоризация документов
`translator`	Перевод текста	Многоязычная поддержка
`sentimentAnalyzer`	Детальный анализ тональности	Анализ эмоций
`productDescriber`	Генерация описаний продуктов	E-commerce, маркетинг

🔧 API Reference

CustomAPIBuilder

Методы

init() - Инициализация билдера
createFromTemplate(templateName) - Создание API из шаблона
createJSONMethod(name, config) - Создание кастомного JSON API
parseJSONResponse(response) - Извлечение JSON из ответа
validateJSON(data, schema) - Валидация JSON по схеме
exportAPI(methods, filename) - Экспорт API в файл

Конфигурация JSON метода

const config = {
    description: 'Описание API метода',
    systemPrompt: 'Системный промпт для модели',
    jsonSchema: {
        type: 'object',
        required: ['поле1', 'поле2'],
        properties: {
            поле1: { type: 'string' },
            поле2: { type: 'number' }
        }
    },
    validateInput: (input) => {
        // Кастомная валидация входных данных
        return true;
    },
    postProcess: (result) => {
        // Пост-обработка результата
        return result;
    }
};

📁 Структура проекта

k2think-api-builder/
├── src/
│   ├── index.js              # Главный файл библиотеки
│   ├── api-builder.js        # Основной класс CustomAPIBuilder
│   ├── k2think-dialog.js     # Диалог с K2Think
│   └── cookie-converter.js   # Конвертер cookies
├── examples/                 # Примеры использования
│   ├── basic-usage.js
│   ├── custom-api.js
│   ├── batch-processing.js
│   └── factory-method.js
├── tests/                    # Тесты
│   ├── api-builder.test.js
│   └── k2think-dialog.test.js
├── docs/                     # Документация
│   └── create-custom-api.md
├── package.json
├── README.md
├── LICENSE
└── CHANGELOG.md

🧪 Запуск тестов

# Установка зависимостей
npm install

# Запуск всех тестов
npm test

# Запуск в режиме watch
npm run test:watch

# Проверка кода
npm run lint

# Исправление кода
npm run lint:fix

📚 Примеры

Запуск демо

# Базовый пример
npm run demo

# Примеры из папки examples
node examples/basic-usage.js
node examples/custom-api.js
node examples/batch-processing.js
node examples/factory-method.js

Пакетная обработка

const { create } = require('k2think-api-builder');

async function batchProcess() {
    const builder = await create();
    const analyzer = builder.createFromTemplate('sentimentAnalyzer');
    
    const texts = [
        'Отличный продукт!',
        'Ужасное качество...',
        'Нормальный товар.'
    ];
    
    for (const text of texts) {
        const result = await analyzer.execute(text);
        console.log(`${text} -> ${result.overall_sentiment}`);
    }
}

🔌 Интеграция

Express.js

const express = require('express');
const { create } = require('k2think-api-builder');

const app = express();
app.use(express.json());

let builder;

async function initServer() {
    builder = await create();
    
    app.post('/analyze', async (req, res) => {
        try {
            const analyzer = builder.createFromTemplate('textAnalyzer');
            const result = await analyzer.execute(req.body.text);
            res.json(result);
        } catch (error) {
            res.status(500).json({ error: error.message });
        }
    });
    
    app.listen(3000);
}

initServer();

Next.js API Route

// pages/api/analyze.js
import { create } from 'k2think-api-builder';

const builder = await create();

export default async function handler(req, res) {
    if (req.method === 'POST') {
        try {
            const analyzer = builder.createFromTemplate('textAnalyzer');
            const result = await analyzer.execute(req.body.text);
            res.json(result);
        } catch (error) {
            res.status(500).json({ error: error.message });
        }
    }
}

🛠️ Разработка

Сборка проекта

npm run build

Генерация документации

npm run docs

📝 CHANGELOG

Смотрите CHANGELOG.md для информации об изменениях.

📄 Лицензия

MIT License - см. LICENSE файл для деталей.

🤝 Вклад

Приветствуются pull requests и issues! Пожалуйста, ознакомьтесь с нашими правилами внесения вклада.

📞 Поддержка

📧 Email: HEDELKA@yandex.ru
🐛 Issues: GitHub Issues
📖 Документация: GitHub Wiki

💳 Криптоподдержка

Если вы хотите поддержать проект криптовалютой:

USDT (TON Network): UQABR7EgocAi1K4VH3Fg4FHyhmNLC9FPoYuED3YkBJZAFelt
TRC20 (USDT): TKSvGezbzvEz9XpKANUUZE89ej436eiqmd

Любая поддержка помогает развивать проект! 🙏

⭐ Звезды

Если эта библиотека вам помогла, поставьте ⭐ на GitHub!

Создано с ❤️ командой K2Think.ai

📦 Установка

npm install

🔐 Настройка аутентификации

Зайдите на https://www.k2think.ai
Авторизуйтесь
Откройте DevTools (F12) → Network
Отправьте любое сообщение в чате
Найдите запрос к API → Headers → Cookie
Скопируйте все cookie и установите переменную окружения:

export K2THINK_COOKIES="token=ваш_jwt; AWSALB=...; AWSALBCORS=...; _ga=...; _fbp=..."

🔐 Аутентификация

Автоматическая (рекомендуется):

Экспортируйте cookies из браузера в формате JSON
Сохраните как Cookie.json в папке проекта
Конвертируйте: npm run cookies
Установите: source set-cookies.sh
Запустите: npm start

Ручная:

export K2THINK_COOKIES="token=ваш_jwt; AWSALB=...; _ga=..."
npm start

🎯 Использование

Запуск диалога:

npm start
# или
node k2think-dialog.js

Создание кастомных API:

npm run api
# или
node api-builder.js

Управление cookies:

npm run cookies              # конвертировать Cookie.json
node cookie-converter.js show # показать текущие cookies

🎯 Универсальный диалог (v1.2.0):

npm run universal             # запустить универсальный диалог
node src/universal-dialog.js  # прямой запуск

🛠️ JSON Builder (v1.2.0):

npm run json                  # запустить JSON Builder
node src/k2think-json-builder.js # прямой запуск

Анализ HAR файла:

npm run analyze
# или
node har-analyzer.js

Программное использование:

const K2ThinkDialog = require('./k2think-dialog');

const dialog = new K2ThinkDialog(cookies);

// Создание нового чата
const chat = await dialog.createNewChat('Привет! Меня зовут Алексей.');

// Отправка сообщения с потоковым ответом
console.log('🤖 Ответ: ');
const response = await dialog.sendMessage(chat.id, 'Расскажи о себе');
console.log(response);

📋 Пример диалога

👤 Пользователь: Привет! Меня зовут Алексей. Я разработчик из Москвы.
🤖 Ответ: Привет, Алексей! Я искусственный интеллект...

💬 Вопрос: Как меня зовут?
🤖 Ответ: Ваше имя — Алексей.

💬 Вопрос: Чем я занимаюсь?
🤖 Ответ: Вы разработчик...

💬 Вопрос: Откуда я?
🤖 Ответ: Вы из Москвы...

🏗️ Структура проекта

k2think-no-ofs/
├── k2think-dialog.js      # Основной класс для работы с API
├── api-builder.js         # 🎨 Конструктор кастомных API
├── cookie-converter.js    # Конвертер cookies из JSON в строку
├── har-analyzer.js        # Анализатор HAR файлов для извлечения данных
├── package.json           # Зависимости проекта
├── README.md             # Документация
├── create-custom-api.md  # 📚 Документация по созданию API
├── Cookie.json           # Cookies в формате JSON (ваш файл)
├── cookies.txt           # Cookies в строке (генерируется)
└── set-cookies.sh        # Скрипт установки (генерируется)

🔍 Анализ HAR файла

Если у вас есть HAR файл с записью запросов к K2Think.ai, вы можете:

Разместить HAR файл в папке проекта как www.k2think.ai.har
Запустить анализ: npm run analyze или node har-analyzer.js
Получить данные: cookies, headers, структура запросов

Что извлекает анализатор:

🍪 Cookies для аутентификации
📡 API эндпоинты и методы
📝 Структура запросов и ответов
🔧 Headers для правильных запросов

🎨 Custom API Builder

Создавайте собственные API методы на основе K2Think.ai для любых задач:

📊 Готовые шаблоны:

textAnalyzer - анализ тональности, тем, ключевых слов
contentGenerator - генерация контента по параметрам
classifier - классификация объектов
translator - перевод между языками
dataExtractor - извлечение структурированных данных

🚹 Пример использования:

const CustomAPIBuilder = require('./api-builder');
const builder = new CustomAPIBuilder();

// Анализ текста
const analyzer = builder.createFromTemplate('textAnalyzer');
const result = await analyzer.execute('Отличный продукт!');
// { sentiment: 'позитивный', themes: ['отзывы'], keywords: ['отличный'] }

// Кастомный метод
const customMethod = builder.createCustom('summarizer', {
    systemPrompt: 'Создай краткое содержание текста',
    parseResponse: (response) => response.trim()
});

const summary = await customMethod.execute('Длинный текст...');

📖 Подробнее:

См. create-custom-api.md для полной документации.

📚 Документация по новым классам (v1.2.0)

🎯 UniversalDialog

📖 Полная документация: docs/UNIVERSAL_DIALOG.md
🌐 Поддержка мульти-провайдеров (K2Think, OpenAI, Anthropic, кастомные)
📋 Универсальный формат сообщений
🎛️ Гибкая конфигурация через JSON или переменные окружения
📊 Автоматическое сохранение истории диалогов

🛠️ K2ThinkJsonBuilder

📖 Полная документация: docs/JSON_BUILDER.md
🏗️ Полный контроль над JSON структурами запросов
🔄 Сохранение и загрузка JSON запросов
📝 Построение диалогов из истории сообщений
⚙️ Все параметры K2Think API под вашим контролем

📁 Примеры использования

examples/configs/config-example.json - пример конфигурации
examples/json-requests/ - готовые JSON запросы
examples/test-fixes.js - тестовые примеры

⚙️ API методы

createNewChat(message) - Создание нового чата
sendMessage(chatId, message) - Отправка сообщения с потоковым ответом
getChat(chatId) - Получение информации о чате
getChatList(page) - Получение списка чатов

📝 Особенности

Память диалога: Модель помнит всю историю разговора
Потоковая передача: Ответы приходят по частям через SSE
Контекст сохраняется: Каждый новый запрос включает всю историю
Русский язык: Полная поддержка русского языка

🔧 Требования

Node.js 18+
npm

📄 Лицензия

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 24 Commits
.github/workflows		.github/workflows
docs		docs
examples		examples
src		src
tests		tests
.gitignore		.gitignore
ANNOUNCEMENT.md		ANNOUNCEMENT.md
CHANGELOG.md		CHANGELOG.md
CHECKLIST.md		CHECKLIST.md
COOKIE_FIXES.md		COOKIE_FIXES.md
FIXES_REPORT.md		FIXES_REPORT.md
LICENSE		LICENSE
PROJECT_SUMMARY.md		PROJECT_SUMMARY.md
PUBLISH.md		PUBLISH.md
README.md		README.md
SETUP.md		SETUP.md
jsdoc.conf.json		jsdoc.conf.json
package-lock.json		package-lock.json
package.json		package.json

License

HEDELKA/k2think-api-builder

Folders and files

Latest commit

History

Repository files navigation

🚀 K2Think API Builder

🎉 v1.2.0 - Универсальный диалог и JSON Builder!

🎉 v1.1.0 - Критические исправления!

🚀 ВАЖНО: Настройка перед использованием

📋 Краткая инструкция (5 минут):

🔗 Подробная инструкция: SETUP.md

✨ Возможности

🎯 Универсальный диалог (v1.2.0)

🛠️ JSON Builder (v1.2.0)

🔧 Основные возможности

📦 Установка

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

✅ Graceful fallback (v1.1.0)

🔧 Опциональные cookies (v1.1.0)

Базовое использование

Фабричный метод

🎯 UniversalDialog (v1.2.0) - Универсальный диалог

🌐 Разные провайдеры

🛠️ K2ThinkJsonBuilder (v1.2.0) - Полный контроль над JSON

📋 Универсальный формат JSON

🎨 Создание кастомных API

📊 Доступные шаблоны

🔧 API Reference

CustomAPIBuilder

Методы

Конфигурация JSON метода

📁 Структура проекта

🧪 Запуск тестов

📚 Примеры

Запуск демо

Пакетная обработка

🔌 Интеграция

Express.js

Next.js API Route

🛠️ Разработка

Сборка проекта

Генерация документации

📝 CHANGELOG

📄 Лицензия

🤝 Вклад

📞 Поддержка

💳 Криптоподдержка

⭐ Звезды

📦 Установка

🔐 Настройка аутентификации

🔐 Аутентификация

Автоматическая (рекомендуется):

Ручная:

🎯 Использование

Запуск диалога:

Создание кастомных API:

Управление cookies:

🎯 Универсальный диалог (v1.2.0):

🛠️ JSON Builder (v1.2.0):

Анализ HAR файла:

Программное использование:

📋 Пример диалога

🏗️ Структура проекта

🔍 Анализ HAR файла

Что извлекает анализатор:

🎨 Custom API Builder

📊 Готовые шаблоны:

🚹 Пример использования:

📖 Подробнее:

📚 Документация по новым классам (v1.2.0)

🎯 UniversalDialog

🛠️ K2ThinkJsonBuilder

📁 Примеры использования

⚙️ API методы

📝 Особенности

🔧 Требования

📄 Лицензия

About

Resources

Packages