เอกสาร API และ Endpoints
คู่มือนี้แสดงวิธีเชื่อมต่อไคลเอนต์ของคุณกับ API ที่เข้ากันได้กับ OpenAI ของเราสำหรับการสร้างข้อความแบบไม่มีเซ็นเซอร์ คุณจะพบ URL พื้นฐาน ขั้นตอนการตรวจสอบสิทธิ์ และตัวอย่างโค้ดสำหรับภาษาที่คุณต้องการ
การตรวจสอบสิทธิ์และ Base URL
API จำเป็นต้องใช้คีย์ที่ถูกต้องสำหรับทุกคำขอ คุณสร้างคีย์นี้ทันทีเมื่อสมัครสมาชิกด้วย Google หรือที่อยู่อีเมล ส่งคีย์นี้ใน Authorization header โดยใช้ Bearer scheme base URL สำหรับการร้องขอทั้งหมดคือ HTTPS://api.qwenaipricing.com/v1. URL นี้ทำงานกับ SDK ของ OpenAI อย่างเป็นทางการและไคลเอนต์ที่เข้ากันได้โดยการอัปเดตการกำหนดค่าพื้นฐานเพียงอย่างเดียว
จุดจบ API Chat Completions
endpoint หลักคือ POST /v1/chat/completions. มันรับ body JSON ที่มี messages อาร์เรย์และ a model ช่อง ตั้งค่า ID โมเดลเป็น "uncensored" เพื่อเข้าถึงโมเดลภาษาขนาดใหญ่ที่ปรับแต่งสำหรับเอาต์พุตแบบไม่จำกัด คุณสามารถกำหนดบทบาทระบบ ผู้ใช้ และผู้ช่วยเพื่อจัดโครงสร้างบริบทการสนทนาของคุณ
curl https://api.qwenaipricing.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the monthly cost for the 72B model?"}]
}'
การตอบสนองรวมถึงเนื้อหาที่สร้างขึ้นมา สถิติการใช้งาน และเหตุผลการสิ้นสุด ข้อผิดพลาดส่งกลับรหัส HTTP มาตรฐานเช่น 401 สำหรับคีย์ที่ไม่ถูกต้อง หรือ 402 หากยอดเงินที่เติมไว้ล่วงหน้าของคุณหมดแล้ว API ไม่รองรับจุดสิ้นสุดสำหรับการฝังตัว การสร้างภาพ หรือการปรับแต่ง
การผสานรวม SDK Python
ใช้ openai แพ็กเกจ Python เพื่อโต้ตอบกับ API เริ่มต้นใช้งานไคลเอนต์โดยระบุ API key ของคุณและตั้งค่า URL ฐานไปยังจุดสิ้นสุดของเรา สิ่งนี้ช่วยให้คุณใช้วิธีการที่คุ้นเคยเช่น chat.completions.create() โดยไม่ต้องเขียนโค้ด client ใหม่ไลบรารีจัดการการ serialize JSON และการ parse response โดยอัตโนมัติ
from openai import OpenAI
client = OpenAI(base_url="https://api.qwenaipricing.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)
ส่งข้อความของคุณเป็นรายการของดิกชันนารี SDK รองรับพารามิเตอร์มาตรฐานทั้งหมดเช่น temperature และ top_p วิธีการนี้รับประกันความเข้ากันได้กับโค้ดเบสที่มีอยู่ซึ่งคาดหวังอินเทอร์เฟซที่เข้ากันได้กับ OpenAI
การผสานรวม SDK Node.js
SDK ของ Node.js ทำงานคล้ายกับเวอร์ชัน Python ติดตั้ง openai แพ็กเกจและกำหนดค่า URL พื้นฐานและคีย์ API จากนั้นคุณสามารถเรียกใช้จุดจบการเติมข้อความแชทด้วยพารามิเตอร์ที่ต้องการ วิธีนี้เหมาะสำหรับแอปพลิเคชันฝั่งเซิร์ฟเวอร์หรือบริการแบ็กเอนด์ที่ต้องการสร้างข้อความแบบอะซิงโครนัส
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwenaipricing.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);
จัดการสตรีมการตอบกลับหรือพรอมิสเพื่อประมวลผลโทเค็นที่สร้าง ไลบรารี SDK จัดการการเชื่อมต่อ HTTP และการจัดการข้อผิดพลาดให้คุณ คุณสามารถใช้ GET /v1/models endpoint สำหรับตรวจสอบ ID ของโมเดลที่มีอยู่
การสตรีมและการใช้งาน
เปิดใช้งานการสตรีมโดยตั้งค่า stream: true ในการร้องขอของคุณ API จะส่งสตรีม Server-Sent Events (SSE) ของการตอบกลับบางส่วน แต่ละชิ้นประกอบด้วยข้อความที่สร้างขึ้นบางส่วน ซึ่งเหมาะสำหรับอินเทอร์เฟซผู้ใช้แบบเรียลไทม์ที่แสดงข้อความทันทีที่สร้างขึ้น
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)
ชิ้นข้อมูลสุดท้ายในสตรีมประกอบด้วยการใช้งานโทเค็นรวมสำหรับคำขอ คุณสามารถติดตามการบริโภคเครดิตล่วงหน้าของคุณโดยการติดตามสถิติการใช้งานเหล่านี้ ระหว่างการสตรีมอาจเกิดข้อผิดพลาดที่ทำให้การเชื่อมต่อสิ้นสุดลงก่อนกำหนด
ข้อจำกัด, ข้อผิดพลาด และหน้าต่างบริบท
โมเดลรองรับ context window ขนาด 100,000 tokens สำหรับ prompt และ completion รวมกัน ค่า output สูงสุดต่อการเรียกข้อมูลคือ 16,000 tokens หากไม่ได้ตั้งค่า max_tokens, ค่าจำกัดคือ 2,048 tokens คุณจำกัดอยู่ที่ 300 คำขอต่อนาทีและ 8 คำขอพร้อมกันต่อคีย์ รหัสข้อผิดพลาด 429 หมายถึงคุณเกินขีดจำกัดเหล่านี้ คำขอที่มีข้อผิดพลาดหรือการปฏิเสธไม่ใช้เครดิต API ไม่มีการรับประกัน SLA หรือใบรับรอง
คำถามที่พบบ่อย
ขีดจำกัดหน้าต่างบริบทสำหรับโมเดลแบบไร้การเซ็นเซอร์คืออะไร?
โมเดลรองรับ context window ขนาด 100,000 tokens สำหรับ prompt และ completion รวมกัน คุณสามารถสร้าง output ได้สูงสุด 16,000 tokens ในการเรียกข้อมูลครั้งเดียว
ฉันจะจัดการข้อผิดพลาดการตรวจสอบสิทธิ์ได้อย่างไร?
รหัสข้อผิดพลาด 401 หมายถึงคีย์ API ไม่ถูกต้องหรือหายไป ให้แน่ใจว่าคุณส่งคีย์ผ่านส่วนหัว Authorization เป็นโทเค็น Bearer หากคีย์ปัจจุบันถูกเพิกถอน ให้สร้างคีย์ใหม่จากแดชบอร์ดบัญชีของคุณ
API รองรับการสร้างภาพเช่น Qwen Image หรือไม่?
ไม่ API นี้ให้บริการเฉพาะการสร้างข้อความผ่านเอนด์พอยต์ chat-completions เท่านั้น ไม่รองรับ embeddings เสียง วิดีโอ หรือการสร้างภาพ คุณต้องใช้เอนด์พอยต์หรือบริการอื่นสำหรับมอดาลิตีเหล่านั้น