Kunci ai OpenRouter: Panduan Permulaan Pantas

URL Asas & Pengesahan

Kunci API anda mengesahkan setiap permintaan ke hujung (endpoint) kami. Gunakan URL asas https://api.openrouteraikeys.com/v1 dan hantar kunci anda dalam Authorization header. Tetapan ini berfungsi dengan mana-mana SDK serasi OpenAI kerana kami meniru corak pengesahan standard mereka. Anda tidak perlu mengubah perpustakaan klien anda, hanya konfigurasi URL asas.

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

Permintaan Pertama

Hantar permintaan penyelesaian chat standard untuk menguji sambungan dan format respons. ID model ialah uncensored dan ia menerima array mesej piawai. Titik akhir ini hanya mengembalikan teks, jadi jangan jangka data imej 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

Mulakan klien dengan kunci anda dan URL asas tersuai. Ini membolehkan anda menggunakan chat.completions.create kaedah tanpa membungkus logik tambahan. Perpustakaan mengendalikan serialisasi dan logik percubaan semula secara automatik 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 pembolehubah persekitaran atau hantar secara langsung kepada konstruktor klien. Ini memastikan semua panggilan seterusnya disalurkan melalui endpoint tidak disensor kami. Anda boleh terus menggunakan versi SDK yang sama yang telah dipasang.

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 aliran dengan menetapkan stream: true dalam permintaan anda. API mengembalikan potongan Acara Dihantar Pelayan (SSE) semasa model menjana teks. Statistik penggunaan token muncul dalam potongan akhir aliran, membolehkan anda menjejaki kos secara masa nyata 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)

Had, Ralat & Konteks

Jendela konteks menyokong jumlah 100,000 token untuk prompt dan penyelesaian. Anda terhad kepada 300 permintaan setiap minit per kunci. Ralat 401 bermaksud kunci API anda tidak sah atau tiada. Ralat 402 menunjukkan kredit pra-dibayar tidak mencukupi. Ralat 429 menandakan anda telah melebihi had kadar. Penolakan akibat dasar kandungan adalah percuma, tetapi ralat pengiraan mungkin menggunakan token.