Panduan cepat untuk pengguna OpenRouter

Instalasi & Pengaturan

API kami sepenuhnya kompatibel dengan SDK OpenAI standar. Untuk beralih dari OpenRouter, Anda hanya perlu memperbarui dua nilai konfigurasi: base_url dan api_key. Arahkan klien Anda ke https://api.openrouterapi.cc/v1 dan gunakan kunci yang dibuat di dasbor kami. Tidak diperlukan header kustom atau logika routing yang kompleks. ID model yang diminta adalah uncensored.

Pastikan versi SDK Anda mendukung parameter base_url. Jika Anda menggunakan klien HTTP mentah, cukup perbarui URL target. Pengaturan ini memastikan kode klien Anda yang ada berfungsi tanpa modifikasi, asalkan Anda hanya mengirim permintaan penyelesaian teks.

Autentikasi

Autentikasi ditangani melalui header Authorization standar. Berikan kunci API Anda sebagai token Bearer. Jika kunci tidak valid atau kedaluwarsa, API mengembalikan kesalahan 401. Berbeda dengan beberapa penyedia, kami tidak membebani biaya untuk permintaan yang gagal; kesalahan dan penolakan gratis, sehingga Anda dapat menguji autentikasi tanpa menghabiskan saldo.

Setiap akun mendukung satu kunci aktif pada satu waktu. Membuat kunci baru akan segera membuat kunci sebelumnya tidak valid. Jaga kunci Anda tetap aman dan ganti jika Anda menduga terjadi kebocoran. Kunci ditampilkan segera setelah pendaftaran, jadi salin sebelum meninggalkan halaman.

Penyelesaian Obrolan Dasar

Fungsi inti adalah endpoint POST /v1/chat/completions. Kirim prompt Anda sebagai daftar pesan dan terima respons teks. Model ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, sehingga cocok untuk topik kreatif, kontroversial, atau penelitian keamanan.

Atur bidang model menjadi uncensored. Anda dapat mengendalikan perilaku menggunakan parameter seperti temperature, top_p, dan stop. API mendukung mode JSON melalui response_format dan pemanggilan fungsi melalui tools. Semua permintaan diproses secara asinkron, dan Anda menerima penyelesaian lengkap setelah model selesai.

Respons Streaming

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengembalikan Event yang Diserahkan Server (SSE) dengan respons parsial. Anda menerima potongan teks saat dihasilkan, memungkinkan tampilan waktu nyata di aplikasi Anda.

Informasi penggunaan token disediakan dalam potongan terakhir aliran. Ini memungkinkan Anda melacak biaya secara akurat tanpa mengurai setiap token individu. Streaming sangat ideal untuk antarmuka obrolan di mana latensi sangat penting. Pastikan klien Anda menangani SSE dengan benar dan menutup koneksi saat aliran berakhir.

Pemanggilan Fungsi

API mendukung pemanggilan fungsi melalui parameter tools. Tentukan fungsi Anda dalam larik tools dan atur tool_choice menjadi auto atau nama fungsi tertentu. Model akan mengembalikan argumen JSON terstruktur jika fungsi dipicu.

Fitur ini berguna untuk mengintegrasikan LLM dengan API atau basis data eksternal. Pastikan definisi fungsi Anda akurat, karena model bergantung pada mereka untuk menghasilkan argumen yang valid. API tidak mengeksekusi fungsi; Anda harus menangani logika eksekusi dalam kode aplikasi Anda.

Mode JSON

Untuk output terstruktur, gunakan response_format: {"type": "json_object"}. Ini memaksa model untuk mengembalikan JSON yang valid, yang penting untuk mengurai data di aplikasi hilir. Mode JSON sering lebih andal daripada pemanggilan fungsi untuk tugas ekstraksi data sederhana.

Pastikan prompt Anda secara jelas menginstruksikan model untuk mengembalikan JSON. Respons JSON yang tidak valid dapat terjadi jika prompt ambigu. Mode JSON didukung dalam mode standar dan streaming. Gunakan saat Anda memerlukan output yang dapat diprediksi dan dapat dibaca mesin.

Batas, Kesalahan, dan Konteks

Jendela konteks adalah 100.000 token untuk prompt dan penyelesaian gabungan. Output maksimum adalah 32.000 token per permintaan (2.048 jika max_tokens tidak diatur). Batas laju adalah 300 permintaan per menit dan 8 permintaan paralel per kunci. Badan permintaan dibatasi hingga 8 MB.

Kesalahan mengembalikan kode HTTP standar: 401 untuk kunci tidak valid, 402 untuk saldo tidak cukup, dan 429 untuk batas laju. Saldo adalah saldo prabayar, sehingga kesalahan 402 berarti Anda perlu mengisi saldo. Kesalahan dan penolakan gratis, sehingga Anda dapat mencoba lagi tanpa biaya. Batas konten keras memblokir konten seksual yang melibatkan anak di bawah umur.

cURL

Copycurl https://api.openrouterapi.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouterapi.cc/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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouterapi.cc/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);

Streaming

Copystream = 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)