JavaScript / TypeScript

Introducción

La biblioteca cliente para JavaScript/TypeScript ofrece una interfaz fácil de usar para interactuar con los servicios de Sunra.

Instalación

Para integrar el cliente en tu proyecto, instálalo usando npm:

npm install @sunra/client

pnpm add @sunra/client

yarn add @sunra/client

Características

Llamando a los Endpoints

Sunra gestiona las solicitudes de los endpoints a través de un sistema de colas, lo que garantiza la fiabilidad y la escalabilidad. Usa el método subscribe para enviar una solicitud y esperar el resultado. Ejemplo:

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

const result = await sunra.subscribe("black-forest-labs/flux-kontext-pro/text-to-image", {
  input: {
    prompt: "Una tetera de cristal con té de flores en flor en su interior, colocada sobre una mesa de madera junto a una ventana iluminada por el sol con una suave luz matutina.",
    "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);

Gestión de la Cola

Gestiona tus solicitudes con estos métodos:

Enviando una Solicitud

Envía una solicitud y recupera el request_id para usarlo más tarde. Ejemplo:

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

const { request_id } = await sunra.queue.submit("black-forest-labs/flux-kontext-max", {
  input: {
    prompt: "Una tetera de cristal con té de flores en flor en su interior, colocada sobre una mesa de madera junto a una ventana iluminada por el sol con una suave luz matutina.",
    "aspect_ratio": "16:9",
    "output_format": "jpeg",
  },
});

Comprobando el Estado de la Solicitud

Recupera el estado de una solicitud. Ejemplo:

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

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

Recuperando los Resultados de la Solicitud

Obtén el resultado de una solicitud completada. Ejemplo:

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

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

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

Almacenamiento

La API de storage te permite subir archivos y recibir una URL, que luego se puede usar en tus solicitudes de endpoint de modelo. Esto es particularmente útil para modelos que requieren entradas de archivos, como de imagen a video o de voz a texto.

Tamaño máximo de archivo: 100MB

Subiendo Archivos en el Navegador

Puedes permitir que los usuarios suban archivos directamente desde su navegador. El siguiente ejemplo muestra cómo usar un elemento <input type="file"> para seleccionar un archivo y subirlo.

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('Archivo subido con éxito:', url);
      // Ahora puedes usar esta URL con un endpoint de modelo
    } catch (error) {
      console.error('La subida falló:', error);
    }
  }
});

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

Subiendo Archivos en Node.js

En el lado del servidor con Node.js, puedes leer archivos del sistema de archivos local y subirlos.

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);
    // El cliente necesita un objeto File, que podemos crear a partir de un búfer
    const file = new File([buffer], basename(filePath));

    const url = await sunra.storage.upload(file);
    console.log('Archivo subido con éxito:', url);
    return url;
  } catch (error) {
    console.error('La subida falló:', error);
  }
}

uploadLocalFile("./path/to/your/image.png");

Subidas Automáticas con Endpoints de Modelo

El SDK de JavaScript puede manejar automáticamente las subidas de archivos por ti. Cuando pasas un objeto File, Blob o un URI de datos base64 a la entrada de un endpoint de modelo, el SDK primero lo subirá al almacenamiento y luego usará la URL resultante en la solicitud. Esto simplifica el proceso ya que no necesitas realizar un paso de subida por separado.

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

// Un objeto File de una entrada de archivo del navegador se subirá automáticamente
const fileInput = document.getElementById('file-input');
const file = fileInput.files[0];

const result = await sunra.subscribe("some-model-that-takes-images", {
  input: {
    image: file, // El SDK sube este archivo automáticamente
    prompt: "Un prompt que describe qué hacer con la imagen"
  }
});

// Un URI de datos base64 también se subirá automáticamente
const base64Image = "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...";

const result2 = await sunra.subscribe("some-model-that-takes-images", {
  input: {
    image: base64Image, // El SDK convierte esto automáticamente a un Blob y lo sube
    prompt: "Un prompt que describe qué hacer con la imagen"
  }
});

Soporte

Únete a nuestra comunidad para obtener ayuda o participar en debates:

Comunidad de Discord: Únete a nosotros
Repositorio de GitHub: Visítalo aquí

¡Estamos aquí para ayudarte!

Descripción general

Multimodal

LLM

Bibliotecas de cliente

JavaScript / TypeScript

Introducción

Instalación

Características

Llamando a los Endpoints

Gestión de la Cola

Enviando una Solicitud

Comprobando el Estado de la Solicitud

Recuperando los Resultados de la Solicitud

Almacenamiento

Subiendo Archivos en el Navegador

Subiendo Archivos en Node.js

Subidas Automáticas con Endpoints de Modelo

Soporte

​Introducción

​Instalación

​Características

​Llamando a los Endpoints

​Gestión de la Cola

Enviando una Solicitud

Comprobando el Estado de la Solicitud

Recuperando los Resultados de la Solicitud

​Almacenamiento

Subiendo Archivos en el Navegador

Subiendo Archivos en Node.js

​Subidas Automáticas con Endpoints de Modelo

​Soporte

Introducción

Instalación

Características

Llamando a los Endpoints

Gestión de la Cola

Almacenamiento

Subidas Automáticas con Endpoints de Modelo

Soporte