เอกสารประกอบ API queen

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

การตรวจสอบสิทธิ์ใช้โทเค็น Bearer มาตรฐานที่ส่งใน Authorization header. วิธีนี้ทำให้เข้ากันได้กับ SDK มาตรฐานของ OpenAI โดยไม่ต้องใช้ตรรกะที่กำหนดเองของคุณ API_KEY ถูกสร้างทันทีหลังจากสมัครสมาชิกผ่าน Google หรืออีเมล การร้องขอทั้งหมดต้องชี้ไปยัง URL พื้นฐานเฉพาะที่ให้บริการ

• Base URL: https://api.apiqueen.cc/v1
• ส่วนหัว: Authorization: Bearer API_KEY

Copycurl https://api.apiqueen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return current status for service api queen"}]
  }'

ส่งคำขอไปยัง /v1/chat/completions

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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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

ควบคุมการสร้างคำตอบโดยใช้พารามิเตอร์ LLM มาตรฐาน ตั้งค่า temperature ระหว่าง 0 ถึง 2 เพื่อความสุ่มที่หลากหลาย ใช้ top_p เพื่อกรองคำที่มีความน่าจะเป็นต่ำ กำหนด stop ลำดับเพื่อหยุดผลลัพธ์ที่ตัวกระตุ้นเฉพาะ การตั้งค่าเหล่านี้ช่วยให้สามารถปรับแต่งได้อย่างแม่นยำสำหรับงานเขียนเชิงสร้างสรรค์หรือการดึงข้อมูลข้อเท็จจริง

API ละเว้นพารามิเตอร์ที่ไม่รองรับอย่างสุภาพ มุ่งเน้นไปที่ temperature, top_p, และ stop เพื่อผลลัพธ์ที่ดีที่สุด ปรับค่าเหล่านี้ตามความทนทานต่อสัญญาณรบกวนของแอปพลิเคชันของคุณ

การตอบกลับแบบสตรีมมิ่งและการใช้งานโทเค็น

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

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)

จัดการการตอบสนองแบบไม่สมบูรณ์อย่างระมัดระวัง ตรวจสอบให้แน่ใจว่าไคลเอนต์ของคุณเก็บข้อมูลไว้จนกว่าสตรีมจะปิด

Function Calling และโหมด JSON

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

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

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

ตรวจสอบรหัสสถานะ HTTP สำหรับปัญหาทั่วไป ข้อผิดพลาด 401 หมายความว่าคีย์ API ของคุณไม่ถูกต้อง ข้อผิดพลาด 402 หมายความว่าเครดิตที่ชำระเงินล่วงหน้าไม่เพียงพอ ข้อผิดพลาดไม่ใช้ยอดโทเค็นของคุณ ข้อจำกัดอัตราความเร็วบังคับใช้ 300 คำขอต่อนาทีต่อคีย์ คำขอพร้อมกันจำกัดไว้ที่ 8 หน้าต่างบริบทรองรับ 100,000 tokens รวม

จัดการการลองใหม่ด้วยการถดถอยแบบเอกซ์โพเนนเชียล ตรวจสอบ error object ใน response รูปแบบ JSON สำหรับรายละเอียด