เอกสาร API สำหรับ Uncensored Chat Completions

เริ่มต้น: เชื่อมต่อใน Python หรือ JavaScript

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

เริ่มต้นด้วยการส่งคำขอ HTTP พื้นฐานเพื่อตรวจสอบการเชื่อมต่อ ใช้คำสั่ง curl ด้านล่างเพื่อส่งคำขอพื้นฐานไปยัง uncensored โมเดล แทนที่ YOUR_API_KEY ด้วยคีย์ที่สร้างบนแดชบอร์ดของคุณ

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

สำหรับนักพัฒนา Python กระบวนการจะคล้ายกันมาก เริ่มต้น client ด้วย key และ base URL ที่ถูกต้อง สิ่งนี้ทำให้แน่ใจว่าคำขอทั้งหมดจะถูกกำหนดเส้นทางผ่านเซิร์ฟเวอร์แบบไม่มีตัวกรองของเรา ในขณะที่รักษาความเข้ากันได้กับเครื่องมือที่มีอยู่

Copyfrom openai import OpenAI

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

ผู้ใช้ JavaScript สามารถบรรลุผลลัพธ์เดียวกันโดยใช้ Node SDK ตั้งค่า baseURL property ไปยังเอนด์พอยต์ของเรา วิธีนี้ช่วยให้คุณผสานรวม API เข้ากับเว็บเซิร์ฟเวอร์หรือบริการแบ็กเอนด์ด้วยการเปลี่ยนแปลงโค้ดเพียงเล็กน้อย

Copyimport OpenAI from "openai";

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

Authentication and API Key management

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

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

ใช้คีย์ในการเรียกใช้งานของคุณดังนี้: Authorization: Bearer YOUR_API_KEY. รูปแบบส่วนหัวมาตรฐานนี้ทำงานกับ SDK หลักๆ ทั้งหมด เก็บคีย์ของคุณให้พร้อมสำหรับการทำซ้ำอย่างรวดเร็วระหว่างการพัฒนา

พารามิเตอร์จุดจบ API Chat Completions

ส่งคำขอไปยัง /v1/chat/completions endpoint. endpoint. รวมอาร์เรย์ข้อความของคุณและตั้งค่าโมเดลเป็น uncensored. คุณสามารถปรับพารามิเตอร์เช่น temperature และ top_p เพื่อควบคุมความสร้างสรรค์ ค่าที่สูงกว่าจะสร้างการตอบกลับที่มีความหลากหลายมากขึ้น

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

ใช้ stop พารามิเตอร์เพื่อหยุดการสร้างที่วลีเฉพาะ ซึ่งช่วยบังคับใช้โครงสร้างบทสนทนา seed parameter ensures reproducible outputs for testing. These tools give you precise control over the model's behavior.

ข้อมูลการใช้งานและการตอบกลับแบบสตรีม

เปิดใช้งานการสตรีมโดยตั้งค่า stream: true ในการร้องขอของคุณ API จะส่งชิ้นส่วนของข้อความทันทีที่สร้างขึ้น ซึ่งช่วยลดความล่าช้าที่รับรู้สำหรับผู้ใช้ปลายทาง แต่ละชิ้นประกอบด้วยข้อความบางส่วนและข้อมูลเมตา

ข้อมูลการใช้งานจะปรากฏใน chunk สุดท้าย ซึ่งรวมถึงจำนวนโทเค็นอินพุตและเอาต์พุต ตรวจสอบ usage field in the last response object. This allows accurate billing verification without separate API calls. Track token consumption in real-time.

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

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)

การจัดการข้อผิดพลาดและขีดจำกัดอัตรา

API กำหนดอัตราสูงสุด 300 คำขอต่อนาทีต่อ key คำขอพร้อมกันได้สูงสุดแปดคำขอต่อ key ขนาด body ของคำขอต้องไม่เกิน 8 MB หากเกินขีดจำกัดเหล่านี้จะเกิด error 429 ใช้ exponential backoff เพื่อจัดการกับยอดที่สูงขึ้นชั่วคราว

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

ตรวจสอบ body ของ response สำหรับข้อความแสดงข้อผิดพลาดโดยละเอียด API จะส่งคืน object JSON ที่มีประเภทข้อผิดพลาดและข้อความ ใช้ข้อมูลนี้เพื่อแก้ไขข้อบกพร่องอย่างรวดเร็ว การจัดการข้อผิดพลาดที่เหมาะสมรับประกันประสบการณ์ที่ราบรื่นสำหรับผู้ใช้ของคุณในช่วงเวลาที่มีผู้เข้าชมจำนวนมาก

คู่มือโหมด JSON และการเรียกใช้ฟังก์ชัน

ใช้โหมด JSON โดยตั้งค่า response_format เพื่อ {"type": "json_object"}. สิ่งนี้บังคับให้โมเดลเอาต์พุต JSON ที่ถูกต้อง เหมาะสำหรับการแยกสกัดข้อมูลที่มีโครงสร้างหรือการตอบกลับ API โปรดระบุคำอธิบายแผนผังที่ต้องการในพรอมต์ของคุณให้ชัดเจน

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

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

รายละเอียดโมเดลและข้อจำกัดหน้าต่างบริบท

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

โมเดลนี้เป็น open-weight และปรับแต่งสำหรับเนื้อหาที่ไม่จำกัด มันไม่ปฏิเสธหัวข้อผู้ใหญ่ที่ถูกต้องตามกฎหมาย ไม่ใช่ GPT, Claude หรือโมเดลของเจ้าอื่น คำขอถูกประมวลผลบนเซิร์ฟเวอร์เฉพาะของเรา สิ่งนี้รับประกันประสิทธิภาพที่สม่ำเสมอและ latency ต่ำ

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