API DeepSeek Coder: คู่มือเริ่มต้นใช้งาน

การติดตั้งและการกำหนดค่า URL พื้นฐาน

อัปเดตการกำหนดค่าไคลเอนต์ของคุณให้ชี้ไปยังจุดปลายที่โฮสต์ของเรา base_url ต้องเปลี่ยนจากผู้ให้บริการเริ่มต้นเป็น https://api.apicoderdeepseek.com/v1 เพื่อจัดเส้นทางคำขอให้ถูกต้อง

• ตั้งค่า base_url ไปยังค่าด้านบน
• รักษา SDK มาตรฐานไว้ตามเดิมเพื่อความเข้ากันได้

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

Authentication and Header Setup

ส่งคีย์ของคุณใน Authorization header เพื่อตรวจสอบการเข้าถึง สร้างบัญชีผ่าน Google หรืออีเมลเพื่อรับข้อมูลรับรองเฉพาะของคุณทันที

รวมหัวเรื่อง Authorization: Bearer YOUR_API_KEY ในทุกการเรียกข้อมูล ระบบของเราตรวจสอบโทเค็นนี้ก่อนประมวลผลโทเค็นใดๆ หรือคำนวณต้นทุนการใช้งาน

ส่งคำขอ Chat Completion ครั้งแรกของคุณ

ส่งคำขอ chat completion มาตรฐานเพื่อสร้างข้อความหรือโค้ด ใช้รหัสโมเดล uncensored เพื่อเข้าถึงโมเดลที่ปรับแต่งแล้วโดยไม่มีการปฏิเสธเนื้อหา

API ยอมรับโครงสร้างเพย์โหลดมาตรฐานของ OpenAI คุณสามารถส่ง system prompts, ข้อความผู้ใช้ และประวัติผู้ช่วยได้ในคำขอเดียว

ตรวจสอบให้แน่ใจว่า body ของคำขอของคุณมี model และ messages ฟิลด์ข้อมูล การตอบกลับจะประกอบด้วยข้อความที่สร้างขึ้นใน content ช่อง

การตอบกลับแบบสตรีมมิ่งและการใช้งานโทเค็น

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

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

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

ตัวอย่าง Function Calling และโหมด JSON

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

กำหนดสคีมาฟังก์ชันใน tools พารามิเตอร์ โมเดลจะเรียกใช้ฟังก์ชันเหล่านี้เมื่อเหมาะสมตามคำสั่ง

รองรับ temperature, top_p, และ stop พารามิเตอร์ สำหรับการปรับแต่งผลลัพธ์ ใช้ seed เพื่อความผลลัพธ์ที่ทำซ้ำได้ระหว่างการทดสอบ

อัตราการจำกัดและวิธีการจัดการข้อผิดพลาด

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

จัดการ HTTP 401 สำหรับคีย์ที่ไม่ถูกต้อง และ 429 สำหรับข้อจำกัดอัตราการใช้งาน รองรับคำขอขนาดต่ำกว่า 8 MB ข้อผิดพลาดไม่ใช้เครดิต

หน้าต่างบริบทรองรับได้สูงสุด 100,000 tokens รวมกัน สูงสุดที่ส่งออกได้คือ 16,000 tokens เว้นแต่ max_tokens ถูกตั้งค่าเป็น 2,048 โดยค่าเริ่มต้น.

cURL

Copycurl https://api.apicoderdeepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the available endpoints for the chat completion service."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

การสตรีม

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)