Panduan Cepat untuk Pengguna OpenRouter NSFW

URL Dasar dan Autentikasi

Ganti Base URL penyedia Anda saat ini dengan https://api.openrouternsfw.com/v1. Autentikasi menggunakan header Authorization: Bearer <key> standar. Anda mendapatkan kunci segera setelah masuk melalui Google atau email di halaman Dapatkan kunci API. Tidak diperlukan nomor telepon, dan kunci hanya ditampilkan sekali, jadi salin sebelum meninggalkan halaman.

Layanan kami adalah API independen, bukan reseller model vendor lain. Pengidentifikasi model yang Anda kirimkan dalam permintaan adalah uncensored, yang berjalan di server kami sendiri. Ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, tetapi ini bukan model GPT, Claude, atau model vendor bernama lainnya.

Pastikan pustaka klien Anda dikonfigurasi untuk menggunakan Base URL baru ini. Semua permintaan harus menyertakan kunci API yang valid di header. Jika kunci tidak ada atau tidak valid, server mengembalikan kesalahan 401. Jika Anda tidak memiliki saldo prabayar, Anda menerima kesalahan 402. Ini adalah kode status HTTP standar yang menunjukkan masalah autentikasi atau pembayaran, bukan kesalahan server.

Endpoint Penyelesaian Obrolan

Fungsi inti disediakan melalui endpoint POST /v1/chat/completions. Endpoint ini menerima tubuh JSON yang berisi nama model, array pesan, dan parameter opsional. Ini mengembalikan objek JSON dengan teks yang dihasilkan, statistik penggunaan token, dan alasan selesai. Struktur ini kompatibel dengan SDK OpenAI resmi dan sebagian besar pustaka klien kompatibel OpenAI.

Anda tidak perlu menulis klien HTTP khusus jika Anda lebih suka menggunakan SDK. Namun, Anda harus memperbarui konfigurasi untuk mengarah ke Base URL kami. Contoh berikut menunjukkan permintaan penyelesaian standar menggunakan cURL. Permintaan ini mengirim prompt ke model tanpa sensor dan mengharapkan respons teks.

Salincurl https://api.openrouternsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Ingatlah bahwa API ini hanya melayani teks. Tidak ada endpoint embedding, gambar, audio, atau generasi video. Jika aplikasi Anda memerlukan input atau output multimodal, Anda harus menangani itu secara terpisah. Layanan kami berfokus secara eksklusif pada generasi teks berkualitas tinggi dengan model tanpa sensor.

Integrasi SDK Python

Menggunakan SDK Python menyederhanakan proses integrasi. Inisialisasi klien dengan Base URL yang benar dan kunci API Anda. Pustaka menangani permintaan HTTP dan parsing JSON untuk Anda. Anda dapat menentukan ID model sebagai uncensored untuk memastikan Anda menggunakan model khusus kami.

Salinfrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouternsfw.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Potongan kode ini menunjukkan cara mengirim pesan dan mengambil respons. Klien secara otomatis menangani koneksi dan pelaporan kesalahan. Jika server mengembalikan kesalahan, SDK melempar pengecualian. Anda harus menangani pengecualian ini dalam logika aplikasi Anda untuk memberikan pengalaman pengguna yang lebih baik.

SDK Python hanyalah salah satu opsi. Anda dapat menggunakan bahasa apa pun yang mendukung permintaan HTTP. Struktur endpoint tetap sama terlepas dari klien yang Anda pilih. Fleksibilitas ini memungkinkan Anda mengintegrasikan model tanpa sensor ke dalam alur kerja yang ada tanpa perubahan kode yang signifikan.

Penggunaan SDK Node

SDK Node bekerja mirip dengan versi Python. Konfigurasikan klien dengan Base URL dan kunci API, lalu panggil metode penyelesaian obrolan. Pendekatan ini ideal untuk aplikasi sisi server atau layanan backend yang perlu menghasilkan teks secara asinkron.

Salinimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouternsfw.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Pengembang Node.js dapat dengan mudah mengintegrasikan API ini ke proyek yang ada. SDK menangani serialisasi dan deserialisasi data JSON. Anda juga dapat menentukan parameter tambahan seperti temperature atau top_p untuk mengontrol keacakan output.

Pastikan untuk menangani sifat asinkron dari permintaan dengan benar. Gunakan async/await atau rantai Promise untuk mengelola data respons. Ini memastikan bahwa aplikasi Anda tetap responsif saat menunggu model menghasilkan teks. SDK Node adalah pilihan yang andal untuk membangun layanan generasi teks yang dapat diskalakan.

Respons Streaming

Aktifkan streaming dengan mengatur parameter stream menjadi true dalam permintaan Anda. Server akan mengirimkan serangkaian Server-Sent Events (SSE) alih-alih respons JSON tunggal. Setiap peristiwa berisi potongan teks yang dihasilkan secara parsial.

Salinstream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Streaming berguna untuk aplikasi real-time di mana Anda ingin menampilkan output saat dihasilkan. Potongan terakhir dari stream berisi total penggunaan token untuk permintaan tersebut. Ini memungkinkan Anda melacak biaya secara akurat tanpa menunggu seluruh respons selesai.

Tangani event stream dengan hati-hati untuk memastikan teks dirakit dengan benar. Gabungkan potongan-potongan tersebut sesuai urutan penerimaannya. Server menjamin bahwa potongan-potongan dikirim secara berurutan. Jika koneksi terputus, Anda mungkin perlu mencoba ulang permintaan tersebut. Streaming adalah fitur canggih yang meningkatkan pengalaman pengguna untuk tugas generasi teks.

Batas Laju dan Jendela Konteks

Setiap kunci API dibatasi hingga 300 permintaan per menit dan 8 permintaan konkuren. Ukuran tubuh permintaan dibatasi hingga 8 MB. Jika Anda melebihi batas ini, server mengembalikan kode status 429. Ini adalah kode status HTTP standar yang menunjukkan bahwa Anda telah mengirim terlalu banyak permintaan dalam jendela waktu tertentu. Anda harus menerapkan backoff eksponensial di klien Anda untuk menangani kesalahan ini dengan lancar.

Jendela konteks mendukung hingga 100,000 token untuk prompt dan penyelesaian gabungan. Tidak ada batas output terpisah. Jika Anda tidak menentukan parameter max_tokens, respons dapat berjalan hingga akhir jendela. Anda dapat membatasi panjang output dengan mengatur max_tokens ke nilai yang lebih rendah.

Pantau penggunaan token Anda untuk mengelola saldo prabayar Anda secara efektif. Kesalahan dan penolakan tidak mengonsumsi token, jadi Anda tidak dikenakan biaya untuk permintaan yang gagal. Ini memastikan bahwa Anda hanya membayar untuk generasi teks yang berhasil. Perhatikan batas laju Anda untuk menghindari gangguan dalam layanan Anda.