คู่มือ API Quickstart

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

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

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

จุดจบ API Chat Completions

ส่งคำขอแรกของคุณไปยัง /v1/chat/completions endpoint ที่ใช้ ID ของโมเดล uncensored. เอนด์พอยต์นี้จัดการการโต้ตอบข้อความเข้า-ข้อความออกโดยไม่มีการกลั่นกรองเนื้อหาในตัว คุณสามารถควบคุมสไตล์การตอบกลับโดยใช้พารามิเตอร์เช่น temperature และ top_p. โมเดลรองรับหน้าต่างบริบทขนาด 100,000 token ทำให้สามารถรองรับประวัติการสนทนาที่ยาวนานหรือการประมวลผลเอกสารในคำขอเดียว ขนาดผลลัพธ์สูงสุดถูกจำกัดไว้ที่ 16,000 token ต่อคำขอ หรือ 2,048 หากคุณละเว้นการกำหนดขีดจำกัด

• ใช้ response_format กับ json_object สำหรับผลลัพธ์ข้อมูลที่มีโครงสร้าง
• ตั้งค่า stream: true สำหรับการส่งมอบโทเค็นแบบเรียลไทม์
• Pass stop ลำดับเพื่อหยุดการสร้างที่เครื่องหมายเฉพาะ

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

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

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

object การใช้งาน token รวมถึง input tokens, output tokens และบางครั้งรวม total tokens เนื่องจาก API ของเราเป็นแบบเติมเงิน คุณสามารถติดตามเครดิตคงเหลือของคุณเทียบกับตัวเลขการใช้งานเหล่านี้ ข้อผิดพลาดระหว่าง streaming ไม่คิดค่าบริการสำหรับ tokens ที่ส่งไปแล้ว ความโปร่งใสนี้ช่วยให้คุณจัดการงบประมาณได้อย่างมีประสิทธิภาพ โดยเฉพาะเมื่อรันการสนทนาที่ยาวนานหรือประมวลผลเอกสารขนาดใหญ่ หน้าต่างบริบทขนาด 100,000 token รองรับบริบททางประวัติศาสตร์ที่ลึกซึ้งโดยไม่มีการตัดทอน

Function Calling และโหมด JSON

ใช้ฟังก์ชันคอลลิงเพื่อผสานรวม API ของเราเข้ากับเวิร์กโฟลว์เอเจนต์ กำหนดเครื่องมือของคุณใน tools parameter and set tool_choice เพื่อ auto หรือ ID ฟังก์ชันเฉพาะ โมเดลจะส่งคืนวัตถุการเรียกใช้เครื่องมือหากอินพุตต้องการการกระทำภายนอก คุณลักษณะนี้ทำงานร่วมกับโหมด JSON ซึ่งบังคับให้ออกพุตอยู่ในโครงสร้าง JSON ที่เข้มงวดโดยใช้ response_format. คุณสามารถรวมสิ่งเหล่านี้สำหรับการสกัดข้อมูลที่มีโครงสร้างที่แข็งแกร่ง

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

ขีดจำกัดและแนวทางปฏิบัติที่ดีที่สุด

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

แนวทางปฏิบัติที่ดีที่สุดรวมถึงการตั้งค่า max_tokens limit เพื่อควบคุมต้นทุนและหลีกเลี่ยงการสร้างแบบไม่จำกัด ใช้ stop ลำดับเพื่อป้องกันไม่ให้โมเดลพูดพร่ำเพรื่อ ตรวจสอบการใช้โทเค็นของคุณผ่านจุดปลายแบบสตรีมมิ่งเพื่อให้แน่ใจว่าคุณอยู่ภายในเครดิตที่ชำระล่วงหน้า เนื่องจากเครดิตไม่หมดอายุ คุณสามารถเติมเครดิตได้ whenever สะดวก โมเดลแบบ uncensored ไม่ปฏิเสธเนื้อหาผู้ใหญ่ที่ถูกต้องตามกฎหมาย แต่จะบล็อกเนื้อหาทางเพศที่เกี่ยวข้องกับเด็ก ขีดจำกัดแข็งนี้ใช้กับทุกชั้นบัญชีของคุณ

ตัวอย่างไคลเอนต์

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

cURL

Copycurl https://api.deepseekapidiscount.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check server status for uptime reliability and latency metrics"}]
  }'

Python

Copyfrom openai import OpenAI

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