Kunci API OpenRouter: Panduan Mulai Cepat

URL Dasar & Autentikasi

Kunci API Anda mengautentikasi setiap permintaan ke endpoint kami. Gunakan base URL https://api.openrouteraikeys.com/v1 dan masukkan kunci Anda di Authorization header. Konfigurasi ini kompatibel dengan SDK OpenAI apa pun karena kami meniru pola autentikasi standar mereka. Anda tidak perlu memodifikasi pustaka klien, hanya konfigurasi URL dasar.

• Header: Authorization: Bearer YOUR_API_KEY
• URL Dasar: https://api.openrouteraikeys.com/v1

Permintaan Pertama

Kirimkan permintaan completion chat standar untuk menguji konektivitas dan format respons. ID modelnya adalah uncensored dan itu menerima array pesan standar. Titik akhir ini hanya mengembalikan teks, jadi jangan mengharapkan data gambar atau audio dalam payload respons.

Copycurl https://api.openrouteraikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this documentation page"}]
  }'

Integrasi SDK Python

Inisialisasi klien dengan kunci Anda dan URL dasar kustom. Ini memungkinkan Anda menggunakan chat.completions.create metode tanpa membungkus logika tambahan. Perpustakaan menangani serialisasi dan logika percobaan ulang secara otomatis untuk Anda.

Copyfrom openai import OpenAI

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

Integrasi SDK Node

Konfigurasi OPENAI_API_KEY dan OPENAI_BASE_URL variabel lingkungan atau meneruskannya langsung ke konstruktor klien. Ini memastikan semua panggilan berikutnya dialihkan melalui endpoint tidak disensor kami. Anda dapat terus menggunakan versi SDK yang sudah Anda instal.

Copyimport OpenAI from "openai";

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

Respons Streaming

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengembalikan potongan Server-Sent Events (SSE) saat model menghasilkan teks. Statistik penggunaan token muncul di potongan terakhir aliran, memungkinkan Anda melacak biaya secara real-time tanpa menunggu respons penuh.

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)

Batas, Error & Konteks

Jendela konteks mendukung total 100.000 token untuk prompt dan completion. Anda dibatasi hingga 300 permintaan per menit per kunci. Error 401 berarti kunci API Anda tidak valid atau hilang. Error 402 menunjukkan kredit prabayar tidak cukup. Error 429 menandakan Anda telah melebihi batas laju. Penolakan karena kebijakan konten bersifat gratis, tetapi error komputasi dapat mengonsumsi token.