คู่มือการผสานรวมสำหรับนักพัฒนา

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

เริ่มต้นโดยชี้ client ของคุณไปยัง base URL ของเราและระบุ API key ของคุณใน header authorization สิ่งนี้ทำงานกับ SDK ที่เข้ากันได้กับ OpenAI ใดๆ เนื่องจากเราปฏิบัติตามโปรโตคอลมาตรฐานอย่างถูกต้อง สร้าง key ของคุณได้ทันทีผ่าน Google หรืออีเมลในหน้า Get API key ไม่จำเป็นต้องใช้เบอร์โทรศัพท์ เก็บ key ของคุณให้ปลอดภัยและใช้ key ที่ใช้งานเพียงหนึ่งต่อบัญชี เนื่องจากการสร้าง key ใหม่จะแทนที่ key เก่า

Authentication is simple. Send your key in the Authorization header สำหรับการร้องขอทุกชิ้น ระบบของเราจะตรวจสอบความถูกต้องของคีย์ก่อนประมวลผลโทเค็น เพื่อให้แน่ใจว่ามีเพียงบัญชีที่ได้รับอนุญาตเท่านั้นที่ใช้เครดิต ข้อผิดพลาดเช่นคีย์ที่หายไปจะส่งสถานะ 401 กลับมาทันที

คำขอครั้งแรก

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

Copycurl https://api.deepseekapicost.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate total monthly cost for 1 million tokens"}]
  }'

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

SDK Python

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

Copyfrom openai import OpenAI

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

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

Node SDK

ผสานรวม API ของเราเข้ากับแอปพลิเคชัน Node.js โดยใช้ openai แพ็กเกจ npm กำหนดค่าไคลเอนต์ด้วย URL พื้นฐานของเราและคีย์ API ของคุณเหมือนกับที่คุณทำสำหรับ OpenAI สิ่งนี้ช่วยให้คุณใช้โครงสร้างโค้ดเดียวกันสำหรับการทดสอบและการผลิต SDK รองรับการทำงานแบบอะซิงโครนัสสำหรับการร้องขอที่ไม่บล็อก

Copyimport OpenAI from "openai";

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

ตัวอย่าง Node.js นี้แสดงให้เห็นถึงการส่งคำขอ chat completion คำ await keyword ทำให้แน่ใจว่าข้อความตอบกลับได้รับการรับอย่างสมบูรณ์ก่อนดำเนินการต่อ คุณสามารถจัดการข้อผิดพลาดโดยใช้บล็อก try-catch เพื่อจัดการกับปัญหาเครือข่ายหรือขีดจำกัด API อย่างราบรื่น วัตถุการตอบกลับประกอบด้วยข้อความที่สร้างและรายละเอียดการใช้งาน token.

การสตรีม

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

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)

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

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

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

หน้าต่างบริบทรองรับสูงสุด 100,000 tokens สำหรับ input และ output รวมกัน output สูงสุดต่อการเรียกคือ 16,000 tokens หรือ 2,048 หากคุณไม่ได้ระบุ max_tokens. หน้าต่างขนาดใหญ่นี้ช่วยให้คุณประมวลผลเอกสารยาวหรือรักษาประวัติการสนทนาที่กว้างขวางได้โดยไม่มีการตัดทอน ข้อผิดพลาดและการปฏิเสธไม่ใช้เครดิต ดังนั้นคุณจึงจ่ายเฉพาะการใช้งานจริงเท่านั้น