URL ฐานและการตรวจสอบสิทธิ์
ใช้ URL พื้นฐานและคีย์ API ที่จัดเตรียมไว้เพื่อเชื่อมต่อไคลเอนต์ของคุณ เอนด์พอยต์คือ https://api.qwencodeapikey.com/v1.คุณต้องรวมคีย์ของคุณใน Authorization header ของทุกคำขอ สิ่งนี้รับประกันว่าบริการจะระบุบัญชีเครดิตพรีเพดของคุณได้อย่างถูกต้อง
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
คุณสามารถสร้างคีย์ผ่าน Google หรืออีเมลได้หน้าลงชื่อเข้าใช้ คีย์จะปรากฏทันที เก็บให้ปลอดภัยเนื่องจากคีย์นี้ควบคุมการใช้จ่ายของคุณ
จุดจบ API Chat Completions
ส่งข้อความไปยัง /v1/chat/completions เอนด์พอยต์สำหรับรับข้อความตอบกลับ นี่คืออินเทอร์เฟซมาตรฐานสำหรับ SDK ของ OpenAI ส่วนใหญ่ คุณกำหนด model as uncensored และให้รายการข้อความใน messages array. API จะประมวลผลข้อมูลนำเข้าของคุณและส่งกลับข้อความที่สร้างขึ้นมา
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
ตรวจสอบให้แน่ใจว่าไลบรารีไคลเอนต์ของคุณชี้ไปที่ URL ฐานที่ถูกต้อง ID โมเดล uncensored เปิดใช้งานโมเดล open-weight ที่ปรับแต่งมาเพื่อลดการปฏิเสธ การสนทนาทำงานเหมือน API แชทอื่นๆ ทั่วไป
เอนด์พอยต์โมเดล
Query GET /v1/models เพื่อตรวจสอบโมเดลที่มีอยู่และรายละเอียด จุดสิ้นสุดนี้จะส่งรายการโมเดลที่คีย์ของคุณสามารถเข้าถึงได้ ช่วยให้คุณยืนยัน uncensored model is active and ready for requests. Use this for debugging client configurations before sending full payloads.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
ตรวจสอบโครงสร้าง response เพื่อให้แน่ใจว่า SDK ของคุณสามารถ parse รายการโมเดลได้ถูกต้อง endpoint นี้ไม่ใช้เครดิต ทำให้ปลอดภัยสำหรับการตรวจสอบตอนเริ่มต้น
พารามิเตอร์คำขอและการสตรีม
รองรับพารามิเตอร์มาตรฐานเช่น temperature, top_p, stop, และ seed. เปิดใช้งานการสตรีมโดยตั้งค่า stream: true. API ส่ง token ผ่าน Server-Sent Events (SSE) สถิติการใช้งาน token ปรากฏใน chunk สุดท้ายของ stream ทำให้สามารถแสดงข้อความที่สร้างแบบเรียลไทม์ได้
stream = 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)
ตั้งค่า max_tokens เพื่อควบคุมความยาวของผลลัพธ์ ค่าเริ่มต้นคือ 2,048 โทเค็น คุณสามารถเพิ่มค่านี้ได้สูงสุด 16,000 โทเค็นต่อคำขอ ปรับพารามิเตอร์เพื่อปรับสมดุลระหว่างความคิดสร้างสรรค์และความแม่นยำในผลลัพธ์ของคุณ
อัตราจำกัดและข้อจำกัด
คีย์แต่ละคีย์อนุญาตให้ส่งคำขอได้ 300 คำขอต่อนาที และคำขอพร้อมกันได้ 8 คำขอ ขนาด body ของคำขอสูงสุดคือ 8 MB ขีดจำกัดเหล่านี้ช่วยป้องกันการ滥用และรับประกันประสิทธิภาพที่เสถียร หากเกินอัตราจำกัด คุณจะรับข้อผิดพลาด 429 ปรับตรรกะไคลเอนต์ของคุณให้จัดการการลองใหม่ด้วยการถดถอยแบบเอกซ์โพเนนเชียล (exponential backoff)
หน้าต่างบริบทรองรับ 100,000 tokens รวม ซึ่งรวมถึง prompt และ completion บริบทขนาดใหญ่ต้องการการจัดการ tokens อย่างระมัดระวังเพื่อให้อยู่ในขีดจำกัด
โหมด JSON และการเรียกใช้ฟังก์ชัน
ใช้ response_format: {"type": "json_object"} สำหรับผลลัพธ์ที่มีโครงสร้าง สิ่งนี้รับประกันว่าโมเดลจะส่งคืน JSON ที่ถูกต้อง เหมาะสำหรับการทำงานแบบโปรแกรม การเรียกฟังก์ชันทำงานผ่าน tools พารามิเตอร์ กำหนดเครื่องมือในรูปแบบมาตรฐานของ OpenAI โมเดลจะเรียกใช้ฟังก์ชันเมื่อจำเป็น
ข้อผิดพลาดและการปฏิเสธไม่ใช้เครดิต ซึ่งใช้แม้ว่าโมเดลจะปฏิเสธคำขอเนื่องจากขีดจำกัดเนื้อหาแบบแข็ง คุณจ่ายเฉพาะสำหรับการใช้งานโทเค็นจริง เครดิตไม่มีวันหมดอายุ ดังนั้นคุณสามารถเติมเงินเมื่อสะดวก
การจัดการข้อผิดพลาดและการใช้งาน
จัดการข้อผิดพลาด HTTP อย่างสุภาพ ข้อผิดพลาด 401 หมายถึงคีย์ API ไม่ถูกต้องหรือหมดอายุ ข้อผิดพลาด 402 หมายถึงเครดิตพรีเพดของคุณหมดแล้ว ข้อผิดพลาด 429 บ่งชี้ว่าเกินข้อจำกัดอัตราการใช้งาน ตรวจสอบ body ของการตอบกลับสำหรับข้อความข้อผิดพลาดโดยละเอียด
การใช้งานถูกติดตามตามคีย์ แต่ละบัญชีใช้คีย์ที่ใช้งานหนึ่งคีย์เพื่อทำให้การเรียกเก็บเงินง่ายขึ้น หากคุณทำผิดพลาด เช่น การเรียกเก็บเงินซ้ำ ให้ใช้หน้าการสนับสนุน เครดิตจะไม่ถูกคืนแต่จะยังคงใช้ได้ ความผิดพลาดเป็นฟรี ดังนั้นคำขอที่ล้มเหลวจะไม่ทำให้ยอดคงเหลือของคุณลดลง
สรุปและแนวทางปฏิบัติที่ดีที่สุด
เริ่มต้นด้วย URL พื้นฐานและคีย์ที่ถูกต้อง ใช้ uncensored ID ของโมเดลสำหรับการปฏิเสธน้อยลง สตรีมการตอบสนองเพื่อประสบการณ์ผู้ใช้ที่ดีขึ้น ตรวจสอบขีดจำกัดอัตราเพื่อหลีกเลี่ยงการหยุดชะงัก ใช้โหมด JSON สำหรับข้อมูลที่มีโครงสร้าง จัดการข้อผิดพลาดเพื่อรักษาความน่าเชื่อถือ เครดิตเป็นแบบเติมเงินและไม่หมดอายุ เติมเงินด้วยคริปโตเมื่อจำเป็น API นี้ผสานรวมได้อย่างราบรื่นกับฐานโค้ด OpenAI ที่มีอยู่ ไม่ต้องใช้ SDK ใหม่ เพียงเปลี่ยน URL พื้นฐานและคีย์