รายการตรวจสอบการนำ API DeepSeek ไปใช้งานจริง

การกำหนดค่าจุดปลายและ URL พื้นฐาน

ขั้นตอนแรกคือการชี้ไคลเอนต์ของคุณไปยัง URL พื้นฐานที่ถูกต้อง เราใช้โครงสร้างที่เข้ากันได้กับ OpenAI มาตรฐาน ซึ่งหมายความว่าไคลเอนต์ SDK ที่มีอยู่ของคุณใช้งานได้โดยไม่ต้องปรับโครงสร้างหลัก ตั้งค่า base_url เพื่อ https://api.deepseekunrestricted.com/v1 และกำหนดค่าคีย์ API ของคุณในหัว authorization การตั้งค่านี้รับประกันว่าจุดจบมาตรฐานทั้งหมดเช่น /v1/chat/completions ทำงานตามที่เอกสารระบุพอดี คุณไม่จำเป็นต้องเขียนลอจิกการกำหนดเส้นทางใหม่

• Base URL: https://api.deepseekunrestricted.com/v1
• Auth Header: Authorization: Bearer YOUR_API_KEY
• ID โมเดล: uncensored

การกำหนดค่านี้ช่วยให้คุณสลับระหว่างโมเดลต่างๆ ได้หากคุณขยายในภายหลัง แต่ในปัจจุบัน ให้ยึดติดกับโมเดล uncensored เพียงตัวเดียว จุดปลายถูกออกแบบมาสำหรับการทำงานแบบข้อความเข้า-ข้อความออก มันรองรับพารามิเตอร์มาตรฐานเช่น temperature และ top_p จงจัดกลุ่มการกำหนดค่าของคุณให้เป็นศูนย์กลางเพื่อหลีกเลี่ยงการเขียน URL แบบคงที่ในหลายที่ ซึ่งช่วยลดภาระในการบำรุงรักษาเมื่อเราอัปเดตเวอร์ชัน API

การคำนวณโทเค็นและการประมาณการต้นทุน

การประมาณต้นทุนอาศัยการติดตาม input tokens และ output tokens แยกกัน โครงสร้างราคาเรียบง่าย: $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens ข้อผิดพลาดและการปฏิเสธไม่ใช้เครดิต ดังนั้นคุณจ่ายเฉพาะสำหรับการประมวลผลที่สำเร็จ โมเดลแบบเติมเงินนี้ช่วยให้ควบคุมงบประมาณของคุณได้อย่างเคร่งครัด คุณสามารถเติมเงินด้วยคริปโตและได้รับโบนัสสำหรับยอดที่สูงขึ้น

• ต้นทุนอินพุต: $0.15 ต่อ 1M โทเค็น
• ต้นทุนผลลัพธ์: $0.50 ต่อ 1M โทเค็น
• การคืนเงิน: ไม่มี แต่เครดิตไม่หมดอายุ

ควรตรวจสอบ usage field in the response to track your spend accurately. Implement a local counter to estimate costs before sending large batches. This prevents unexpected depletion of your prepaid balance. Remember that the credit never expires, so you can top up when prices are favorable. Use the bonus tiers to maximize your purchasing power. A $100 top-up gives you 10% extra credit, which effectively lowers your per-token rate.

การจัดการการตอบกลับแบบสตรีมอย่างมีประสิทธิภาพ

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

• เปิดใช้งานการสตรีมโดยตั้งค่า stream: true
• แยกวิเคราะห์รูปแบบ SSE สำหรับการอัปเดตบางส่วน
• ดึงข้อมูลการใช้งานจากส่วนสุดท้าย

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

จัดการขีดจำกัดอัตราและความพร้อมใช้งาน

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

• จำกัด: 300 คำขอต่อนาทีต่อคีย์
• ความพร้อมใช้งานพร้อมกัน: 8 คำขอพร้อมกัน
• ขนาดเนื้อหา: สูงสุด 8 MB

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

การจัดการข้อผิดพลาดและตรรกะการลองใหม่

การจัดการข้อผิดพลาดที่แข็งแกร่งช่วยป้องกันแอปพลิเคชันของคุณหยุดทำงานระหว่างการเรียก API เราส่งกลับรหัสสถานะ HTTP มาตรฐานเพื่อระบุความสำเร็จหรือความล้มเหลว รหัสข้อผิดพลาด 4xx มักหมายถึงปัญหาฝั่งไคลเอนต์ เช่น คีย์ไม่ถูกต้องหรือคำขอผิดรูปแบบ รหัสข้อผิดพลาด 5xx บ่งชี้ถึงปัญหาฝั่งเซิร์ฟเวอร์ซึ่งอาจแก้ไขได้เอง

• 4xx: ข้อผิดพลาดไคลเอนต์ (ตรวจสอบคำขอของคุณ)
• 5xx: Server errors (retry with backoff)
• 429: เกินอัตราจำกัด (รอและเรียกซ้ำ)

ใช้กลไกการลองใหม่พร้อมการเพิ่มเวลาถอยหลังแบบทวีคูณ (exponential backoff) สำหรับข้อผิดพลาดชั่วคราว ไม่ต้องลองใหม่สำหรับข้อผิดพลาด 4xx เว้นแต่เกี่ยวข้องกับข้อจำกัดอัตรา บันทึกรายละเอียดข้อผิดพลาดเพื่อช่วยในการแก้ไขข้อบกพร่อง รวม ID คำขอในบันทึกของคุณเพื่อให้ทีมสนับสนุนช่วยวินิจฉัยปัญหาได้เร็วขึ้น จัดการการหมดเวลาเครือข่ายแยกจากข้อผิดพลาด HTTP คำขอที่ล้มเหลวไม่ควรใช้โทเค็นของคุณหากยังไม่ได้ประมวลผลโทเค็นใดๆ

โหมด JSON สำหรับผลลัพธ์ข้อมูลที่มีโครงสร้าง

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

• ตั้งค่า response_format เพื่อ json_object
• ตรวจสอบเอาต์พุตด้วยเครื่องแยกวิเคราะห์ JSON
• จัดการการละเมิดสคีมาอย่างเหมาะสม

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

การเรียกฟังก์ชันและการใช้งานเครื่องมือ

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

• กำหนดฟังก์ชันใน tools อาร์เรย์
• แยกวิเคราะห์การตอบกลับการเรียกใช้ฟังก์ชัน
• ส่งผลลัพธ์เพื่อดำเนินการสนทนาต่อ

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

การจัดการหน้าต่างบริบท

ขนาดหน้าต่างบริบทกำหนดปริมาณข้อความที่โมเดลสามารถประมวลผลได้ในครั้งเดียว API ของเรารองรับหน้าต่างบริบทขนาด 100,000 token ซึ่งรวมถึงทั้ง prompt และ completion โปรดระวังขีดจำกัดการส่งออกสูงสุดที่ 16,000 token ต่อคำขอ หากเกินขีดจำกัดนี้ โมเดลจะตัดทอนการตอบกลับ

• context window: 100,000 tokens
• จำนวนโทเค็นสูงสุด: 16,000 โทเค็น
• ผลลัพธ์สูงสุดค่าเริ่มต้น: 2,048 tokens

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

การหมุนคีย์และความปลอดภัย

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

• เก็บคีย์ในตัวแปรสภาพแวดล้อม
• หมุนคีย์อย่างสม่ำเสมอ
• ติดตามการใช้งานเพื่อหาความผิดปกติ

เพิ่มการบันทึกข้อมูล (logging) เพื่อติดตามการใช้งาน API และตรวจจับกิจกรรมที่ผิดปกติ ตั้งค่าการแจ้งเตือนสำหรับคำขอปริมาณสูง สิ่งนี้ช่วยระบุการใช้งานที่อาจไม่ถูกต้องหรือการโจมตีได้ อัปเดตเวอร์ชัน SDK ของคุณให้ทันสมัยอยู่เสมอเพื่อรับแพตช์ความปลอดภัย ใช้ HTTPS สำหรับการสื่อสาร API ทั้งหมด เพื่อให้แน่ใจว่าข้อมูลของคุณถูกเข้ารหัสขณะส่งผ่าน การตรวจสอบการใช้งาน API เป็นประจำช่วยรักษาความปลอดภัยให้แข็งแรง