Python

Pendahuluan

Pustaka klien untuk Python menawarkan antarmuka yang mudah digunakan untuk berinteraksi dengan layanan Sunra.

Instalasi

Untuk mengintegrasikan klien ke dalam proyek Anda, instal menggunakan pip:

pip install sunra-client

Fitur

Memanggil Titik Akhir

Sunra mengelola permintaan titik akhir melalui sistem antrian, memastikan keandalan dan skalabilitas. Gunakan metode subscribe untuk mengirim permintaan dan menunggu hasilnya. Contoh:

import sunra_client

result = sunra_client.subscribe(
    "black-forest-labs/flux-kontext-pro/text-to-image",
    arguments={
    	"prompt": 'Kota tepi laut yang terinspirasi dari Studio Ghibli dengan rumah-rumah berwarna-warni, cucian berkibar, dan kucing tidur di ambang jendela.',
    	"width": 1024,
    	"height": 768,
    	"output_format": 'jpeg'
    },
    with_logs=True,
    on_enqueue=print,
    on_queue_update=print,
)
print(result)

Manajemen Antrian

Kelola permintaan Anda dengan metode ini:

Mengirim Permintaan

Kirim permintaan dan dapatkan request_id untuk penggunaan nanti. Contoh:

import sunra_client

handler = sunra_client.submit(
    "black-forest-labs/flux-kontext-pro/text-to-image",
    arguments={
      "prompt": 'Kota tepi laut yang terinspirasi dari Studio Ghibli dengan rumah-rumah berwarna-warni, cucian berkibar, dan kucing tidur di ambang jendela.',
      "width": 1024,
      "height": 768,
      "output_format": 'jpeg'
    },
    webhook_url="https://optional.webhook.url/for/results",
)
request_id = handler.request_id

Memeriksa Status Permintaan

Ambil status permintaan. Contoh:

import sunra_client
status = sunra_client.status(request_id, with_logs=True)

Mengambil Hasil Permintaan

Ambil hasil dari permintaan yang sudah selesai. Contoh:

import sunra_client
result = sunra_client.result(request_id)

Unggahan File

Unggah file untuk mendapatkan URL untuk digunakan dalam permintaan asinkron. Ini penting untuk model yang memproses file, seperti konverter gambar-ke-video atau ucapan-ke-teks.

Ukuran file maksimum: 100MB

Mengunggah File Lokal

Anda dapat dengan mudah mengunggah file dari sistem file lokal Anda. Ini berguna untuk skrip atau aplikasi yang memproses data lokal.

import sunra_client

# Inisialisasi klien sinkron
client = sunra_client.SyncClient()

try:
  # Unggah file dari path yang diberikan
  file_url = client.upload_file(path="path/to/your/image.png")
  print(f"File berhasil diunggah: {file_url}")
  # URL ini sekarang dapat digunakan dengan titik akhir model
except FileNotFoundError:
  print("Error: File tidak ditemukan di path yang ditentukan.")
except Exception as e:
  print(f"Terjadi kesalahan: {e}")

Mengunggah Data Dalam Memori

Anda juga dapat mengunggah data yang ada di memori, seperti konten gambar yang dibuat dengan PIL (Pillow) atau file yang diterima dalam permintaan web.

import sunra_client
from PIL import Image
import io

# Inisialisasi klien sinkron
client = sunra_client.SyncClient()

# Buat gambar di memori, misalnya dengan Pillow
image = Image.new("RGB", (600, 400), color = 'red')
byte_arr = io.BytesIO()
image.save(byte_arr, format='PNG')
image_bytes = byte_arr.getvalue()

# Unggah data gambar dalam memori menggunakan metode `upload`
image_url = client.upload(
    data=image_bytes,
    content_type="image/png"
)
print(f"Gambar berhasil diunggah: {image_url}")

import sunra_client

# Inisialisasi klien sinkron
client = sunra_client.SyncClient()

# Beberapa byte mentah yang mungkin Anda miliki dari membaca file atau permintaan web
raw_data = b"beberapa konten file di sini"

# Unggah byte mentah
data_url = client.upload(
    data=raw_data,
    content_type="application/octet-stream"
)
print(f"Data berhasil diunggah: {data_url}")

Dukungan

Bergabunglah dengan komunitas kami untuk bantuan atau diskusi:

Komunitas Discord: Bergabunglah dengan kami
Repositori GitHub: Kunjungi di sini

Kami di sini untuk membantu Anda!

Ikhtisar

Multimodal

LLM

Pustaka Klien

Pendahuluan

Instalasi

Fitur

Memanggil Titik Akhir

Manajemen Antrian

Mengirim Permintaan

Memeriksa Status Permintaan

Mengambil Hasil Permintaan

Unggahan File

Mengunggah File Lokal

Mengunggah Data Dalam Memori

Dukungan

​Pendahuluan

​Instalasi

​Fitur

​Memanggil Titik Akhir

​Manajemen Antrian

Mengirim Permintaan

Memeriksa Status Permintaan

Mengambil Hasil Permintaan

​Unggahan File

Mengunggah File Lokal

Mengunggah Data Dalam Memori

​Dukungan

Pendahuluan

Instalasi

Fitur

Memanggil Titik Akhir

Manajemen Antrian

Unggahan File

Dukungan