@sunra/client npm package

परिचय

जावास्क्रिप्ट/टाइपस्क्रिप्ट के लिए क्लाइंट लाइब्रेरी Sunra की सेवाओं के साथ बातचीत करने के लिए एक उपयोग में आसान इंटरफ़ेस प्रदान करती है।

स्थापना

क्लाइंट को अपने प्रोजेक्ट में एकीकृत करने के लिए, इसे npm का उपयोग करके स्थापित करें:
npm install @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);

भंडारण

storage API आपको फ़ाइलें अपलोड करने और एक URL प्राप्त करने की अनुमति देता है, जिसका उपयोग आपके मॉडल एंडपॉइंट अनुरोधों में किया जा सकता है। यह उन मॉडलों के लिए विशेष रूप से उपयोगी है जिन्हें फ़ाइल इनपुट की आवश्यकता होती है, जैसे कि इमेज-टू-वीडियो या स्पीच-टू-टेक्स्ट।
अधिकतम फ़ाइल आकार: 100MB
ब्राउज़र में फ़ाइलें अपलोड करना
आप उपयोगकर्ताओं को सीधे उनके ब्राउज़र से फ़ाइलें अपलोड करने की अनुमति दे सकते हैं। निम्नलिखित उदाहरण दिखाता है कि फ़ाइल का चयन करने और उसे अपलोड करने के लिए <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);
    }
  }
});
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);
    // क्लाइंट को एक फ़ाइल ऑब्जेक्ट की आवश्यकता होती है, जिसे हम बफर से बना सकते हैं
    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("./path/to/your/image.png");

मॉडल एंडपॉइंट्स के साथ स्वचालित अपलोड

जावास्क्रिप्ट SDK आपके लिए स्वचालित रूप से फ़ाइल अपलोड को संभाल सकता है। जब आप किसी मॉडल एंडपॉइंट के इनपुट में File ऑब्जेक्ट, Blob, या बेस 64 डेटा URI पास करते हैं, तो SDK पहले इसे स्टोरेज पर अपलोड करेगा और फिर अनुरोध में परिणामी URL का उपयोग करेगा। यह प्रक्रिया को सरल बनाता है क्योंकि आपको एक अलग अपलोड चरण करने की आवश्यकता नहीं है।
import { sunra } from "@sunra/client";

// ब्राउज़र फ़ाइल इनपुट से एक फ़ाइल ऑब्जेक्ट स्वचालित रूप से अपलोड हो जाएगा
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 इस फ़ाइल को स्वचालित रूप से अपलोड करता है
    prompt: "छवि के साथ क्या करना है इसका वर्णन करने वाला एक प्रॉम्प्ट"
  }
});

// एक बेस 64 डेटा URI भी स्वचालित रूप से अपलोड हो जाएगा
const base64Image = "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...";

const result2 = await sunra.subscribe("some-model-that-takes-images", {
  input: {
    image: base64Image, // SDK इसे स्वचालित रूप से एक ब्लॉब में परिवर्तित करता है और इसे अपलोड करता है
    prompt: "छवि के साथ क्या करना है इसका वर्णन करने वाला एक प्रॉम्प्ट"
  }
});

सहायता

सहायता या चर्चा के लिए हमारे समुदाय में शामिल हों: हम आपकी सहायता के लिए यहां हैं!