Tài liệu API cho nhà phát triển

Base URL và Xác thực

Bắt đầu bằng cách thay đổi URL cơ sở thành điểm cuối chuyên dụng của chúng tôi và chuyển khóa API của bạn trong tiêu đề Authorization. Chúng tôi không sử dụng URL cơ sở OpenAI tiêu chuẩn; bạn phải trỏ SDK của mình đến https://api.deepseektokenplan.com/v1. Điều này đảm bảo các yêu cầu của bạn được định tuyến qua cơ sở hạ tầng mô hình không kiểm duyệt của chúng tôi thay vì một proxy bên thứ ba. ID mô hình bạn chỉ định trong thân yêu cầu là "uncensored", kích hoạt các trọng số đã tinh chỉnh cụ thể trên máy chủ của chúng tôi. Xác thực dựa trên lược trình Bearer token đơn giản, hoạt động với bất kỳ thư viện khách hàng tương thích OpenAI nào. Khóa của bạn được tạo ngay lập tức khi đăng ký qua Google hoặc email, không cần số điện thoại. Hãy giữ khóa này an toàn, vì nó liên kết trực tiếp với số dư tín dụng trả trước của bạn.

Yêu cầu đầu tiên

Gửi yêu cầu hoàn thành trò chuyện tiêu chuẩn bằng cURL để xác minh cài đặt và khả dụng của mô hình. Yêu cầu POST đơn giản này minh họa cách API chấp nhận lời nhắc hệ thống và tin nhắn người dùng của bạn. Bạn có thể điều chỉnh các tham số nhiệt độ và top_p để kiểm soát mức độ sáng tạo. Phản hồi trả về văn bản được tạo cùng với thống kê sử dụng token để minh bạch hóa việc thanh toán. Đảm bảo thân yêu cầu của bạn bao gồm định danh mô hình chính xác và khóa API của bạn trong tiêu đề. Phương pháp này hoạt động cho cả tạo văn bản và gọi hàm. Sử dụng lệnh này để xác nhận kết nối trước khi tích hợp vào ứng dụng của bạn. Điểm cuối hỗ trợ chế độ phát trực tiếp và không phát trực tiếp đều tốt.

Tích hợp SDK Python

Sử dụng thư viện Python chính thức của OpenAI để tương tác với API của chúng tôi bằng cách cấu hình base URL và API key. Khởi tạo client với thông tin đăng nhập của bạn và gọi phương thức chat completions với ID model mong muốn của bạn. Cách tiếp cận này cho phép bạn tận dụng các codebase hiện có được xây dựng cho OpenAI mà không cần tái cấu trúc lớn. Bạn có thể stream phản hồi hoặc nhận toàn bộ văn bản cùng một lúc. Thư viện tự động xử lý serialization JSON và các yêu cầu HTTP. Cấu hình cài đặt thời gian chờ và thử lại tùy theo trường hợp sử dụng cụ thể của bạn. Phương pháp này lý tưởng cho các dịch vụ backend và các đường ống xử lý dữ liệu. Đảm bảo bạn cập nhật base URL để trỏ đến điểm cuối cụ thể của chúng tôi.

Tích hợp SDK Node

Tích hợp API vào các ứng dụng JavaScript hoặc TypeScript của bạn bằng gói Node OpenAI. Đặt base URL và API key trong cấu hình client trước khi thực hiện bất kỳ yêu cầu nào. Thiết lập này cho phép bạn sử dụng các phương thức quen thuộc như chat.completions.create() với mô hình không kiểm duyệt của chúng tôi. Bạn có thể truyền các tham số như nhiệt độ và chuỗi dừng để tinh chỉnh đầu ra. SDK xử lý các phản hồi streaming một cách hiệu quả cho các ứng dụng thời gian thực. Sử dụng phương pháp này cho máy chủ web hoặc công cụ dòng lệnh. Đảm bảo bạn nhập các mô-đun cần thiết và định cấu hình các biến môi trường đúng cách. Phương pháp này hỗ trợ cả mẫu yêu cầu đồng bộ và bất đồng bộ.

Streaming và Tokens

Bật chế độ streaming để nhận các phản hồi một phần ngay khi chúng được tạo ra, cải thiện trải nghiệm người dùng cho các giao diện trò chuyện. API sử dụng Server-Sent Events (SSE) để phân phối token theo thời gian thực. Bạn có thể theo dõi việc sử dụng token trong chunk cuối cùng của luồng để tính phí chính xác. Tính năng này được hỗ trợ bởi tất cả các SDK chính và có thể được triển khai thủ công nếu cần. Streaming giảm độ trễ cảm nhận cho các phản hồi dài. Đặt stream tham số thành true trong thân yêu cầu của bạn. API trả về thống kê sử dụng trong sự kiện cuối cùng, cho phép bạn khấu trừ đúng số tiền từ khoản tín dụng trả trước của bạn. Phương pháp này rất cần thiết cho các ứng dụng yêu cầu phản hồi ngay lập tức.

Giới hạn và Xử lý lỗi

Theo dõi các giới hạn tốc độ và xử lý lỗi một cách duyên dáng để đảm bảo kết nối ổn định. API cho phép 300 yêu cầu mỗi phút cho mỗi khóa và 8 yêu cầu đồng thời. Mỗi thân yêu cầu không được vượt quá 8 MB. Nếu bạn gửi khóa không hợp lệ, bạn sẽ nhận được lỗi 401 Unauthorized. Lỗi 402 cho biết thiếu tín dụng trả trước, yêu cầu bạn nạp tiền bằng tiền điện. Lỗi 429 có nghĩa là bạn đã vượt quá giới hạn tốc độ; hãy đợi và thử lại. Cửa sổ ngữ cảnh là 100.000 token cho yêu cầu và hoàn thành kết hợp. Đầu ra tối đa là 16.000 token trừ khi bạn chỉ định mức thấp hơn max_tokens giá trị. Luôn kiểm tra mã trạng thái và thân phản hồi để biết các thông báo lỗi chi tiết.

cURL

Copycurl https://api.deepseektokenplan.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate total monthly cost for 50 million tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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

Phát trực tiếp

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)