URL Dasar dan Autentikasi
API kami sepenuhnya kompatibel dengan OpenAI, artinya Anda dapat menggunakan SDK standar apa pun dengan perubahan minimal. URL dasar untuk semua permintaan adalah https://api.openrouterapi.top/v1. Autentikasi ditangani melalui token Bearer yang diteruskan dalam header Authorization. Anda dapat menghasilkan kunci ini secara instan dengan mendaftar menggunakan Google atau alamat email di dasbor kami. Jaga kunci Anda agar aman, karena kunci ini memberikan akses langsung ke saldo prabayar Anda.
Permintaan Pertama
Uji endpoint dengan perintah curl sederhana. Ganti YOUR_API_KEY dengan kunci Anda yang sebenarnya. ID model diatur ke uncensored untuk melewati penolakan konten standar. Permintaan ini mengirim prompt dan menunggu respons lengkap.
curl https://api.openrouterapi.top/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."}]
}'Jika kunci tidak valid, Anda menerima kesalahan 401. Jika saldo prabayar Anda habis, Anda menerima kesalahan 402. Kesalahan ini tidak menguras saldo token Anda, tetapi mereka tetap dihitung dalam kuota batas laju Anda.
Integrasi SDK Python
Menggunakan paket Python openai resmi sangat mudah. Inisialisasi klien dengan URL dasar dan kunci Anda. SDK menangani serialisasi JSON secara otomatis. Contoh ini menunjukkan permintaan penyelesaian obrolan dasar.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterapi.top/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)Pastikan Anda telah menginstal versi terbaru SDK. Objek klien mengelola kumpulan koneksi, sehingga Anda dapat menggunakannya kembali untuk beberapa permintaan tanpa menginisialisasi ulang.
Integrasi SDK Node
Untuk lingkungan JavaScript, SDK Node bekerja secara identik. Masukkan URL dasar kustom selama inisialisasi. Pendekatan ini memungkinkan Anda mengintegrasikan generasi tanpa sensor ke dalam aplikasi web atau layanan backend yang ada dengan mulus.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterapi.top/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);SDK Node mendukung pola berbasis promise dan async/await. Penanganan kesalahan konsisten dengan layanan kompatibel OpenAI lainnya.
Respons Streaming
Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengembalikan Server-Sent Events (SSE). Setiap chunk berisi teks parsial. Chunk terakhir mencakup statistik penggunaan token untuk penagihan.
stream = 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)Saldo prabayar dibebankan berdasarkan token aktual yang dihasilkan dalam output akhir. Streaming tidak mengubah model harga; Anda membayar untuk token yang berhasil dikirim.
Batas Laju dan Jendela Konteks
Setiap kunci API dibatasi hingga 300 permintaan per menit dan 8 permintaan konkuren. Ukuran badan permintaan maksimum adalah 8 MB. Jendela konteks mendukung hingga 100.000 token total (input ditambah output). Output maksimum per permintaan adalah 32.000 token, atau 2.048 jika max_tokens tidak diatur. Kesalahan seperti 401 atau 402 tidak mengonsumsi saldo, tetapi tetap dihitung dalam batas laju Anda. Penolakan untuk jenis konten tertentu juga gratis.
