Langsung ke konten utama
Dalam panduan ini, kami akan memandu Anda menggunakan salah satu titik akhir model populer kami, seperti black-forest-labs/flux-kontext-pro/text-to-image. Sebelum memulai, pastikan Anda memiliki kunci API dari dasbor Anda, yang diperlukan untuk mengautentikasi permintaan Anda ke API sunra. Pilih bahasa pemrograman pilihan Anda di bawah ini untuk memulai:

JavaScript/Node.js

Untuk memulai, instal paket klien dan konfigurasikan dengan kunci API Anda:
npm install @sunra/client
Atur kunci API Anda sebagai variabel lingkungan:
export SUNRA_KEY="kunci-api-anda-di-sini"
Setelah dikonfigurasi, Anda dapat memanggil titik akhir API Model kami menggunakan klien sunra:
import { sunra } from "@sunra/client";

// Secara opsional, konfigurasikan klien dengan kunci API yang berbeda dari yang diatur dalam variabel lingkungan
sunra.config({
  credentials: "KUNCI_SUNRA_ANDA",
});

const result = await sunra.subscribe("black-forest-labs/flux-kontext-pro/text-to-image", {
  input: {
    prompt: "Seekor kelinci memakai kacamata membaca buku di bawah jamur dengan gaya cat air.",
    width: 1024,
    height: 768,
    output_format: "jpeg"
  },
});

Python

Instal pustaka klien Python menggunakan pip:
pip install sunra-client
Atur kunci API Anda sebagai variabel lingkungan:
export SUNRA_KEY="kunci-api-anda-di-sini"
Konfigurasikan dan gunakan klien:
import sunra_client

result = sunra_client.subscribe(
    "black-forest-labs/flux-kontext-pro/text-to-image",
    arguments={
        "prompt": "Seekor kelinci memakai kacamata membaca buku di bawah jamur dengan gaya cat air.",
        "width": 1024,
        "height": 768,
        "output_format": "jpeg"
    },
    with_logs=True,
    on_enqueue=print,
    on_queue_update=print,
)
print(result)

Java

Tambahkan pustaka klien Java ke proyek Anda menggunakan sistem build pilihan Anda:
implementation("ai.sunra.client:sunra-client:0.1.5")
Atur kunci API Anda sebagai variabel lingkungan:
export SUNRA_KEY="kunci-api-anda-di-sini"
Konfigurasikan dan gunakan klien:
import ai.sunra.client.*;
import ai.sunra.client.queue.*;
import java.util.Map;
import com.google.gson.JsonObject;
import java.util.function.Consumer;

ClientConfig config = ClientConfig.builder()
    .withCredentials(CredentialsResolver.fromEnv())
    .build();

SunraClient client = SunraClient.withConfig(config);
Map<String, Object> input = Map.of(
    "prompt", "Seekor kelinci memakai kacamata membaca buku di bawah jamur dengan gaya cat air.",
    "width", 1024,
    "height", 768,
    "output_format", "jpeg"
);

Consumer<QueueStatus.StatusUpdate> statusUpdateHandler = update -> {
    String status = update.getStatus().toString();
    String message = String.format("\nPembaruan Status: %s, ID Permintaan: %s",
        status, update.getRequestId());
    System.out.println(message);
};

SubscribeOptions<JsonObject> options = SubscribeOptions.<JsonObject>builder()
    .input(input)
    .resultType(JsonObject.class)
    .onQueueUpdate(statusUpdateHandler)
    .logs(true)
    .build();

Output<JsonObject> response = client.subscribe("black-forest-labs/flux-kontext-pro/text-to-image", options);
System.out.println("Selesai!");
System.out.println(response.getData());

Langkah Berikutnya

Kami menawarkan berbagai model seperti Flux kontext pro dan Kling v2 master sebagai API siap pakai. Jelajahi ini di Laboratorium Model kami. Untuk menggunakan model, kunjungi tab “API” untuk menemukan URL, kode sumber, dan contoh penggunaan, yang membantu Anda mengintegrasikannya dengan mulus ke dalam aplikasi Anda. Untuk informasi lebih rinci tentang setiap pustaka klien, kunjungi dokumentasi pustaka klien kami.