gigachat-node v2.4.5

GigaChat API Library

Эта библиотека обеспечивает удобный доступ к GigaChat REST API из TypeScript или JavaScript.

Чтобы узнать, как использовать GigaChat API, ознакомьтесь с документацией по API.

• Установка
• Импорт
• Начало работы
• Получение всех моделей
• Завершение чата
• Завершение чата в потоке
• Генерация изображений
• Векторное представление текста
• Подсчет кол-ва токенов
• Загрузка файлов
• Получение доступных файлов
• Получение информации о файле
• Удаление файла
• Получение баланса токенов
• Скачивание файла
• Примеры работы

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

Установка

npm i gigachat-node

Импорт

Первый вариант импорта:

import { GigaChat } from 'gigachat-node';

Второй вариант импорта:

const GigaChat = require('gigachat-node').GigaChat;

Начало работы

Создание экземпляра класса и получение токена доступа к API (подробнее в документации). Обратите внимание, что при получении CLIENT_SECRET необходимо копировать значение в Base64, иначе придется переводить самостоятельно ключ в Base64.

const client = new GigaChat({
    clientSecretKey: 'CLIENT-SECRET-KEY', 
    isIgnoreTSL: true,
    isPersonal: true,
    autoRefreshToken: true
});
await client.createToken();

Получение всех моделей

Возвращает массив объектов с данными доступных моделей.

const responce = await client.allModels();

Завершение чата

Возвращает ответ модели с учетом переданных сообщений. Подробнее про параметры запроса можно прочитать в оффициальной документации.

const responce = await client.completion({
    "model":"GigaChat:latest",
    "messages": [
        {
            role:"user",
            content:"Привет! Как дела?"
        }
    ]
});

console.log(responce.choices[0].message);

Завершение чата в потоке

Возвращает ответ модели в потоке в base64. Подробнее можно прочитать в оффициальной документации.

const stream = await client.completionStream({
    "model":"GigaChat:latest",
    "messages": [
        {
            role:"user",
            content:"Привет! Напиши текст на 2000 слов про историю часов."
        }
    ]
});

let str = '';

stream.on('data', async (data) => {
    const decodedData = await data.toString('utf-8');
    const jsonData = await JSON.parse(decodedData.substring(6));
    str += jsonData.choices[0].delta.content;
})

stream.on('end', () => {
    console.log('Поток завершился.')
})

Векторное представление текста

Возвращает векторные представления соответствующих текстовых запросов. Подробнее в документации API.

const embed = await client.embedding(["Как дела?", "Векторное представлеие? 0_0"]);
console.log(embed.data);

Подсчет кол-ва токенов

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

const sum = await client.summarize("GigaChat", ["Подсчитай кол-во токенов в этой строке"]);
console.log(sum[0].tokens);

Загрузка файлов

Загружает в хранилище текстовые документы или изображения. Возвращает объект с данными загруженного файла. Загруженные файлы доступны только вам. Подробнее в документации API.

const file = await client.uploadFile("path/to/file");
console.log(file);

Получение доступных файлов

Получение списка всех доступных файлов. Возвращает массив объектов с данными доступных файлов. Подробнее в документации API.

const files = await client.getAllFiles();
console.log(files);

Получение информации о файле

Получение информации о файле по уникальному идентификатору. Возвращает объект с описанием указанного файла. Подробнее в документации API.

const file = await client.getFileInfo('fileId');
console.log(file);

Получение баланса токенов

Возвращает доступный остаток токенов для каждой из моделей. Подробнее в документации API.

const balance = await client.getBalance();
console.log(balance);

Удаление файла

Удаление файла по уникальному идентификатору. Переводит статус файла в значение deleted. Подробнее в документации API.

const deletedFile = await client.deleteFile('fileId');
console.log(deletedFile);

Скачивание файла

Получение файла в бинарном формате по уникальному идентификатору.

const binary = await client.downloadFile("fileId");
console.log(binary);

RoadMap