เอกสาร API แบบไม่เซ็นเซอร์

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

คีย์ API ของคุณจะยืนยันตัวตนทุกคำขอ ใช้ URL พื้นฐาน HTTPS://api.uncensores.cc/v1 ร่วมกับ SDK มาตรฐานของ OpenAI ใดๆก็ได้ รหัสโมเดลคือ "uncensored" ส่งคีย์ของคุณในหัวเรื่อง Authorization เป็น Bearer token คุณสามารถสร้างคีย์ผ่านแดชบอร์ดโดยใช้ Google หรืออีเมล แต่ละบัญชีมีคีย์ที่ใช้งานอยู่เพียงคีย์เดียว ซึ่งจะถูกแทนที่ด้วยคีย์ใหม่

Copycurl https://api.uncensores.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top ten python libraries for data science"}]
  }'

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

Chat Completions Endpoint

ส่งคำขอ POST ไปยัง /v1/chat/completions สำหรับการสร้างข้อความ จุดปลายทางนี้จัดการกับคำขอสนทนามาตรฐานและคืนค่าข้อความที่มีโครงสร้าง มันไม่รองรับ embeddings หรือการสร้างภาพ คุณส่งข้อความ system, user และ assistant เพื่อแนะนำโมเดล โมเดลจะตอบสนองด้วยเนื้อหาข้อความดิบภายใน choices array

Copyfrom openai import OpenAI

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

เริ่มต้นใช้งานไคลเอนต์ด้วย URL ฐานและคีย์ กำหนดรายการข้อความด้วยบทบาทและเนื้อหาที่คุณต้องการ เรียกใช้เมธอด chat.completions.create วัตถุการตอบสนองประกอบด้วยข้อความที่สร้างและสถิติการใช้งาน วิธีการโดยตรงนี้ขจัดความซับซ้อนของการจัดเส้นทางสำหรับงานเขียน NSFW หรืองานสร้างสรรค์

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

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

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)

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

Function Calling และโหมด JSON

API รองรับ function calling ผ่านพารามิเตอร์ tools กำหนด schema ของฟังก์ชันในการเรียกใช้ และตั้งค่า tool_choice เป็น auto หรือชื่อเฉพาะ โมเดลจะส่งการเรียกใช้ฟังก์ชันกลับในการตอบกลับแทนข้อความธรรมดา นอกจากนี้คุณยังสามารถบังคับใช้ output แบบ JSON โดยตั้งค่า response_format เป็น json_object ซึ่งช่วยให้การ parse สำหรับ workflows อัตโนมัติมีความน่าเชื่อถือ

Copyimport OpenAI from "openai";

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

ส่งคำจำกัดความของ tool ในอาร์เรย์ tools โมเดลจะเลือกฟังก์ชันที่เหมาะสมตามอินพุต คุณจะได้รับชื่อฟังก์ชันและอาร์กิวเมนต์ในการตอบกลับ คุณลักษณะนี้ทำงานร่วมกับ chat completions มาตรฐานโดยไม่ต้องใช้ endpoint เพิ่มเติม ใช้สำหรับการแยกข้อมูลที่มีโครงสร้างหรือพฤติกรรมคล้าย agent

พารามิเตอร์: อุณหภูมิ, Top-P และ Seeds

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

คุณยังสามารถใช้ลำดับหยุด (stop sequences) เพื่อหยุดการสร้างที่สตริงเฉพาะ presence_penalty และ frequency_penalty ช่วยลดการทำซ้ำ อุณหภูมิเริ่มต้นคือ 1.0 การปรับการตั้งค่าเหล่านี้ช่วยเพิ่มประสิทธิภาพสำหรับการเล่นบทบาทหรือการเขียนทางเทคนิค แต่ละคำขอรองรับพารามิเตอร์มาตรฐานที่เข้ากันได้กับ OpenAI

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

หน้าต่างบริบทรองรับ 100,000 tokens รวมสำหรับ prompt และ completion โดยรวม คุณสามารถส่งผลลัพธ์ได้สูงสุด 16,000 tokens ต่อคำขอ หากละเว้น max_tokens ค่าเริ่มต้นคือ 2,048 tokens ขีดจำกัดนี้ใช้กับทั้งอินพุตและผลลัพธ์รวมกัน คำขอที่มีขนาด body เกิน 8 MB จะล้มเหลว API กำหนดขีดจำกัดอัตราที่ 300 คำขอต่อนาที คำขอพร้อมกันจำกัดไว้ที่ 8 ต่อคีย์ ข้อผิดพลาดเช่น 402 (ไม่มีเครดิต) หรือ 429 (เกินขีดจำกัดอัตรา) ให้ข้อมูลป้อนกลับที่ชัดเจน เครดิตที่ไม่ได้ใช้ไม่มีวันหมดอายุ ทำให้คุณจ่ายเฉพาะสำหรับการใช้งานจริงเท่านั้น