Hướng dẫn Tích hợp cho Nhà phát triển

Base URL và Xác thực

Bắt đầu bằng cách trỏ client của bạn đến URL cơ sở của chúng tôi và cung cấp khóa API của bạn trong tiêu đề authorization. Điều này hoạt động với bất kỳ SDK tương thích OpenAI nào vì chúng tôi tuân thủ đúng giao thức tiêu chuẩn. Tạo khóa của bạn ngay lập tức qua Google hoặc email trên trang Lấy khóa API; không cần số điện thoại. Giữ khóa của bạn an toàn và sử dụng một khóa hoạt động cho mỗi tài khoản vì việc tạo khóa mới sẽ thay thế khóa cũ.

Xác thực rất đơn giản. Gửi khóa của bạn trong Authorization header cho mọi yêu cầu. Hệ thống của chúng tôi xác thực khóa trước khi xử lý token, đảm bảo chỉ các tài khoản được ủy quyền mới sử dụng tín dụng. Lỗi như khóa bị thiếu trả về trạng thái 401 ngay lập tức.

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

Gửi một yêu cầu hoàn tất hội thoại tiêu chuẩn để kiểm tra kết nối và chất lượng phản hồi. Cuộc gọi đơn giản này xác minh khóa của bạn và tín dụng tài khoản của bạn chính xác. ID mô hình là uncensored, xử lý đầu vào và đầu ra văn bản mà không có từ chối nội dung cho mục đích người trưởng thành hợp pháp. Thay thế chỗ giữ chỗ bằng khóa thực tế và system prompt của bạn.

Copycurl https://api.deepseekapicost.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 1 million tokens"}]
  }'

Lệnh curl này minh họa cấu trúc tối thiểu cần thiết. Bạn có thể điều chỉnh messages mảng để bao gồm ngữ cảnh hoặc hướng dẫn. Phản hồi trả về văn bản được tạo trong content trường. Hãy kiểm tra các thống kê sử dụng trong các tiêu đề phản hồi để theo dõi mức tiêu thụ token của bạn.

SDK Python

Sử dụng thư viện Python chính thức của OpenAI để tích hợp API của chúng tôi vào các tập lệnh hoặc ứng dụng. Đặt base_url và api_key các thuộc tính trước khi thực hiện các lệnh gọi. Cách tiếp cận này đảm bảo tương thích với các cơ sở mã hiện có đã sử dụng các mô hình OpenAI. Bạn có thể chuyển đổi giữa các nhà cung cấp bằng cách chỉ thay đổi hai dòng cấu hình.

Copyfrom openai import OpenAI

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

Đoạn mã Python ở trên cho thấy cách khởi tạo máy khách và gửi yêu cầu. Thư viện xử lý tuần tự hóa JSON và phân tích phản hồi một cách tự động. Bạn có thể truy cập đối tượng phản hồi để trích xuất nội dung, thống kê sử dụng và lý do kết thúc. Phương pháp này lý tưởng cho các dịch vụ backend hoặc quy trình xử lý dữ liệu.

SDK Node

Tích hợp API của chúng tôi vào các ứng dụng Node.js bằng cách sử dụng openai gói npm. Cấu hình máy khách với URL cơ sở của chúng tôi và khóa API của bạn giống như bạn sẽ làm với OpenAI. Điều này cho phép bạn sử dụng cùng cấu trúc mã cho cả thử nghiệm và sản xuất. SDK hỗ trợ các hoạt động không đồng bộ cho các yêu cầu không chặn.

Copyimport OpenAI from "openai";

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

Ví dụ Node.js này minh họa việc gửi một yêu cầu hoàn tất cuộc trò chuyện. Các await từ khóa đảm bảo phản hồi được nhận đầy đủ trước khi tiếp tục. Bạn có thể xử lý lỗi bằng các khối try-catch để quản lý các vấn đề mạng hoặc giới hạn API một cách duyên dáng. Đối tượng phản hồi chứa văn bản được tạo và chi tiết sử dụng token.

Phát trực tiếp

Bật chế độ streaming để nhận phản hồi token từng token một nhằm cải thiện trải nghiệm người dùng trong các giao diện trò chuyện. Đặt stream tham số thành true trong yêu cầu của bạn. API trả về các chunk văn bản khi chúng được tạo, cho phép bạn hiển thị kết quả đầu ra theo thời gian thực. Điều này giảm đáng kể độ trễ cảm nhận cho người dùng cuối.

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)

Mã stream ở trên xử lý từng chunk khi nó đến. Bạn có thể nối nội dung vào một phần tử UI ngay lập tức. Chunk cuối cùng chứa thống kê sử dụng token tổng cộng. Tính năng này được hỗ trợ bởi tất cả các client tương thích OpenAI xử lý đúng phản hồi SSE.

Giới hạn, Lỗi và Cửa sổ ngữ cảnh

API của chúng tôi áp dụng các giới hạn nghiêm ngặt để đảm bảo việc sử dụng công bằng và ổn định hệ thống. Bạn được phép 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời mỗi khóa. Mỗi thân yêu cầu không được vượt quá 8 MB. Nếu vượt quá các giới hạn này, API sẽ trả về mã trạng thái 429. Hãy đợi vài giây và thử lại yêu cầu của bạn. Các lỗi như khóa không hợp lệ trả về 401, và không đủ số dư trả về 402.

Cửa sổ ngữ cảnh hỗ trợ tối đa 100,000 token cho cả đầu vào và đầu ra kết hợp. Lượng output tối đa mỗi yêu cầu là 16,000 token, hoặc 2,048 nếu bạn không chỉ định max_tokens. Cửa sổ lớn này cho phép bạn xử lý các tài liệu dài hoặc duy trì lịch sử hội thoại rộng rãi mà không bị cắt ngắn. Lỗi và từ chối không tiêu thụ tín dụng, vì vậy bạn chỉ trả tiền cho việc sử dụng thực tế.