JavaScript / TypeScript

Giriş

JavaScript/TypeScript için istemci kütüphanesi, Sunra’nın hizmetleriyle etkileşim kurmak için kullanımı kolay bir arayüz sunar.

Kurulum

İstemciyi projenize entegre etmek için npm kullanarak yükleyin:

npm install @sunra/client

pnpm add @sunra/client

yarn add @sunra/client

Özellikler

Uç Noktaları Çağırma

Sunra, güvenilirlik ve ölçeklenebilirlik sağlayarak uç nokta isteklerini bir kuyruk sistemi aracılığıyla yönetir. Bir istek göndermek ve sonucu beklemek için subscribe yöntemini kullanın. Örnek:

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

const result = await sunra.subscribe("black-forest-labs/flux-kontext-pro/text-to-image", {
  input: {
    prompt: "Güneşli pencere kenarında ahşap bir masa üzerinde, içinde çiçek açan çiçek çayı bulunan cam demlik, nazik sabah ışığıyla.",
    "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);

Kuyruk Yönetimi

Bu yöntemlerle isteklerinizi yönetin:

İstek Gönderme

Bir istek gönderin ve daha sonra kullanmak üzere request_id’yi alın. Örnek:

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

const { request_id } = await sunra.queue.submit("black-forest-labs/flux-kontext-max", {
  input: {
    prompt: "Güneşli pencere kenarında ahşap bir masa üzerinde, içinde çiçek açan çiçek çayı bulunan cam demlik, nazik sabah ışığıyla.",
    "aspect_ratio": "16:9",
    "output_format": "jpeg",
  },
});

İstek Durumunu Kontrol Etme

Bir isteğin durumunu alın. Örnek:

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

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

İstek Sonuçlarını Alma

Tamamlanmış bir isteğin sonucunu getirin. Örnek:

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

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

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

Depolama

storage API’si dosya yüklemenize ve bir URL almanıza olanak tanır, bu URL daha sonra model uç nokta isteklerinizde kullanılabilir. Bu özellikle resimden videoya veya konuşmadan metne gibi dosya girişi gerektiren modeller için faydalıdır.

Maksimum dosya boyutu: 100MB

Tarayıcıda Dosya Yükleme

Kullanıcıların dosyaları doğrudan tarayıcılarından yüklemelerine izin verebilirsiniz. Aşağıdaki örnek, bir dosya seçmek ve yüklemek için <input type="file"> öğesinin nasıl kullanılacağını gösterir.

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('Dosya başarıyla yüklendi:', url);
      // Artık bu URL'yi bir model uç noktası ile kullanabilirsiniz
    } catch (error) {
      console.error('Yükleme başarısız:', error);
    }
  }
});

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

Node.js’te Dosya Yükleme

Node.js ile sunucu tarafında, yerel dosya sisteminden dosyaları okuyup yükleyebilirsiniz.

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);
    // İstemci bir File nesnesi gerektirir, bunu bir buffer'dan oluşturabiliriz
    const file = new File([buffer], basename(filePath));

    const url = await sunra.storage.upload(file);
    console.log('Dosya başarıyla yüklendi:', url);
    return url;
  } catch (error) {
    console.error('Yükleme başarısız:', error);
  }
}

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

Model Uç Noktalarıyla Otomatik Yüklemeler

JavaScript SDK sizin için dosya yüklemelerini otomatik olarak halledebilir. Bir model uç noktasının girişine File nesnesi, Blob veya base64 veri URI’si geçirdiğinizde, SDK önce onu depolamaya yükleyecek ve ardından istekte elde edilen URL’yi kullanacaktır. Bu, ayrı bir yükleme adımı gerçekleştirmenize gerek olmadığı için süreci basitleştirir.

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

// Tarayıcı dosya girişinden bir File nesnesi otomatik olarak yüklenecektir
const fileInput = document.getElementById('file-input');
const file = fileInput.files[0];

const result = await sunra.subscribe("some-model-that-takes-images", {
  input: {
    image: file, // SDK bu dosyayı otomatik olarak yükler
    prompt: "Resimle ne yapılacağını açıklayan bir metin"
  }
});

// Base64 veri URI'si de otomatik olarak yüklenecektir
const base64Image = "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...";

const result2 = await sunra.subscribe("some-model-that-takes-images", {
  input: {
    image: base64Image, // SDK bunu otomatik olarak Blob'a dönüştürür ve yükler
    prompt: "Resimle ne yapılacağını açıklayan bir metin"
  }
});

Destek

Yardım veya tartışmalar için topluluğumuza katılın:

Discord Topluluğu: Bize katılın
GitHub Deposu: Buraya gidin

Size yardımcı olmak için buradayız!

Genel Bakış

Multimodal

LLM

İstemci Kütüphaneleri

JavaScript / TypeScript

Giriş

Kurulum

Özellikler

Uç Noktaları Çağırma

Kuyruk Yönetimi

İstek Gönderme

İstek Durumunu Kontrol Etme

İstek Sonuçlarını Alma

Depolama

Tarayıcıda Dosya Yükleme

Node.js’te Dosya Yükleme

Model Uç Noktalarıyla Otomatik Yüklemeler

Destek

​Giriş

​Kurulum

​Özellikler

​Uç Noktaları Çağırma

​Kuyruk Yönetimi

İstek Gönderme

İstek Durumunu Kontrol Etme

İstek Sonuçlarını Alma

​Depolama

Tarayıcıda Dosya Yükleme

Node.js’te Dosya Yükleme

​Model Uç Noktalarıyla Otomatik Yüklemeler

​Destek

Giriş

Kurulum

Özellikler

Uç Noktaları Çağırma

Kuyruk Yönetimi

Depolama

Model Uç Noktalarıyla Otomatik Yüklemeler

Destek