Hướng dẫn nhanh cho người dùng DeepSeek

URL cơ sở và Xác thực

Để sử dụng API của chúng tôi, hãy trỏ ứng dụng khách của bạn đến https://api.deepseekapi.top/v1. Bạn không cần thay đổi các đường dẫn endpoint; đường dẫn tiêu chuẩn /v1/chat/completions hoạt động chính xác như mong đợi. Xác thực dựa trên một khóa API duy nhất được tạo khi đăng ký. Hãy truyền khóa này trong tiêu đề Authorization dưới dạng token Bearer. Nếu khóa bị thiếu hoặc không hợp lệ, máy chủ sẽ trả về lỗi 401. Hãy đảm bảo các biến môi trường của bạn được đặt đúng trước khi thực hiện yêu cầu đầu tiên.

• URL cơ sở: https://api.deepseekapi.top/v1
• Tiêu đề Xác thực: Authorization: Bearer YOUR_API_KEY

Sao chépcurl https://api.deepseekapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Endpoint Chat Completions

API của chúng tôi chấp nhận các yêu cầu hoàn thành hội thoại tiêu chuẩn. Gửi yêu cầu POST đến /v1/chat/completions với ID mô hình là uncensored. Mô hình phản hồi với đầu vào văn bản và tạo đầu ra văn bản mà không áp dụng các bộ lọc nội dung thường thấy ở DeepSeek chính thức hoặc các nhà cung cấp lớn khác. Điều này rất lý tưởng cho viết sáng tạo, nhập vai hoặc xử lý dữ liệu không giới hạn. Bạn có thể kiểm soát hành vi bằng các tham số như temperature và top_p. Phản hồi bao gồm văn bản được tạo và thống kê sử dụng token.

Hãy nhớ rằng mô hình không phải là GPT, Claude hoặc bất kỳ mô hình của nhà cung cấp nào khác. Đây là một mô hình trọng số mở độc lập được tinh chỉnh cho việc sử dụng không giới hạn hợp pháp. Hãy xem trang giá để biết chi phí token.

Sao chépfrom openai import OpenAI

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

Tích hợp SDK Node.js

Đối với nhà phát triển Node.js, quy trình này giống hệt với các tích hợp OpenAI tiêu chuẩn. Khởi tạo máy khách bằng base URL và khóa API cụ thể của bạn. Đặt mô hình thành uncensored trong cấu hình của bạn. SDK xử lý vòng đời yêu cầu, bao gồm cả việc thử lại và xử lý lỗi, giống như nó sẽ làm đối với bất kỳ dịch vụ tương thích OpenAI nào. Điều này cho phép bạn tái sử dụng các cơ sở mã hiện có với ít ma sát nhất. Đảm bảo bạn đang sử dụng phiên bản mới nhất của gói npm openai để tương thích đầy đủ.

API hỗ trợ cả các cuộc gọi đồng bộ và không đồng bộ. Bạn có thể truyền các thông báo theo định dạng mảng messages tiêu chuẩn. Cấu trúc phản hồi khớp với đặc tả API OpenAI, giúp việc di chuyển trở nên đơn giản.

Sao chépimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekapi.top/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ản hồi truyền phát

Bật truyền phát bằng cách đặt stream: true trong yêu cầu của bạn. API trả về luồng Sự kiện do Máy chủ gửi (SSE). Mỗi phần chứa một phản hồi một phần, cho phép bạn hiển thị văn bản khi nó được tạo. Dữ liệu sử dụng token chỉ được bao gồm trong phần cuối cùng của luồng, không phải trong mọi phần. Thiết kế này giảm kích thước tải trong khi vẫn cung cấp các chỉ số tính phí chính xác. Bạn không cần cấu hình stream_options đặc biệt để lấy dữ liệu sử dụng; nó được cung cấp tự động vào cuối.

Xử lý các sự kiện luồng để cập nhật giao diện người dùng của bạn theo thời gian thực. Luồng kết thúc khi mô hình hoàn thành phản hồi hoặc đạt giới hạn.

Sao chépstream = 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)

Gọi hàm và Chế độ JSON

API hỗ trợ gọi hàm thông qua các tham số tools và tool_choice. Xác định các hàm của bạn trong yêu cầu, và mô hình sẽ trả về các cuộc gọi công cụ có cấu trúc. Bạn cũng có thể buộc đầu ra JSON nghiêm ngặt bằng cách đặt response_format thành {"type": "json_object"}. Điều này hữu ích để tạo dữ liệu có cấu trúc mà không bị lỗi phân tích cú pháp. Mô hình được tinh chỉnh để tuân thủ các hướng dẫn này một cách đáng tin cậy.

Kết hợp gọi hàm với truyền phát cho các tương tác động. API duy trì ngữ cảnh qua nhiều lượt, cho phép các quy trình làm việc nhiều bước phức tạp. Hãy đảm bảo các định nghĩa hàm của bạn rõ ràng và có cấu trúc tốt để có kết quả tốt nhất.

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

Cửa sổ ngữ cảnh của bạn là 100.000 token, bao gồm prompt và phần hoàn thành. Đầu ra tối đa là 32.000 token mỗi yêu cầu, hoặc 2.048 nếu bạn không đặt max_tokens. Giới hạn tốc độ là 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời mỗi khóa. Nếu bạn vượt quá những giới hạn này, bạn sẽ nhận được lỗi 429. Lỗi 401 cho biết khóa không hợp lệ, trong khi lỗi 402 có nghĩa là tín dụng trả trước của bạn đã hết. Các lỗi và từ chối không tiêu thụ token. Các yêu cầu được giới hạn ở thân 8 MB. Đăng ký bằng Google hoặc email để nhận khóa của bạn ngay lập tức.