JavaScript / TypeScript

Introduzione

La libreria client per JavaScript/TypeScript offre un’interfaccia facile da usare per interagire con i servizi di Sunra.

Installazione

Per integrare il client nel tuo progetto, installalo usando npm:

npm install @sunra/client

pnpm add @sunra/client

yarn add @sunra/client

Funzionalità

Chiamata degli endpoint

Sunra gestisce le richieste degli endpoint tramite un sistema di code, garantendo affidabilità e scalabilità. Usa il metodo subscribe per inviare una richiesta e attendere il risultato. Esempio:

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

const result = await sunra.subscribe("black-forest-labs/flux-kontext-pro/text-to-image", {
  input: {
    prompt: "Una teiera di vetro con tè ai fiori che sbocciano all'interno, posta su un tavolo di legno vicino a una finestra illuminata dal sole con una luce mattutina delicata.",
    "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);

Gestione delle code

Gestisci le tue richieste con questi metodi:

Invio di una richiesta

Invia una richiesta e recupera il request_id per un uso successivo. Esempio:

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

const { request_id } = await sunra.queue.submit("black-forest-labs/flux-kontext-max", {
  input: {
    prompt: "Una teiera di vetro con tè ai fiori che sbocciano all'interno, posta su un tavolo di legno vicino a una finestra illuminata dal sole con una luce mattutina delicata.",
    "aspect_ratio": "16:9",
    "output_format": "jpeg",
  },
});

Controllo dello stato della richiesta

Recupera lo stato di una richiesta. Esempio:

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

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

Recupero dei risultati della richiesta

Recupera il risultato di una richiesta completata. Esempio:

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

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

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

Archiviazione

L’API storage ti consente di caricare file e ricevere un URL, che può quindi essere utilizzato nelle tue richieste di endpoint del modello. Ciò è particolarmente utile per i modelli che richiedono input di file, come l’immagine-video o il parlato-testo.

Dimensione massima del file: 100 MB

Caricamento di file nel browser

Puoi consentire agli utenti di caricare file direttamente dal loro browser. L’esempio seguente mostra come utilizzare un elemento <input type="file"> per selezionare un file e caricarlo.

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('File caricato con successo:', url);
      // Ora puoi usare questo URL con un endpoint del modello
    } catch (error) {
      console.error('Caricamento fallito:', error);
    }
  }
});

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

Caricamento di file in Node.js

Sul lato server con Node.js, puoi leggere i file dal filesystem locale e caricarli.

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);
    // Il client necessita di un oggetto File, che possiamo creare da un buffer
    const file = new File([buffer], basename(filePath));

    const url = await sunra.storage.upload(file);
    console.log('File caricato con successo:', url);
    return url;
  } catch (error) {
    console.error('Caricamento fallito:', error);
  }
}

uploadLocalFile("./percorso/alla/tua/immagine.png");

Caricamenti automatici con endpoint del modello

L’SDK di JavaScript può gestire automaticamente i caricamenti di file per te. Quando passi un oggetto File, Blob o un URI di dati base64 all’input di un endpoint del modello, l’SDK lo caricherà prima nell’archivio e quindi utilizzerà l’URL risultante nella richiesta. Ciò semplifica il processo poiché non è necessario eseguire un passaggio di caricamento separato.

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

// Un oggetto File da un input di file del browser verrà caricato automaticamente
const fileInput = document.getElementById('file-input');
const file = fileInput.files[0];

const result = await sunra.subscribe("qualche-modello-che-accetta-immagini", {
  input: {
    image: file, // L'SDK carica automaticamente questo file
    prompt: "Un prompt che descrive cosa fare con l'immagine"
  }
});

// Verrà caricato automaticamente anche un URI di dati base64
const base64Image = "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...";

const result2 = await sunra.subscribe("qualche-modello-che-accetta-immagini", {
  input: {
    image: base64Image, // L'SDK converte automaticamente questo in un Blob e lo carica
    prompt: "Un prompt che descrive cosa fare con l'immagine"
  }
});

Supporto

Unisciti alla nostra community per aiuto o discussioni:

Community Discord: Unisciti a noi
Repository GitHub: Visita qui

Siamo qui per aiutarti!

Panoramica

Multimodal

LLM

Librerie client

JavaScript / TypeScript

Introduzione

Installazione

Funzionalità

Chiamata degli endpoint

Gestione delle code

Invio di una richiesta

Controllo dello stato della richiesta

Recupero dei risultati della richiesta

Archiviazione

Caricamento di file nel browser

Caricamento di file in Node.js

Caricamenti automatici con endpoint del modello

Supporto

​Introduzione

​Installazione

​Funzionalità

​Chiamata degli endpoint

​Gestione delle code

Invio di una richiesta

Controllo dello stato della richiesta

Recupero dei risultati della richiesta

​Archiviazione

Caricamento di file nel browser

Caricamento di file in Node.js

​Caricamenti automatici con endpoint del modello

​Supporto

Introduzione

Installazione

Funzionalità

Chiamata degli endpoint

Gestione delle code

Archiviazione

Caricamenti automatici con endpoint del modello

Supporto