เอกสาร API

URL ฐานและการตรวจสอบสิทธิ์

จุดสิ้นสุดของ API อยู่ที่ https://api.openrouteraiapi.com/v1. ส่งคีย์ API ของคุณใน Authorization header เป็น bearer token การเปลี่ยนแปลงเพียงอย่างเดียวที่ต้องทำคือเปลี่ยน header นี้เพื่อเปลี่ยนเส้นทางปริมาณการจราจรจากผู้ให้บริการปัจจุบันของคุณไปยังโมเดล uncensored ของเรา

การตรวจสอบสิทธิ์นั้นเข้มงวด หากคีย์หายไปหรือไม่ถูกต้อง เซิร์ฟเวอร์จะส่งข้อผิดพลาด 401 ทันที คุณสามารถสร้างคีย์ได้ทันทีผ่าน Google หรืออีเมลบนแดชบอร์ด เก็บคีย์ให้ปลอดภัย เนื่องจากมันให้สิทธิ์ในการเข้าถึงเครดิตที่ชำระล่วงหน้าของคุณ

จุดจบ API Chat Completions

ส่งคำขอ POST ไปยัง /v1/chat/completions พร้อมอาร์เรย์ข้อความ ตัวระบุโมเดลคือ uncensored. โมเดลเดียวนี้จัดการความต้องการการสร้างข้อความทั้งหมดของคุณโดยไม่จำเป็นต้องใช้ตรรกะการเปลี่ยนเส้นทางที่ซับซ้อน

นี่คือคำขอมาตรฐานที่ใช้ cURL เพื่อตรวจสอบการเชื่อมต่อและรูปแบบการตอบกลับ

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"}]
  }'

การตอบสนองรวมถึงข้อความที่สร้างขึ้นมาใน choices[0].message.content ช่อง คุณสามารถแยกข้อมูลนี้เป็นโมดูลโดยตรงเข้าสู่เวิร์กโฟลว์แอปพลิเคชันของคุณ

การผสานรวม SDK Python

ใช้ Python client ทางการของ OpenAI เพื่อเชื่อมต่ออย่างง่ายดาย ตั้งค่า base_url และ api_key ตัวแปรเพื่อชี้ไปยังโครงสร้างพื้นฐานของเรา วิธีนี้ลดการเปลี่ยนแปลงโค้ดให้น้อยที่สุดเมื่อเปลี่ยนผู้ให้บริการ

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)

ไคลเอนต์จัดการการแปลงข้อมูลและการลองใหม่เป็นอัตโนมัติ คุณจะได้รับออบเจกต์ผลลัพธ์ที่มีข้อความและสถิติการใช้โทเค็น วิธีนี้เหมาะสำหรับบริการแบ็กเอนด์และสคริปต์

การใช้งาน SDK Node.js

เริ่มต้นใช้งาน OpenAI Node.js client ด้วย custom base URL ของคุณ สิ่งนี้ทำให้แอปพลิเคชัน JavaScript สามารถทำงานร่วมกับโมเดล uncensored ได้โดยใช้วิธีการที่คุ้นเคย SDK จัดการ HTTP requests อย่างมีประสิทธิภาพ

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);

เรียก chat.completions.create() พร้อมข้อความของคุณ วัตถุการตอบสนองให้การเข้าถึงเนื้อหาที่สร้างเสร็จแล้วและข้อมูลการใช้งาน การผสานรวมนี้ทำงานได้ดีสำหรับเว็บเซิร์ฟเวอร์และฟังก์ชันขอบ

การตอบกลับแบบสตรีมมิ่ง

เปิดใช้งานการสตรีมโดยตั้งค่า stream: true ในการร้องขอของคุณ เซิร์ฟเวอร์ส่ง Server-Sent Events (SSE) เพื่อส่งโทเค็นแบบเรียลไทม์ คุณสมบัตินี้ลดความล่าช้าที่ผู้ใช้ปลายทางรู้สึก

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)

แต่ละชิ้นส่วนประกอบด้วยเนื้อหาบางส่วน ชิ้นส่วนสุดท้ายรวมถึงสถิติการใช้งานโทเค็นทั้งหมด จัดการเหตุการณ์เหล่านี้ในไคลเอนต์ของคุณเพื่ออัปเดต UI แบบเพิ่มทีละน้อย

ข้อจำกัด, ข้อผิดพลาด และหน้าต่างบริบท

หน้าต่างบริบทรองรับ 100,000 tokens สำหรับข้อมูลนำเข้าและผลลัพธ์รวมกัน แต่ละการเรียกใช้สามารถสร้างผลลัพธ์ได้สูงสุด 16,000 tokens หรือ 2,048 หาก max_tokens ยังไม่กำหนด ขีดจำกัดอัตราส่วนอนุญาตให้ส่ง 300 คำขอต่อนาทีต่อคีย์

ข้อผิดพลาดเป็นรหัส HTTP มาตรฐาน รหัส 401 บ่งชี้ว่าคีย์ไม่ถูกต้อง รหัส 402 หมายถึงเครดิตแบบเติมเงินของคุณหมดแล้ว รหัส 429 แจ้งว่าคุณเกินอัตราจำกัดแล้ว คำขอที่ล้มเหลวจะไม่ใช้เครดิต ข้อผิดพลาดฟรี