URL ฐานและการตรวจสอบสิทธิ์
API ของเราเข้ากันได้กับ OpenAI อย่างสมบูรณ์ หมายความว่าคุณสามารถใช้ SDK มาตรฐานใดๆ ได้ด้วยการเปลี่ยนแปลงเพียงเล็กน้อย URL ฐานสำหรับคำขอทั้งหมดคือ https://api.openrouterapi.top/v1 การตรวจสอบสิทธิ์ดำเนินการผ่านโทเคน Bearer ที่ส่งในหัว Authorization คุณสามารถสร้างคีย์นี้ได้อย่างรวดเร็วโดยการสมัครสมาชิกด้วย Google หรือที่อยู่อีเมลบนแดชบอร์ดของเรา เก็บคีย์ของคุณให้ปลอดภัย เนื่องจากคีย์นี้ให้สิทธิ์เข้าถึงเครดิตแบบเติมเงินล่วงหน้าของคุณโดยตรง
คำขอแรก
ทดสอบเอนด์พอยต์ด้วยคำสั่ง curl อย่างง่าย แทนที่ YOUR_API_KEY ด้วยคีย์จริงของคุณ ID ของโมเดลถูกตั้งค่าเป็น uncensored เพื่อข้ามการปฏิเสธเนื้อหามาตรฐาน คำขอนี้ส่งพรอมต์และรอรับคำตอบทั้งหมด
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."}]
}'
หากคีย์ไม่ถูกต้อง คุณจะได้รับข้อผิดพลาด 401 หากยอดเครดิตแบบเติมเงินล่วงหน้าของคุณหมดลง คุณจะได้รับข้อผิดพลาด 402 ข้อผิดพลาดเหล่านี้ไม่ใช้ยอดโทเคนของคุณ แต่จะนับรวมในโควตาขีดจำกัดอัตราของคุณ
การผสาน SDK Python
การใช้แพ็กเกจ Python openai นั้นตรงไปตรงมา เริ่มต้นไคลเอนต์ด้วย URL ฐานและคีย์ของคุณ SDK จัดการการแปลงข้อมูล JSON โดยอัตโนมัติ ตัวอย่างนี้แสดงคำขอ chat completion พื้นฐาน
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)
ตรวจสอบให้แน่ใจว่าคุณได้ติดตั้งเวอร์ชันล่าสุดของ SDK แล้ว วัตถุไคลเอนต์จัดการพูลการเชื่อมต่อ ดังนั้นคุณสามารถนำกลับมาใช้ใหม่สำหรับคำขอหลายครั้งโดยไม่ต้องเริ่มต้นใหม่
การผสาน SDK Node
สำหรับสภาพแวดล้อม JavaScript SDK Node ทำงานเหมือนกัน ส่ง URL ฐานที่กำหนดเองระหว่างการเริ่มต้น วิธีการนี้ช่วยให้คุณผสานการสร้างข้อความแบบไม่เซ็นเซอร์เข้ากับเว็บแอปพลิเคชันหรือบริการแบ็กเอนด์ที่มีอยู่ได้อย่างราบรื่น
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 รองรับทั้งรูปแบบ promise-based และ async/await การจัดการข้อผิดพลาดสอดคล้องกับบริการที่เข้ากันได้กับ OpenAI อื่นๆ
Streaming Responses
เปิดใช้งาน streaming โดยตั้งค่า stream: true ในคำขอของคุณ API ส่งคืน Server-Sent Events (SSE) แต่ละ chunk มีข้อความบางส่วน chunk สุดท้ายรวมถึงสถิติการใช้งานโทเคนสำหรับการคิดเงิน
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)
เครดิตแบบเติมเงินล่วงหน้าจะถูกเรียกเก็บตามโทเคนจริงที่สร้างในผลลัพธ์สุดท้าย Streaming ไม่เปลี่ยนโมเดลการคิดเงิน; คุณจ่ายสำหรับโทเคนที่ส่งสำเร็จ
ขีดจำกัดอัตราและหน้าต่างบริบท
คีย์ API แต่ละคีย์จำกัดอยู่ที่ 300 คำขอต่อนาทีและ 8 คำขอพร้อมกัน ขนาดสูงสุดของ body คำขอคือ 8 MB หน้าต่างบริบทรองรับโทเคนสูงสุด 100,000 โทเคนรวม (input บวก output) ผลลัพธ์สูงสุดต่อคำขอคือ 32,000 โทเคน หรือ 2,048 หาก max_tokens ไม่ได้ถูกตั้งค่า ข้อผิดพลาดเช่น 401 หรือ 402 ไม่ใช้เครดิต แต่จะนับรวมในขีดจำกัดอัตราของคุณ การปฏิเสธสำหรับประเภทเนื้อหาเฉพาะก็ฟรีเช่นกัน