Hướng dẫn bắt đầu nhanh API Deep Seek
Ngừng chiến đấu với các khóa đăng ký và bộ lọc nội dung. Hướng dẫn này cho bạn thấy cách tích hợp LLM không kiểm duyệt của chúng tôi vào ngăn xếp của bạn bằng các công cụ tương thích chuẩn với OpenAI.
Xác thực & Base URL
Bắt đầu bằng cách đặt khóa API và URL cơ sở ngay lập tức. Khóa của bạn xuất hiện trên màn hình sau khi đăng ký bằng Google hoặc email. Sử dụng https://api.apiseekdeep.com/v1 làm điểm cuối cơ sở của bạn. Truyền khóa trong Authorization: Bearer header. Điều này hoạt động với bất kỳ SDK hoặc khách hàng tương thích OpenAI nào.
curl https://api.apiseekdeep.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Return the total row count for the user_logs table"}]
}'Yêu cầu của bạn xác thực trực tiếp với máy chủ của chúng tôi. Không có lớp định tuyến trung gian nào. Khóa của bạn chỉ cấp quyền truy cập vào mô hình không kiểm duyệt.
Endpoint Hoàn thành Trò chuyện
Gửi tin nhắn đến POST /v1/chat/completions để tạo văn bản. Sử dụng model id uncensored để đầu ra không giới hạn. Văn bản đầu vào được đưa vào mảng messages. API trả về văn bản được tạo trong trường nội dung phản hồi. Điều này tuân theo định dạng trò chuyện chuẩn của OpenAI chính xác.
from openai import OpenAI
client = OpenAI(base_url="https://api.apiseekdeep.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)Giữ các lời nhắc của bạn có cấu trúc. Mô hình xử lý ngữ cảnh tốt trong giới hạn. Bạn nhận được đầu ra văn bản thô mà không có các lớp định dạng bổ sung. Lỗi trả về các mã HTTP tiêu chuẩn.
Phản hồi luồng (SSE)
Bật phát trực tiếp bằng cách đặt stream: true trong yêu cầu của bạn. Bạn nhận được Sự kiện được gửi bởi máy chủ (SSE) khi các token được tạo. Điều này giảm độ trễ cảm nhận cho các đầu ra dài. Chi tiết sử dụng token xuất hiện trong chunk cuối cùng. Bạn có thể dừng quá trình tạo sớm nếu cần.
stream = 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)Xử lý gracefully các phản hồi từng phần. Đệm token cho đến khi hoàn tất. Phương pháp này tiết kiệm thời gian chờ cho các cửa sổ ngữ cảnh lớn. Nó hoạt động đáng tin cậy với giới hạn ngữ cảnh 100,000 token của chúng tôi.
Gọi hàm & Công cụ
Định nghĩa các công cụ trong thân yêu cầu để lấy đầu ra có cấu trúc. Mô hình có thể gọi các hàm dựa trên lược đồ của bạn. Truyền định nghĩa công cụ trong tools mảng. Sử dụng tool_choice để bắt buộc hoặc cho phép chọn tự động. Điều này cho phép các quy trình phức tạp mà không cần phân tích văn bản thô.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.apiseekdeep.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);Cẩn thận trong việc cấu trúc các lược đồ JSON của bạn. Mô hình tôn trọng các ràng buộc công cụ. Bạn xử lý logic thực thi hàm riêng biệt. Điều này giữ cho mã của bạn sạch sẽ và mô-đun.
Cấu hình Chế độ JSON
Buộc đầu ra JSON nghiêm ngặt bằng cách sử dụng response_format: {"type": "json_object"}Mô hình chỉ trả về các cấu trúc JSON hợp lệ. Sử dụng điều này cho việc trích xuất dữ liệu hoặc các đường ống dữ liệu có cấu trúc. Tắt định dạng markdown để phân tích cú pháp sạch hơn. Điều này đảm bảo việc tiêu thụ kết quả một cách đáng tin cậy bởi các chương trình.
curl https://api.apiseekdeep.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Return the total row count for the user_logs table"}]
}'Xác nhận đầu ra trước khi xử lý. Chế độ nghiêm ngặt giảm ảo giác trong các trường. Kết hợp điều này với định nghĩa công cụ để có độ tin cậy tối đa. Các ứng dụng phía sau của bạn sẽ phân tích cú pháp dữ liệu nhanh hơn.
Tham số: Nhiệt độ, Top P, Seed
Kiểm soát sự sáng tạo với temperature và top_p. Các giá trị cao hơn làm tăng tính ngẫu nhiên. Các giá trị thấp hơn làm cho các đầu ra trở nên xác định. Sử dụng seed để có kết quả có thể tái lập trong quá trình gỡ lỗi. Đặt max_tokens để giới hạn độ dài đầu ra. Mặc định là 2.048 token nếu không đặt.
from openai import OpenAI
client = OpenAI(base_url="https://api.apiseekdeep.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)Điều chỉnh các tham số cho trường hợp sử dụng của bạn. Nhập vai được hưởng lợi từ nhiệt độ cao hơn. Các nhiệm vụ dữ liệu cần các giá trị thấp hơn. Tín dụng trả trước của bạn được tính dựa trên các token thực tế được sử dụng. Lỗi không tốn phí tín dụng.
Câu hỏi thường gặp
Khóa API của deep seek có hoạt động với các SDK chính thức không?
Có. Base URL và định dạng phản hồi của chúng tôi khớp chính xác với đặc tả của OpenAI. Bạn có thể sử dụng các SDK Python, Node hoặc Go chính thức của OpenAI bằng cách chỉ thay đổi base URL và API key. Không cần các wrapper tùy chỉnh.
Điều gì xảy ra nếu tôi chạm giới hạn tốc độ?
Bạn sẽ nhận được lỗi 429 Too Many Requests. Giới hạn của chúng tôi là 300 yêu cầu mỗi phút mỗi khóa. Bạn có thể chạy 8 yêu cầu đồng thời cùng lúc. Chờ vài giây và thử lại. Số dư trả trước của bạn vẫn không bị ảnh hưởng trong các lỗi giới hạn tốc độ.
Cửa sổ ngữ cảnh hoạt động ra sao?
Bạn nhận được cửa sổ ngữ cảnh 100.000 token cho cả đầu vào và đầu ra kết hợp. Đầu ra tối đa cho mỗi yêu cầu là 16.000 token. Nếu bạn không chỉ định max_tokens, mặc định là 2.048 token. Điều này cho phép lịch sử hội thoại sâu hoặc xử lý tài liệu lớn.
Lấy khóa API của bạn
Đăng ký, lấy khóa, cập nhật endpoint của bạn. Cấu hình đơn giản.
Lấy khóa của bạn