คู่มือ API Quickstart

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

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

Copycurl https://api.modelsaiuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all available endpoint urls"}]
  }'

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

จุดจบ API Chat Completions

ส่งข้อความไปยังโมเดล "uncensored" ผ่านจุดจบมาตรฐานของ chat completions ปลายทางนี้จัดการการโต้ตอบแบบข้อความเข้า-ข้อความออก ด้วยหน้าต่างบริบทขนาด 100,000 tokens คุณสามารถรวมคำแนะนำระบบเพื่อกำหนดพฤติกรรม หรือส่งเฉพาะข้อความผู้ใช้เพื่อการโต้ตอบโดยตรง

Copyfrom openai import OpenAI

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

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

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

รับการสร้างโทเค็นแบบเรียลไทม์โดยใช้ 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)

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

Function Calling และโหมด JSON

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

Copyimport OpenAI from "openai";

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

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

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

API ของเรากำหนดขีดจำกัดที่เข้มงวดเพื่อให้มั่นใจในความเสถียรสำหรับผู้ใช้ทุกคน คุณได้รับการอนุญาตให้เรียกใช้ 300 ครั้งต่อนาที และ 8 การเรียกใช้พร้อมกันต่อคีย์ ขนาด body การเรียกใช้แต่ละครั้งต้องไม่เกิน 8 MB เพื่อป้องกันปัญหา payload ที่มากเกินไป ขีดจำกัดเหล่านี้ใช้ต่อ API key ดังนั้นควรกระจายโหลดข้ามคีย์หากจำเป็น

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

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

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

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