Dokumentasi API

URL Dasar dan Autentikasi

Titik akhir API berada di https://api.openrouteraiapi.com/v1. Luluskan kunci API Anda di Authorization header sebagai token bearer. Header ini adalah satu-satunya perubahan yang diperlukan untuk mengalihkan lalu lintas dari penyedia Anda saat ini ke model uncensored kami.

Autentikasi ketat. Jika kunci hilang atau tidak valid, server segera mengembalikan error 401. Anda bisa membuat kunci secara instan melalui Google atau email di dasbor. Simpan kunci dengan aman, karena kunci ini memberikan akses ke kredit prabayar Anda.

Endpoint Chat Completions

Kirim permintaan POST ke /v1/chat/completions dengan array pesan. Pengenal model adalah uncensored. Model tunggal ini menangani semua kebutuhan generasi teks Anda tanpa logika pengalihan yang kompleks.

Berikut permintaan standar menggunakan cURL untuk memverifikasi konektivitas dan format respons.

Copycurl https://api.openrouteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
  }'

Respons mencakup teks yang dihasilkan di choices[0].message.content bidang. Anda dapat menguraikannya langsung ke dalam alur kerja aplikasi Anda.

Integrasi SDK Python

Gunakan klien Python OpenAI resmi untuk terhubung dengan mudah. Atur base_url dan api_key variabel untuk mengarah ke infrastruktur kami. Pendekatan ini meminimalkan perubahan kode saat beralih penyedia.

Copyfrom openai import OpenAI

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

Klien menangani serialisasi dan percobaan ulang secara otomatis. Anda menerima objek penyelesaian yang berisi teks dan statistik penggunaan token. Metode ini ideal untuk layanan backend dan skrip.

Penggunaan SDK Node.js

Inisialisasi klien Node.js OpenAI dengan URL dasar kustom Anda. Ini memungkinkan aplikasi JavaScript berinteraksi dengan model uncensored menggunakan metode yang akrab. SDK mengelola permintaan HTTP secara efisien.

Copyimport OpenAI from "openai";

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

Panggil chat.completions.create() dengan pesan Anda. Objek respons menyediakan akses ke konten yang dihasilkan dan data penggunaan. Integrasi ini bekerja dengan baik untuk server web dan fungsi tepi.

Respons Streaming

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. server mengembalikan Server-Sent Events (SSE) untuk pengiriman token secara real-time. Fitur ini mengurangi latensi yang dirasakan bagi pengguna akhir.

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)

Setiap chunk berisi konten parsial. Chunk terakhir mencakup statistik penggunaan token lengkap. Tangani peristiwa ini di klien Anda untuk memperbarui UI secara inkremental.

Batas, Error, dan Jendela Konteks

Jendela konteks mendukung 100.000 token untuk input dan output gabungan. Setiap permintaan dapat menghasilkan hingga 16.000 token, atau 2.048 jika max_tokens tidak diatur. Batas laju mengizinkan 300 permintaan per menit per kunci.

Kesalahan adalah kode HTTP standar. 401 menunjukkan kunci tidak valid. 402 berarti kredit prabayar Anda telah habis. 429 menandakan bahwa Anda telah melebihi batas laju. Permintaan yang gagal tidak mengonsumsi kredit. Kesalahan gratis.