JavaScript / TypeScript

Einführung

Die Client-Bibliothek für JavaScript/TypeScript bietet eine benutzerfreundliche Schnittstelle zur Interaktion mit den Diensten von Sunra AI.

Installation

Um den Client in Ihr Projekt zu integrieren, installieren Sie ihn mit npm:

npm install @sunra/client

pnpm add @sunra/client

yarn add @sunra/client

Funktionen

Endpunkte aufrufen

Sunra AI verwaltet Endpunktanfragen über ein Warteschlangensystem, das Zuverlässigkeit und Skalierbarkeit gewährleistet. Verwenden Sie die subscribe-Methode, um eine Anfrage zu senden und auf das Ergebnis zu warten. Beispiel:

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

const result = await sunra.subscribe("black-forest-labs/flux-kontext-pro/text-to-image", {
  input: {
    prompt: "Eine gläserne Teekanne mit blühendem Blumentee darin, auf einem Holztisch bei einem sonnendurchfluteten Fenster mit sanftem Morgenlicht.",
    "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);

Warteschlangenverwaltung

Verwalten Sie Ihre Anfragen mit diesen Methoden:

Eine Anfrage senden

Senden Sie eine Anfrage und rufen Sie die request_id zur späteren Verwendung ab. Beispiel:

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

const { request_id } = await sunra.queue.submit("black-forest-labs/flux-kontext-max", {
  input: {
    prompt: "Eine gläserne Teekanne mit blühendem Blumentee darin, auf einem Holztisch bei einem sonnendurchfluteten Fenster mit sanftem Morgenlicht.",
    "aspect_ratio": "16:9",
    "output_format": "jpeg",
  },
});

Anfragestatus überprüfen

Rufen Sie den Status einer Anfrage ab. Beispiel:

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

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

Anforderungsergebnisse abrufen

Rufen Sie das Ergebnis einer abgeschlossenen Anfrage ab. Beispiel:

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

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

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

Speicher

Die storage-API ermöglicht es Ihnen, Dateien hochzuladen und eine URL zu erhalten, die dann in Ihren Modellanfragen verwendet werden kann. Dies ist besonders nützlich für Modelle, die Dateieingaben erfordern, wie z. B. Bild-zu-Video oder Sprache-zu-Text.

Maximale Dateigröße: 100MB

Dateien im Browser hochladen

Sie können Benutzern erlauben, Dateien direkt aus ihrem Browser hochzuladen. Das folgende Beispiel zeigt, wie Sie ein <input type="file">-Element verwenden, um eine Datei auszuwählen und hochzuladen.

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('Datei erfolgreich hochgeladen:', url);
      // Jetzt können Sie diese URL mit einem Modellendpunkt verwenden
    } catch (error) {
      console.error('Upload fehlgeschlagen:', error);
    }
  }
});

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

Dateien in Node.js hochladen

Auf der Serverseite mit Node.js können Sie Dateien aus dem lokalen Dateisystem lesen und hochladen.

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);
    // Der Client benötigt ein File-Objekt, das wir aus einem Puffer erstellen können
    const file = new File([buffer], basename(filePath));

    const url = await sunra.storage.upload(file);
    console.log('Datei erfolgreich hochgeladen:', url);
    return url;
  } catch (error) {
    console.error('Upload fehlgeschlagen:', error);
  }
}

uploadLocalFile("./pfad/zu/ihrem/bild.png");

Automatische Uploads mit Modellendpunkten

Das JavaScript-SDK kann Datei-Uploads automatisch für Sie erledigen. Wenn Sie ein File-Objekt, Blob oder eine Base64-Daten-URI an die Eingabe eines Modellendpunkts übergeben, lädt das SDK diese zuerst in den Speicher hoch und verwendet dann die resultierende URL in der Anfrage. Dies vereinfacht den Prozess, da Sie keinen separaten Upload-Schritt durchführen müssen.

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

// Ein File-Objekt aus einer Browser-Dateieingabe wird automatisch hochgeladen
const fileInput = document.getElementById('file-input');
const file = fileInput.files[0];

const result = await sunra.subscribe("ein-modell-das-bilder-annimmt", {
  input: {
    image: file, // SDK lädt diese Datei automatisch hoch
    prompt: "Eine Aufforderung, die beschreibt, was mit dem Bild zu tun ist"
  }
});

// Eine Base64-Daten-URI wird ebenfalls automatisch hochgeladen
const base64Image = "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...";

const result2 = await sunra.subscribe("ein-modell-das-bilder-annimmt", {
  input: {
    image: base64Image, // SDK konvertiert dies automatisch in ein Blob und lädt es hoch
    prompt: "Eine Aufforderung, die beschreibt, was mit dem Bild zu tun ist"
  }
});

Unterstützung

Treten Sie unserer Community für Hilfe oder Diskussionen bei:

Discord-Community: Treten Sie uns bei
GitHub-Repository: Besuchen Sie hier

Wir sind hier, um Ihnen zu helfen!

Überblick

Multimodal

LLM

Client-Bibliotheken

JavaScript / TypeScript

Einführung

Installation

Funktionen

Endpunkte aufrufen

Warteschlangenverwaltung

Eine Anfrage senden

Anfragestatus überprüfen

Anforderungsergebnisse abrufen

Speicher

Dateien im Browser hochladen

Dateien in Node.js hochladen

Automatische Uploads mit Modellendpunkten

Unterstützung

​Einführung

​Installation

​Funktionen

​Endpunkte aufrufen

​Warteschlangenverwaltung

Eine Anfrage senden

Anfragestatus überprüfen

Anforderungsergebnisse abrufen

​Speicher

Dateien im Browser hochladen

Dateien in Node.js hochladen

​Automatische Uploads mit Modellendpunkten

​Unterstützung

Einführung

Installation

Funktionen

Endpunkte aufrufen

Warteschlangenverwaltung

Speicher

Automatische Uploads mit Modellendpunkten

Unterstützung