API Quickstart

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

เริ่มต้นโดยชี้ client ของคุณไปยัง base URL ของเราและส่ง key ของคุณใน header เราใช้มาตรฐาน Authorization ดังนั้น SDK ของ OpenAI หรือ client ที่เข้ากันได้ใดๆ จะทำงานได้ทันที คุณไม่จำเป็นต้องจัดการ flow OAuth ที่ซับซ้อนหรือรอการอนุมัติ เพียงสมัครสมาชิกด้วย Google หรืออีเมล คัดลอก key แล้วคุณก็พร้อมใช้งาน endpoint คือ https://api.aiohnezensur.com/v1 และยอมรับ Authorization: Bearer YOUR_API_KEY header ในทุกคำขอ

การส่งคำขอครั้งแรกของคุณ

ส่งคำขอ chat completion ง่ายๆ เพื่อทดสอบโมเดล uncensored คำขอนี้ส่ง prompt และรับข้อความตอบกลับโดยไม่มี guardrails แบบองค์กรทั่วไป คุณสามารถใช้เครื่องมือใดๆ ที่รองรับโปรโตคอล OpenAI แต่การเรียกใช้ curl โดยตรงจะแสดงให้เห็นสิ่งที่เกิดขึ้นภายใต้พื้นผิวแทน YOUR_API_KEY พร้อมคีย์จริงของคุณจากแดชบอร์ด

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

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

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

ใช้แพ็กเกจ Python ทางการของ OpenAI เพื่อโต้ตอบกับ API ของเราอย่างราบรื่น ตั้งค่า base URL ให้ชี้ไปที่ endpoint ของเราและระบุ key ของคุณเป็น API token สิ่งนี้ช่วยให้คุณใช้ประโยชน์จาก codebases ที่มีอยู่โดยไม่ต้องเขียนตรรกะ HTTP ใหม่ ID ของโมเดลคือ uncensored, ซึ่งเรียกใช้โมเดลภาษาขนาดใหญ่เฉพาะของเราที่ปรับแต่งสำหรับเอาต์พุตไร้ข้อจำกัด

Copyfrom openai import OpenAI

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

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

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

ผสาน API เข้ากับแอปพลิเคชัน JavaScript หรือ TypeScript ของคุณโดยใช้ Node SDK กำหนดค่า base URL และ API key เหมือนกับตัวอย่าง Python วิธีการนี้ทำงานได้ดีสำหรับการเรนเดอร์ฝั่งเซิร์ฟเวอร์หรือไมโครเซอร์วิสแบ็กเอนด์ SDK ห่อหุ้มชั้นเครือข่าย ทำให้คุณสามารถมุ่งเน้นไปที่ลอจิก prompt

Copyimport OpenAI from "openai";

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

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

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

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

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)

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

อัตราจำกัดและข้อจำกัด

ทำความเข้าใจขีดจำกัดทางเทคนิคเพื่อป้องกันความล้มเหลวของคำขอในสภาพแวดล้อมการผลิต คุณได้รับอนุญาตให้ส่งคำขอได้ 300 คำขอต่อนาทีต่อคีย์ และสามารถส่งคำขอพร้อมกันได้ 8 คำขอ ขนาดของ body ในคำขอต้องไม่เกิน 8 MB หากเกินขีดจำกัดเหล่านี้ API จะส่งรหัสสถานะ 429 กลับมา คุณควรใช้การเพิ่มค่าหน่วงแบบเอกซ์โพเนนเชียล (exponential backoff) ในไคลเอนต์ของคุณเพื่อจัดการกับเหตุการณ์ดังกล่าวได้อย่างราบรื่น หน้าต่างบริกลมีขนาด 100,000 token โดยรวม พร้อม output สูงสุด 16,000 token ต่อคำขอ ข้อผิดพลาดและการปฏิเสธไม่ใช้เครดิต ดังนั้นคุณสามารถลองใหม่ได้อย่างปลอดภัย ข้อผิดพลาดในการตรวจสอบสิทธิ์จะส่ง 401 และเงินไม่เพียงพอจะส่ง 402