JavaScript / TypeScript

Введение

Клиентская библиотека для JavaScript/TypeScript предлагает простой в использовании интерфейс для взаимодействия со службами Sunra.

Установка

Чтобы интегрировать клиент в свой проект, установите его с помощью npm:

npm install @sunra/client

pnpm add @sunra/client

yarn add @sunra/client

Функции

Вызов конечных точек

Sunra управляет запросами к конечным точкам через систему очередей, обеспечивая надежность и масштабируемость. Используйте метод subscribe, чтобы отправить запрос и дождаться результата. Пример:

import { sunra } from "@sunra/client";

const result = await sunra.subscribe("black-forest-labs/flux-kontext-pro/text-to-image", {
  input: {
    prompt: "Стеклянный чайник с цветущим цветочным чаем внутри, поставленный на деревянный стол у залитого солнцем окна с мягким утренним светом.",
    "aspect_ratio": "16:9",
    "output_format": "jpeg",
  },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      console.log(update.logs)
    }
  },
});

console.log(result.data);
console.log(result.requestId);

Управление очередью

Управляйте своими запросами с помощью этих методов:

Отправка запроса

Отправьте запрос и получите request_id для последующего использования. Пример:

import { sunra } from "@sunra/client";

const { request_id } = await sunra.queue.submit("black-forest-labs/flux-kontext-max", {
  input: {
    prompt: "Стеклянный чайник с цветущим цветочным чаем внутри, поставленный на деревянный стол у залитого солнцем окна с мягким утренним светом.",
    "aspect_ratio": "16:9",
    "output_format": "jpeg",
  },
});

Проверка статуса запроса

Получите статус запроса. Пример:

import { sunra } from "@sunra/client";

const status = await sunra.queue.status({
  requestId: "pd_eTYYuw4EqYLzRBHgnAMHA8zH",
  logs: true,
});

Получение результатов запроса

Получите результат выполненного запроса. Пример:

import { sunra } from "@sunra/client";

const result = await sunra.queue.result({
  requestId: "pd_eTYYuw4EqYLzRBHgnAMHA8zH",
});

console.log(result.data);
console.log(result.requestId);

Хранилище

API storage позволяет загружать файлы и получать URL-адрес, который затем можно использовать в запросах к конечным точкам вашей модели. Это особенно полезно для моделей, которым требуются входные файлы, таких как преобразователи изображения в видео или речи в текст.

Максимальный размер файла: 100 МБ

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

Вы можете разрешить пользователям загружать файлы прямо из браузера. В следующем примере показано, как использовать элемент <input type="file"> для выбора и загрузки файла.

import { sunra } from "@sunra/client";

const fileInput = document.getElementById('file-input');

fileInput.addEventListener('change', async (event) => {
  const file = event.target.files[0];
  if (file) {
    try {
      const url = await sunra.storage.upload(file);
      console.log('Файл успешно загружен:', url);
      // Теперь вы можете использовать этот URL с конечной точкой модели
    } catch (error) {
      console.error('Ошибка загрузки:', error);
    }
  }
});

<input type="file" id="file-input" />

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

На стороне сервера с помощью Node.js вы можете читать файлы из локальной файловой системы и загружать их.

import { sunra } from "@sunra/client";
import { readFile } from "node:fs/promises";
import { basename } from "node:path";

async function uploadLocalFile(filePath) {
  try {
    const buffer = await readFile(filePath);
    // Клиенту нужен объект File, который мы можем создать из буфера
    const file = new File([buffer], basename(filePath));

    const url = await sunra.storage.upload(file);
    console.log('Файл успешно загружен:', url);
    return url;
  } catch (error) {
    console.error('Ошибка загрузки:', error);
  }
}

uploadLocalFile("./путь/к/вашему/изображению.png");

Автоматическая загрузка с помощью конечных точек модели

SDK JavaScript может автоматически обрабатывать загрузку файлов за вас. Когда вы передаете объект File, Blob или URI данных base64 на вход конечной точки модели, SDK сначала загрузит его в хранилище, а затем использует полученный URL-адрес в запросе. Это упрощает процесс, так как вам не нужно выполнять отдельный шаг загрузки.

import { sunra } from "@sunra/client";

// Объект File из файлового ввода браузера будет загружен автоматически
const fileInput = document.getElementById('file-input');
const file = fileInput.files[0];

const result = await sunra.subscribe("какая-то-модель-которая-принимает-изображения", {
  input: {
    image: file, // SDK автоматически загружает этот файл
    prompt: "Подсказка, описывающая, что делать с изображением"
  }
});

// URI данных base64 также будет загружен автоматически
const base64Image = "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...";

const result2 = await sunra.subscribe("какая-то-модель-которая-принимает-изображения", {
  input: {
    image: base64Image, // SDK автоматически преобразует это в Blob и загружает его
    prompt: "Подсказка, описывающая, что делать с изображением"
  }
});

Поддержка

Присоединяйтесь к нашему сообществу для помощи или обсуждений:

Сообщество Discord: Присоединяйтесь к нам
Репозиторий GitHub: Посетите здесь

Мы здесь, чтобы помочь вам!

Обзор

Multimodal

LLM

Клиентские библиотеки

JavaScript / TypeScript

Введение

Установка

Функции

Вызов конечных точек

Управление очередью

Отправка запроса

Проверка статуса запроса

Получение результатов запроса

Хранилище

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

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

Автоматическая загрузка с помощью конечных точек модели

Поддержка

​Введение

​Установка

​Функции

​Вызов конечных точек

​Управление очередью

Отправка запроса

Проверка статуса запроса

Получение результатов запроса

​Хранилище

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

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

​Автоматическая загрузка с помощью конечных точек модели

​Поддержка

Введение

Установка

Функции

Вызов конечных точек

Управление очередью

Хранилище

Автоматическая загрузка с помощью конечных точек модели

Поддержка