คู่มือการผสานรวม: คีย์ API ของ deepseek coder

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

คีย์ API ของคุณจะยืนยันตัวตนทุกคำขอ ตั้งค่า URL พื้นฐานเป็น https://api.deepseekcoderapikey.com/v1 ในการกำหนดค่าไคลเอนต์ของคุณ URL นี้จัดการทั้งจุดปลายการเสร็จสิ้นการสนทนาและจุดปลายโมเดลโดยไม่ต้องใช้ส่วนเส้นทางเพิ่มเติม คุณจะได้รับคีย์เดียวต่อบัญชี และการสร้างคีย์ใหม่จะแทนที่คีย์ก่อนหน้าทันที

เก็บคีย์ในตัวแปรสภาพแวดล้อมชื่อ DEEPSEEK_API_KEY หรือส่งค่านี้โดยตรงไปยังไคลเอนต์ SDK ของคุณ จุดปลาย (endpoint) ยอมรับหัวเรื่องมาตรฐาน ดังนั้นคุณสามารถเปลี่ยนผู้ให้บริการได้โดยการเปลี่ยนเพียง URL พื้นฐานและค่าคีย์ วิธีการนี้ใช้งานได้กับ Cursor, ส่วนขยาย VS Code และเครื่องมือพัฒนาท้องถิ่นที่คาดหวังอินเทอร์เฟซที่เข้ากันได้กับ OpenAI

Authentication fails with a 401 status if the key is missing or invalid. Use the

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

ตัวอย่างเพื่อตรวจสอบการเชื่อมต่อก่อนรวมเข้ากับตรรกะแอปพลิเคชันของคุณ

จุดจบ API Chat Completions (POST)

ส่งข้อความไปยัง POST /v1/chat/completions endpoint ที่ใช้ ID ของโมเดล uncensored. เอนด์พอยต์นี้ประมวลผลอินพุตข้อความและส่งคืนเอาต์พุตข้อความ รองรับทั้งการตอบกลับแบบซิงโครนัสและแบบสตรีม คุณสามารถกำหนดพฤติกรรมโมเดลโดยใช้พารามิเตอร์เช่น temperature, top_p และ stop sequences

หน้าต่างบริออบรองรับได้สูงสุด 100,000 tokens สำหรับ prompt และ completion รวมกัน หากคุณไม่ได้ระบุขีดจำกัด max_tokens โมเดลจะกำหนดค่าเริ่มต้นที่ 2,048 tokens ต่อ request ใช้

Copyfrom openai import OpenAI

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

โค้ดตัวอย่างเพื่อดูวิธีจัดโครงสร้างคำขอแชทมาตรฐานด้วย OpenAI Python SDK ทางการ

ข้อผิดพลาดเช่นเครดิตไม่เพียงพอจะส่งรหัสสถานะ 402 ในขณะที่คำขอที่มีโครงสร้างไม่ถูกต้องจะส่ง 400 ตรวจสอบเนื้อหาการตอบกลับเพื่อรับข้อความข้อผิดพลาดโดยละเอียดเพื่อดีบักโครงสร้าง payload ของคุณอย่างรวดเร็ว

Models Endpoint (GET)

สอบถามโมเดลที่พร้อมใช้งานโดยส่ง GET /v1/models request endpoint นี้ส่งกลับรายการของ object โมเดล รวมถึง uncensored model ID คุณสามารถใช้จุดปลายทางนี้เพื่อยืนยันว่าคีย์ API ของคุณถูกต้องและบริการออนไลน์อยู่ก่อนทำการขอใช้งานปริมาณมาก

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

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

การตอบกลับแบบสตรีมมิ่ง (SSE)

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

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

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)

ตัวอย่างแสดงให้เห็นวิธีการจัดการสตรีมใน JavaScript

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

Function Calling และโหมด JSON

ใช้ฟังก์ชันคอลลิงเพื่อให้โมเดลเรียกใช้เครื่องมือภายนอก กำหนดฟังก์ชันของคุณใน tools parameter and specify the tool_choice เพื่อควบคุมเวลาที่โมเดลจะใช้เครื่องมือเหล่านี้ API รองรับคำจำกัดความของเครื่องมือมาตรฐาน ทำให้คุณสามารถผสานรวมกับบริการแบ็กเอนด์ของคุณเองได้

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

Copyimport OpenAI from "openai";

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

โค้ดตัวอย่างแสดงวิธีกำหนดโหมด JSON ใน Node.js

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

อัตราจำกัดและข้อจำกัด

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

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

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