Hướng dẫn Tích hợp: khóa 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. Đặt URL cơ sở thành https://api.deepseekcoderapikey.com/v1 trong cấu hình máy khách của bạn. URL này xử lý cả hai điểm cuối hoàn thành trò chuyện và mô hình mà không yêu cầu các phân đoạn đường dẫn bổ sung. Bạn nhận được một khóa duy nhất cho mỗi tài khoản và việc tạo khóa mới sẽ thay thế khóa trước đó ngay lập tức.

Lưu khóa trong một biến môi trường có tên là DEEPSEEK_API_KEY hoặc truyền nó trực tiếp đến client SDK của bạn. Điểm cuối chấp nhận các tiêu đề tiêu chuẩn, vì vậy bạn có thể chuyển đổi nhà cung cấp bằng cách chỉ thay đổi URL cơ sở và giá trị khóa. Cách tiếp cận này hoạt động với Cursor, các tiện ích mở rộng VS Code và các công cụ phát triển cục bộ yêu cầu giao diện tương thích OpenAI.

Xác thực thất bại với mã trạng thái 401 nếu khóa bị thiếu hoặc không hợp lệ. Sử dụng

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

ví dụ để xác minh kết nối trước khi tích hợp vào logic ứng dụng của bạn.

Endpoint Hoàn thành Trò chuyện (POST)

Gửi tin nhắn đến POST /v1/chat/completions endpoint sử dụng ID mô hình uncensored. Điểm cuối này xử lý đầu vào văn bản và trả về đầu ra văn bản, hỗ trợ cả phản hồi đồng bộ và stream. Bạn có thể cấu hình hành vi của mô hình bằng các tham số như temperature, top_p và các chuỗi dừng.

Cửa sổ ngữ cảnh cho phép lên đến 100.000 token cho prompt và completion kết hợp. Nếu bạn không chỉ định giới hạn max_tokens, mô hình mặc định là 2.048 token cho mỗi yêu cầu. Sử dụng

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekcoderapikey.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ã để xem cách cấu trúc một yêu cầu trò chuyện tiêu chuẩn với SDK Python chính thức của OpenAI.

Các lỗi như không đủ tiền sẽ trả về mã trạng thái 402, trong khi các yêu cầu không hợp lệ sẽ trả về 400. Kiểm tra thân phản hồi để có thông báo lỗi chi tiết giúp bạn gỡ lỗi cấu trúc tải trọng một cách nhanh chóng.

Điểm cuối Models (GET)

Truy vấn các mô hình khả dụng bằng cách gửi một GET /v1/models yêu cầu. Điểm cuối này trả về một danh sách các đối tượng mô hình, bao gồm uncensored model ID. Bạn có thể sử dụng endpoint này để xác minh rằng API key của bạn hợp lệ và dịch vụ đang trực tuyến trước khi thực hiện các yêu cầu sử dụng nặng.

Phản hồi bao gồm các siêu dữ liệu như ID mô hình, loại đối tượng và thông tin sở hữu. Hãy sử dụng dữ liệu này để cấu hình động ứng dụng của bạn hoặc ghi lại các mô hình khả dụng để gỡ lỗi. Điểm cuối này không yêu cầu thân yêu cầu, chỉ cần tiêu đề xác thực chuẩn.

Việc tích hợp bước kiểm tra này vào quy trình khởi động của bạn đảm bảo rằng ứng dụng của bạn sẽ dừng nhanh nếu API không thể truy cập được. Nó cũng giúp bạn xác minh rằng URL cơ sở được cấu hình chính xác trước khi tiếp tục với các lệnh hoàn thành trò chuyện thực tế.

Phản hồi luồng (SSE)

Bật chế độ streaming bằng cách đặt stream tham số thành true trong yêu cầu của bạn. API trả về luồng Sự kiện gửi bởi máy chủ (SSE), cung cấp từng token khi chúng được tạo. Cách tiếp cận này giảm độ trễ cảm nhận cho các trợ lý mã hóa và cho phép cập nhật giao diện người dùng theo thời gian thực trong ứng dụng của bạn.

Mỗi khối chứa nội dung một phần, và khối cuối cùng bao gồm thống kê sử dụng mã thông báo tổng thể. Phân tích luồng SSE cẩn thận để xử lý các gián đoạn mạng và đệm các mã thông báo một phần. Cá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)

ví dụ minh họa cách xử lý luồng trong JavaScript.

Streaming rất lý tưởng cho việc tạo mã nguồn dạng dài hoặc các giải thích chi tiết. Nó mang lại trải nghiệm người dùng mượt mà hơn so với việc đợi toàn bộ phản hồi. Đảm bảo client của bạn xử lý đúng sự kiện kết thúc luồng để hoàn tất phản hồi.

Function Calling và chế độ JSON

Sử dụng gọi hàm để cho phép mô hình gọi các công cụ bên ngoài. Định nghĩa các hàm của bạn trong tools tham số và chỉ định tool_choice để kiểm soát thời điểm mô hình sử dụng chúng. API hỗ trợ các định nghĩa công cụ tiêu chuẩn, cho phép bạn tích hợp với các dịch vụ backend của riêng mình.

Đối với các đầu ra có cấu trúc, hãy kích hoạt chế độ JSON bằng cách đặt response_format để json_object. Điều này buộc mô hình trả về JSON hợp lệ, hữu ích cho việc phân tích cú pháp dữ liệu cấu hình hoặc phản hồi API. The

Copyimport OpenAI from "openai";

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

đoạn mã hiển thị cách cấu hình chế độ JSON trong Node.js.

Kết hợp gọi hàm với streaming cho việc sử dụng công cụ tương tác. Mô hình có thể gọi nhiều công cụ trong một lượt, cho phép các quy trình làm việc nhiều bước phức tạp. Đảm bảo máy khách của bạn xử lý đầu ra công cụ đúng cách để duy trì ngữ cảnh cuộc trò chuyện.

Giới hạn tốc độ và Ràng buộc

Khóa API của bạn bị giới hạn ở 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời. Kích thước tối đa của thân yêu cầu là 8 MB. Nếu bạn vượt quá các giới hạn này, API sẽ trả về lỗi 429 Quá nhiều yêu cầu. Hãy triển khai cơ chế backoff theo cấp số nhân trong máy khách của bạn để xử lý giới hạn tốc độ một cách duyên dáng.

Lỗi như 401 cho biết khóa không hợp lệ, trong khi 402 cho biết tín dụng không đủ. Hoàn tiền không được cấp cho tín dụng, nhưng các khoản tính phí kép có thể được giải quyết qua trang Hỗ trợ. Tín dụng không bao giờ hết hạn, vì vậy bạn có thể nạp tiền khi thuận tiện.

Cửa sổ ngữ cảnh 100.000 token áp dụng cho tổng lời nhắc và phần hoàn thành. Hãy theo dõi việc sử dụng token để duy trì trong ngân sách. Sử dụng hệ thống tín dụng trả trước để chỉ trả những gì bạn sử dụng, không có phí hàng tháng hoặc đăng ký.