Bắt đầu nhanh: Tích hợp API DeepSeek Coder

Base URL và Xác thực

Khóa API của bạn xác thực mọi yêu cầu đến endpoint được lưu trữ của chúng tôi. Sử dụng URL cơ sở https://api.coderdeepseek.cc/v1 với bất kỳ SDK OpenAI hoặc máy khách HTTP nào. Định danh mô hình là nghiêm ngặt uncensored. Dịch vụ chạy trên máy chủ riêng của chúng tôi và không phải là mô hình của nhà cung cấp khác. Bạn nhận được khóa API ngay lập tức khi đăng ký qua Google hoặc email. Hãy giữ khóa này an toàn vì nó kiểm soát số dư tài khoản trả trước của bạn.

Xác thực dựa trên Authorization header. Truyền khóa của bạn dưới dạng mã thông báo Bearer. Mọi yêu cầu đều phải bao gồm tiêu đề này để tránh lỗi 401 lỗi. Chúng tôi không sử dụng tham số truy vấn để xác thực. Điều này đảm bảo tiêu đề sạch sẽ và tương thích với middleware tiêu chuẩn.

Gửi yêu cầu: Chat Completions

Điểm cuối hoàn thành trò chuyện xử lý các lệnh prompt của bạn và trả về các đầu ra văn bản. Gửi yêu cầu POST đến /v1/chat/completions. Bao gồm tên mô hình, mảng messages và các tham số mong muốn của bạn. Hệ thống xử lý văn bản đầu vào và trả về văn bản đầu ra. Bạn có thể kiểm soát định dạng phản hồi và các tiêu chí dừng. Điều này hoạt động cho cả các truy vấn đơn giản và các tác vụ mã hóa phức tạp.

Sử dụng lệnh curl sau để kiểm tra kết nối của bạn. Thay thế YOUR_API_KEY với khóa thực tế của bạn. Yêu cầu sử dụng uncensored model identifier. Điều này xác nhận xác thực và số dư tín dụng của bạn đang hoạt động.

Copycurl https://api.coderdeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the library"}]
  }'

Xác minh phản hồi chứa choices mảng. Mỗi lựa chọn bao gồm một tin nhắn với nội dung được tạo. Kiểm tra usage object để lấy số lượng token. Điều này giúp bạn theo dõi chi tiêu của mình một cách chính xác.

Tích hợp SDK Python

Tích hợp API vào các dự án Python bằng gói OpenAI chính thức. Đặt URL cơ sở đến điểm cuối của chúng tôi. Khởi tạo client với khóa API của bạn. Điều này cho phép bạn sử dụng các phương thức quen thuộc như chat.completions.create. SDK tự động xử lý tuần tự hóa JSON và các yêu cầu HTTP.

Cấu hình mô hình thành uncensored. Truyền tin nhắn của bạn theo định dạng tiêu chuẩn. SDK hỗ trợ tất cả các tính năng của chúng tôi bao gồm gọi hàm và chế độ JSON. Bạn có thể đặt các tham số như temperature và top_p trực tiếp. Điều này giúp việc di chuyển từ các nhà cung cấp khác trở nên dễ dàng.

Copyfrom openai import OpenAI

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

Xử lý ngoại lệ cho các lỗi mạng hoặc yêu cầu không hợp lệ. Kiểm tra mã trạng thái nếu bạn phân tích phản hồi thô. Điều này đảm bảo xử lý lỗi mạnh mẽ trong ứng dụng của bạn. SDK trừu tượng hóa hầu hết sự phức tạp.

Tích hợp SDK Node

Sử dụng SDK OpenAI Node.js để tích hợp với các dự án JavaScript hoặc TypeScript của bạn. Cài đặt gói và cấu hình URL cơ sở. Điều này duy trì tương thích với cấu trúc mã hiện có của bạn. Bạn có thể sử dụng cùng các phương thức như trong Python. SDK hỗ trợ cả CommonJS và các mô-đun ES.

Đặt mô hình thành uncensored. Truyền tin nhắn và tham số của bạn. SDK xử lý các yêu cầu phát trực tiếp và không phát trực tiếp. Bạn có thể bắt lỗi và ghi log thích hợp. Điều này đảm bảo ứng dụng của bạn vẫn ổn định dưới tải.

Copyimport OpenAI from "openai";

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

Kiểm tra tích hợp của bạn với một prompt đơn giản. Xác minh rằng phản hồi khớp với kỳ vọng của bạn. Kiểm tra việc sử dụng token trong đối tượng phản hồi. Điều này giúp bạn theo dõi chi phí và hiệu suất. SDK giúp bạn lặp lại nhanh chóng.

Phản hồi luồng và sử dụng token

Bật phát trực tiếp bằng cách đặt stream: true trong yêu cầu của bạn. API trả về luồng Sự kiện gửi máy chủ (SSE). Bạn nhận được các chunk văn bản ngay khi chúng được tạo. Điều này giảm độ trễ cảm nhận đối với các phản hồi dài. Chunk cuối cùng chứa tổng số token đã sử dụng.

Phân tích các sự kiện SSE để trích xuất nội dung. Nối các chunk để tạo thành phản hồi hoàn chỉnh. Theo dõi usage object trong chunk cuối cùng. Điều này cung cấp cho bạn số lượng token chính xác để tính phí. Phát trực tiếp rất lý tưởng cho các ứng dụng thời gian thực.

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)

Xử lý các gián đoạn mạng một cách khéo léo. Kết nối lại nếu luồng bị ngắt. API không gửi lại các phần trước đó. Bạn phải xây dựng lại văn bản đầy đủ ở phía máy khách. Điều này mang lại trải nghiệm người dùng mượt mà.

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 tính ổn định. Bạn có thể thực hiện 300 yêu cầu mỗi phút mỗi khóa. Tối đa 8 yêu cầu có thể chạy đồng thời. Thân yêu cầu không được vượt quá 8 MB. Vượt quá các giới hạn này sẽ dẫn đến lỗi 429 lỗi giới hạn tốc độ. Xử lý các lỗi này bằng cách tăng dần độ trễ (exponential backoff).

Cửa sổ ngữ cảnh là 100,000 token. Điều này bao gồm cả prompt và completion. Output tối đa là 16,000 token cho mỗi request. Nếu bạn không đặt max_tokens, nó mặc định là 2.048. A 401 lỗi có nghĩa là khóa của bạn không hợp lệ. Một 402 lỗi có nghĩa là bạn không có số dư. Nạp tiền bằng tiền điện tử để tiếp tục sử dụng dịch vụ.