เอกสาร API & เริ่มต้นอย่างรวดเร็ว

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

เริ่มด้วยการตั้งค่า URL ฐานเป็น HTTPS://api.uncensoredal.com/v1 และส่งคีย์ API ของคุณในเฮดเดอร์ Authorization คุณได้รับคีย์ที่ใช้งานหนึ่งต่อบัญชี และการสร้างคีย์ใหม่จะยกเลิกคีย์ก่อนหน้าทันที การตั้งค่าง่ายๆ นี้ทำงานกับไคลเอนต์ที่เข้ากันได้กับ OpenAI มาตรฐานใดก็ได้โดยไม่ต้องมีลอจิกการกำหนดเส้นทางที่ซับซ้อน

Copycurl https://api.uncensoredal.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate the next 50 lines of a python script"}]
  }'

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

จุดจบ API Chat Completions

ส่งคำขอ POST ไปยัง /v1/chat/completions พร้อมประวัติข้อความของคุณในอาร์เรย์ messages ระบบประมวลผลข้อความป้อนกลับและส่งข้อความที่สร้างโดยไม่มีการปฏิเสธเนื้อหาสำหรับการใช้งานผู้ใหญ่ที่ถูกต้องกฎหมาย คุณต้องระบุโมเดลเป็น "uncensored" ใน payload เพื่อให้แน่ใจว่าเข้ากันได้

Copyfrom openai import OpenAI

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

คำขอคิดค่าตามการใช้โทเค็นจริง โดยข้อผิดพลาดและการปฏิเสธจะไม่เสียค่าใช้จ่าย โมเดลแบบเติมเงินนี้หมายความว่าคุณจ่ายเฉพาะสิ่งที่ใช้จริง จุดปลาย (endpoint) รองรับพารามิเตอร์มาตรฐานเช่น temperature และ top_p เพื่อควบคุมความสุ่มของผลลัพธ์

การตอบกลับแบบสตรีมมิ่งด้วย SSE

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

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 ส่งเหตุการณ์สตรีมที่เข้ากันได้กับ OpenAI มาตรฐาน ทำให้การผสานรวมกับไลบรารี UI ที่มีอยู่ทำได้ง่าย คุณสามารถหยุดสตรีมล่วงหน้าได้หากผู้ใช้เปลี่ยนอินพุต

Function Calling และโหมด JSON

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

Copyimport OpenAI from "openai";

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

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

การกำหนดค่าพารามิเตอร์โมเดล

กำหนดค่าพารามิเตอร์เช่น temperature, top_p, ลำดับ stop และ seed เพื่อควบคุมพฤติกรรมการสร้างข้อมูล หน้าต่างบริกรองรับ 100,000 token สำหรับ prompt และการตอบกลับรวมกัน ผลลัพธ์สูงสุดถูกจำกัดไว้ที่ 16,000 token ต่อคำขอ หรือ 2,048 หากคุณไม่ได้ระบุ max_tokens

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

ข้อจำกัด, ข้อผิดพลาด และบริบท

อัตราจำกัดการเรียกข้อมูลอยู่ที่ 300 ครั้งต่อนาทีและ 8 การเรียกพร้อมกันต่อคีย์ ร่างการร้องขอถูกจำกัดไว้ที่ 8 MB ดังนั้นจึงต้องจัดการหน้าต่างบริบทขนาดใหญ่อย่างระมัดระวัง ข้อผิดพลาดรวมถึง 401 สำหรับคีย์ที่ไม่ถูกต้อง 402 สำหรับเครดิตไม่เพียงพอ และ 429 สำหรับอัตราจำกัด

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