Cách thức đến Tích hợp API DeepSeek

Điều kiện tiên quyết: Thiết lập Môi trường

Bắt đầu bằng cách đảm bảo môi trường phát triển của bạn đã cài đặt SDK cần thiết. Bạn cần một môi trường chạy ngôn ngữ như Python hoặc Node.js và một cách để lưu trữ thông tin xác thực API của bạn một cách an toàn. Quy trình thiết lập này giống hệt với việc sử dụng bất kỳ dịch vụ tương thích OpenAI nào khác.

Bạn không cần cài đặt trình điều khiển cụ thể của nhà cung cấp. Proxy xử lý tất cả suy luận mô hình, vì máy của bạn chỉ cần gửi các yêu cầu HTTP và phân tích phản hồi JSON. Điều này giảm chi phí phụ thuộc và giữ cho dự án của bạn nhẹ nhàng.

Cài đặt SDK Chính thức

Cài đặt SDK chính thức cho ngôn ngữ ưa thích của bạn để xử lý xác thực và tuần tự hóa. Đối với Python, sử dụng pip install openai. Đối với Node.js, chạy npm install openai. Thư viện này quản lý các kết nối HTTP cơ bản.

SDK trừu tượng hóa độ phức tạp khi tạo các payload JSON. Bạn có thể tập trung vào việc xác định prompt và xử lý các token trả về. Sự chuẩn hóa này có nghĩa là bạn có thể chuyển đổi nhà cung cấp sau này chỉ bằng cách thay đổi URL cơ sở.

Copyfrom openai import OpenAI

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

Cấu hình URL cơ sở và Khóa

Điểm SDK client của bạn đến URL gốc proxy và đưa khóa API của bạn vào. Bước cấu hình này định hướng lưu lượng truy cập tránh xa các máy chủ OpenAI tiêu chuẩn. Bạn phải đặt base_url để https://api.deepseekpago.com/v1.

Đặt khóa của bạn qua api_key tham số. Khóa này được tạo khi bạn đăng ký trên trang web. Nó xác thực các yêu cầu của bạn và theo dõi việc sử dụng tín dụng trả trước của bạn. Nếu không có cấu hình này, các yêu cầu của bạn sẽ thất bại với lỗi 404 hoặc 401.

Yêu cầu Đầu tiên của Bạn

Gửi một yêu cầu hoàn thành văn bản đơn giản để xác minh khả năng kết nối và hành vi của mô hình. Sử dụng ID mô hình uncensored để truy cập mô hình cụ thể đang chạy trên proxy. Mô hình này được tinh chỉnh để trả lời mà không từ chối nội dung cho việc sử dụng người lớn hợp pháp.

Thân yêu cầu bao gồm messages mảng và model nhận dạng. Phản hồi chứa văn bản được tạo trong content trường. Điều này xác nhận rằng việc tích hợp của bạn đang hoạt động chính xác với mô hình không kiểm duyệt.

Copycurl https://api.deepseekpago.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of top five open source llms"}]
  }'

Bật Phản Hồi Theo Dòng Chảy

Bật phát trực tiếp bằng cách đặt stream: true trong yêu cầu của bạn. Điều này trả về các Sự kiện được gửi bởi máy chủ (SSE) thay vì một đối tượng JSON đơn lẻ. Bạn nhận được các token ngay khi chúng được tạo, giúp giảm độ trễ cảm nhận cho người dùng cuối.

Xử lý luồng bằng cách lặp qua các chunk. Chunk cuối cùng chứa tổng số token đã sử dụng. Điều này cho phép bạn theo dõi chi phí theo thời gian thực mà không cần chờ phản hồi đầy đủ hoàn thành.

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)

Sử dụng Công cụ và Function Calling

Định nghĩa các công cụ trong thân yêu cầu để cho phép mô hình tạo đầu ra có cấu trúc. Truyền một danh sách các định nghĩa hàm trong tools tham số. Mô hình sẽ trả về một lệnh gọi hàm thay vì văn bản thuần túy khi phù hợp.

Tính năng này hoạt động chính xác như API gọi hàm của OpenAI. Bạn có thể tích hợp nó vào logic ứng dụng để thực thi mã hoặc cập nhật cơ sở dữ liệu. Proxy hỗ trợ giao thức tiêu chuẩn này mà không cần sửa đổi.

Copyimport OpenAI from "openai";

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

Đang thực thi Định dạng đầu ra JSON

Buộc mô hình trả về JSON hợp lệ bằng cách đặt response_format để {"type": "json_object"}. Điều này hữu ích cho việc phân tích dữ liệu vào ứng dụng của bạn. Nó giảm nhu cầu về các mẫu regex xử lý sau.

Mô hình tuân thủ ràng buộc này một cách nghiêm ngặt. Nếu đầu ra không phải là JSON hợp lệ, yêu cầu có thể bị lỗi. Điều này đảm bảo quy trình làm việc của bạn vẫn mạnh mẽ khi tích hợp với các hệ thống tự động hóa. Bạn cũng có thể đặt temperature và top_p để kiểm soát mức độ sáng tạo.

Xử lý Lỗi và Giới hạn Tốc độ

API giới hạn 300 yêu cầu mỗi phút trên mỗi khóa. Nếu bạn vượt quá giới hạn này, bạn sẽ nhận được lỗi 429. Bạn cũng có thể có tối đa 8 yêu cầu đồng thời trên mỗi khóa. Hãy tôn trọng các giới hạn này để tránh gián đoạn dịch vụ.

Lỗi được trả về dưới dạng các đối tượng JSON tiêu chuẩn với mã lỗi và thông báo. Hãy xử lý chúng một cách khéo léo trong mã của bạn. Logic thử lại với độ trễ tăng dần được khuyến nghị cho các lỗi tạm thời như phản hồi 429 hoặc 503.

Giám sát Sử dụng Token

Theo dõi việc sử dụng tín dụng trả trước bằng cách theo dõi số lượng token. Chunk cuối cùng trong phản hồi streaming bao gồm usage object. Điều này hiển thị số lượng token đầu vào và đầu ra.

Giá là $0.15 cho mỗi 1M token đầu vào và $0.50 cho mỗi 1M token đầu ra. Lỗi miễn phí. Bạn có thể tính toán chi phí tại chỗ bằng cách nhân số lượng token với các tỷ lệ này. Điều này giúp bạn lập ngân sách cho việc nạp tiền crypto một cách chính xác.