TH ▾
รับคีย์ API

getdeepseekapi.comคู่มือ

URL API และ Base URL ของ DeepSeek: วิธีเปลี่ยน

URL API deepseek ที่คุณคัดลอกจากเอกสารของ DeepSeek เป็น Base URL และใช้งานได้เฉพาะกับคีย์ของ DeepSeek และโมเดลของ DeepSeek หากคุณต้องการเอนด์พอยต์สไตล์ OpenAI อื่น คุณเปลี่ยน URL นั้น คีย์ และ ID โมเดล

อัปเดต

ประเด็นสำคัญ

  • Base URL คือคำนำหน้า; SDK จะเพิ่ม /chat/completions เข้าไป
  • บริการนี้ใช้ https://api.getdeepseekapi.com/v1 พร้อม ID โมเดล uncensored
  • นี่ไม่ใช่ API ของ DeepSeek ดังนั้นคีย์ DeepSeek จะไม่ทำงานที่นี่และในทางกลับกัน
  • ไคลเอนต์ส่วนใหญ่ยังยอมรับ URL และคีย์ผ่าน OPENAI_BASE_URL และ OPENAI_API_KEY
ภาพรถไฟสลับเส้นทางเปลี่ยนเส้นทางแสงสว่างไปยังเซิร์ฟเวอร์อื่น เพื่อแสดงการเปลี่ยน Base URL ของ API

Base URL, endpoint และ path: ส่วนประกอบทั้งสาม

ผู้ใช้มักวางที่อยู่เต็มลงในช่องที่คาดหวังแค่ prefix แล้วได้สถานะ HTTP 404 คำสามคำนี้ช่วยให้ความเข้าใจชัดเจน

  • Base URL: ส่วนนำหน้าที่ใช้ร่วมกันในทุกการเรียก เช่น https://api.getdeepseekapi.com/v1 นี่คือค่าที่คุณใส่ในการตั้งค่า "API base" หรือ "Base URL" ของไคลเอนต์
  • Endpoint path: ส่วนที่เพิ่มโดย SDK เช่น /chat/completions, /responses หรือ /models
  • Full URL: ส่วนนำหน้ารวมกับ path เช่น https://api.getdeepseekapi.com/v1/chat/completions ไคลเอนต์ HTTP ดิบอย่าง curl ต้องการค่านี้

กฎที่จับผู้ใช้ส่วนใหญ่ได้: SDK และแอปขอ Base URL แต่ curl และโหนด HTTP ขอ URL เต็ม หากเครื่องมือใดให้ผลลัพธ์ 404 ให้ตรวจสอบก่อนว่าคุณใส่ URL เต็มในตำแหน่งที่คาดหวัง Base URL หรือในทางกลับกันหรือไม่ เส้นทางที่ซ้ำกันเช่น /v1/chat/completions/chat/completions ในข้อผิดพลาดคือตัวบ่งชี้ที่ชัดเจน

DeepSeek Base URL คืออะไร และไม่ใช่

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

บริการบนเว็บไซต์นี้เป็นผลิตภัณฑ์แยกต่างหาก ไม่ใช่ API ของ DeepSeek อย่างเป็นทางการ ไม่ได้ส่งต่อไปยัง DeepSeek และไม่ได้ให้บริการโมเดลของ DeepSeek เป็น API ที่เข้ากันได้กับ OpenAI แบบโฮสต์สำหรับโมเดล open-weight model เพียงตัวเดียว ดำเนินการโดยผู้ให้บริการอิสระและปรับแต่งเพื่อตอบคำถามโดยไม่มีการปฏิเสธเนื้อหา สำหรับการใช้งานผู้ใหญ่ที่ถูกต้องตามกฎหมาย ที่อยู่คือ:

https://api.getdeepseekapi.com/v1   # model: uncensored

model ID คือ uncensored และการตรวจสอบสิทธิ์คือ Authorization: Bearer <key> คีย์ออกให้ที่หน้า API key page หากคุณกำลังเปรียบเทียบความหมายของคีย์สำหรับแต่ละบริการ หน้า DeepSeek API key มีรายละเอียดเพิ่มเติม

การเปลี่ยน endpoint ใน SDK ของ OpenAI

SDK ของ OpenAI ใดๆ ทำงานได้ทันทีที่คุณเปลี่ยน base URL และคีย์ ใน Python:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.getdeepseekapi.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)

ใน Node.js ฟิลด์นี้เขียนว่า baseURL:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.getdeepseekapi.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);

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

เปลี่ยนโดยไม่ต้องแก้ไขโค้ด

SDK ของ OpenAI อ่านตัวแปรสภาพแวดล้อมสองตัว ดังนั้นแอปที่มีอยู่จึงสามารถเปลี่ยนจุดอ้างอิงได้โดยไม่ต้องแก้ไขโค้ด:

export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py   # the app still has to request model "uncensored"

ชื่อโมเดลคือส่วนที่คุณไม่สามารถข้ามได้ หากแอปกำหนดชื่อโมเดลอื่นแบบตายตัว แอปจะขอโมเดลนั้นและล้มเหลว ดังนั้นให้เปลี่ยนเป็น uncensored ในการตั้งค่าหรือค่ากำหนดของแอป เครื่องมือจำนวนมากแสดงค่าทั้งสามนี้ในหน้าจอตั้งค่าเพียงหน้าจอเดียว ซึ่งมักติดป้ายกำกับว่า API base, API key และ model

การสลับค่าสามค่านี้ทำงานได้ในเฟรมเวิร์กเช่นกัน ตัวอย่างเช่น ใน Python ด้วย LangChain ค่า ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored") เพียงพอ เครื่องมือเขียนโค้ดที่รองรับเอนด์พอยต์ที่เข้ากันได้กับ OpenAI ทำงานในลักษณะเดียวกัน ดูคำแนะนำแบบทีละขั้นตอนใน การใช้ API สำหรับการเขียนโค้ด

HTTP ดิบ: เส้นทางที่แน่นอน

สำหรับ curl สคริปต์ และโหนด HTTP ที่คุณสร้าง คุณต้องสร้าง URL เต็มรูปแบบเอง นี่คือพาธบนบริการนี้:

วัตถุประสงค์เมธอดและ URL
แชทPOST https://api.getdeepseekapi.com/v1/chat/completions
API ResponsesPOST https://api.getdeepseekapi.com/v1/responses
รายการโมเดลGET https://api.getdeepseekapi.com/v1/models
ยอดเงินGET https://api.getdeepseekapi.com/v1/balance
ยอดเงิน สไตล์ OpenAIGET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants
curl https://api.getdeepseekapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

ใช้ HTTPS เท่านั้น การสตรีมมิงทำงานด้วย "stream": true ผ่านเหตุการณ์ที่ส่งจากเซิร์ฟเวอร์ และ URL เดียวกันรองรับทั้งสองโหมด

การกรอก URL ในแอปที่มีหน้าจอตั้งค่า

หน้าแชท แอปแก้ไข และเครื่องมืออัตโนมัติจำนวนมากมีตัวเลือก "custom OpenAI-compatible endpoint" ป้ายกำกับอาจแตกต่างกัน แต่ช่องกรอกข้อมูลจับคู่กันแบบหนึ่งต่อหนึ่ง:

ฟิลด์ในแอปค่า
API base, Base URL, เอนด์พอยต์, Server URLhttps://api.getdeepseekapi.com/v1
คีย์ API, โทเคน, รหัสลับคีย์ API ของคุณจากบริการนี้
โมเดล, ชื่อโมเดล, รหัสโมเดลuncensored

บางแอปต้องการ URL การแชทแบบเต็มแทนที่จะเป็น base ในกรณีนั้นให้ใช้ https://api.getdeepseekapi.com/v1/chat/completions หากแอปมีปุ่ม "ทดสอบการเชื่อมต่อ" ปุ่มนั้นมักจะเรียกใช้รายการโมเดล ซึ่งคือ GET /v1/models หากปุ่มล้มเหลวแต่การแชทด้วยตนเองใช้งานได้ การตรวจสอบของแอปเข้มงวดกว่า API และคุณสามารถเพิกเฉยได้

การทดสอบความถูกต้องอย่างรวดเร็วด้วย URL เพียงอย่างเดียว

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

curl -s https://api.getdeepseekapi.com/v1/models   -H "Authorization: Bearer $API_KEY"   # the chat model ID is uncensored

คุณควรได้รับ JSON กลับมาพร้อม data array หน้า HTML error หมายถึง host หรือ path ผิด เช่น ขาด subdomain: host ต้องขึ้นต้นด้วย api. ไม่ใช่ www.

การแก้ไขข้อผิดพลาดทั่วไป

  • 404 ไม่พบ Base URL ขาด /v1, มีสองครั้ง หรือรวมพาธของ endpoint ไว้ด้วย
  • 401 หรือข้อผิดพลาดการตรวจสอบสิทธิ์ คุณใช้คีย์จากบริการอื่น หรือเฮดเดอร์ขาด Bearer คีย์ไม่สามารถใช้ข้ามผู้ให้บริการได้
  • ไม่พบโมเดล คำขอยังคงระบุโมเดลจากผู้ให้บริการเดิม ตั้งค่า uncensored
  • แอปยังคงเชื่อมต่อกับบริการเดิม เครื่องมือบางตัวอาจแคชการตั้งค่าหรืออ่านตัวแปรอื่น ให้รีสตาร์ทกระบวนการและตรวจสอบหน้าจอการตั้งค่า
  • ปัญหาเครื่องหมายทับท้าย ไคลเอนต์ส่วนใหญ่จัดการได้ แต่หากตัวใดตัวหนึ่งไม่รองรับ ให้ลบเครื่องหมายทับสุดท้ายออกจาก Base URL

หากไม่แน่ใจว่าฝั่งใดเกิดข้อผิดพลาด ให้ส่งคำสั่ง curl ด้านบน การตอบกลับ 200 ยืนยันว่า URL คีย์ และโมเดลถูกต้อง ข้อผิดพลาดอื่นๆ เกิดขึ้นในแอปของคุณ เอกสาร ระบุขีดจำกัดและเฮดเดอร์เช่น X-Request-Id ซึ่งช่วยเมื่อติดต่อฝ่ายสนับสนุน

สิ่งที่คงเดิมหลังการเปลี่ยน

รูปแบบ request และ response ใช้รูปแบบ OpenAI ดังนั้น message arrays, temperature, top_p, stop, seed, penalties, การเรียกใช้ฟังก์ชัน และโหมด JSON จึงทำงานตามปกติ หน้าต่างบริบทคือ 100,000 โทเคนสำหรับพรอมต์รวมกับ completion และขนาด request body สูงสุดคือ 8 MB บริการเป็นข้อความเท่านั้น: ไม่มีภาพ, เสียง, embeddings หรือ fine-tuning ดังนั้นฟีเจอร์ที่สร้างจากสิ่งเหล่านี้ต้องใช้ผู้ให้บริการอื่น

การเรียกเก็บเงินแยกจากผู้ให้บริการเดิมเช่นกัน: $0.15 ต่อ 1M โทเคนอินพุต และ $0.50 ต่อ 1M โทเคนเอาต์พุตจากเครดิตแบบเติมเงินล่วงหน้า ตามที่แสดงใน หน้าราคา ผู้ใช้ใหม่สามารถรับเครดิตทดลองใช้ฟรี $0.50 เพื่อตรวจสอบว่าการเปลี่ยนทำงานได้ก่อนชำระเงิน

ถาม-ตอบ

Base URL ของ API ของ DeepSeek คืออะไร?

DeepSeek เผยแพร่ไว้ในเอกสารของตนเอง ดังนั้นโปรดตรวจสอบที่นั่นสำหรับค่าปัจจุบัน เอนด์พอยต์บนเว็บไซต์นี้คือบริการอื่นที่ https://api.getdeepseekapi.com/v1.

ฉันสามารถใช้คีย์ของ DeepSeek บนเอนด์พอยต์นี้ได้หรือไม่?

ไม่ได้ คีย์ออกให้ต่อบริการ รับคีย์สำหรับ API นี้ที่หน้าคีย์ และตั้งค่าโมเดลเป็น uncensored

ควร Base URL ลงท้ายด้วย /v1 หรือไม่?

ใช่สำหรับบริการนี้: https://api.getdeepseekapi.com/v1 SDK จะเพิ่มเส้นทางเอนด์พอยต์ต่อจาก URL นี้ ดังนั้นอย่าเพิ่ม /chat/completions ด้วยตนเอง

ทำไมฉันจึงได้ 404 หลังจากเปลี่ยน URL?

โดยปกติ path จะถูกทำซ้ำหรือขาด /v1 เปรียบเทียบ base URL ของคุณกับค่าที่ระบุด้านบน

คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว

สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด

รับคีย์ API