Hướng dẫn bắt đầu nhanh với API

Base URL và Xác thực

Kết nối SDK OpenAI hiện có của bạn bằng cách cập nhật URL cơ sở và cung cấp khóa API của bạn. Dịch vụ của chúng tôi nằm tại https://api.deepseekapidiscount.com/v1 và chấp nhận tiêu chuẩn Authorization: Bearer header. Khóa của bạn hoạt động ngay sau khi tạo, cho phép truy cập vào mô hình không kiểm duyệt mà không cần đăng ký hàng tháng. Cấu hình này cho phép bạn thay thế điểm cuối của chúng tôi trong khi vẫn giữ nguyên mã ứng dụng của bạn theo tiêu chuẩn OpenAI.

Luồng xác thực rất đơn giản. Bạn tạo một khóa trên bảng điều khiển của chúng tôi và truyền nó dưới dạng header. Lỗi như 401 cho biết khóa không hợp lệ, trong khi 402 có nghĩa là số dư trả trước của bạn đã hết. Bạn có thể nạp tiền qua USDT hoặc USDC bất cứ lúc nào, và số dư của bạn không bao giờ hết hạn. Mô hình trả trước này đảm bảo bạn chỉ trả tiền cho các token bạn thực sự sử dụng, không có phí ẩn hoặc giới hạn gói.

Endpoint Hoàn thành Trò chuyện

Gửi yêu cầu đầu tiên của bạn đến /v1/chat/completions endpoint sử dụng ID mô hình uncensored. Điểm cuối này xử lý các tương tác văn bản vào/văn bản ra mà không có bất kỳ kiểm duyệt nội dung tích hợp nào. Bạn có thể kiểm soát phong cách phản hồi bằng các tham số như temperature và top_p. Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token, cho phép lưu trữ lịch sử hội thoại dài hoặc xử lý tài liệu lớn trong một yêu cầu duy nhất. Đầu ra tối đa được giới hạn ở 16.000 token mỗi yêu cầu, hoặc 2.048 nếu bạn bỏ qua giới hạn.

• Sử dụng response_format với json_object cho đầu ra dữ liệu có cấu trúc.
• Đặt stream: true cho việc phân phối token theo thời gian thực.
• Chuyển tiếp stop chuỗi để dừng quá trình tạo tại các dấu hiệu cụ thể.

Điểm cuối này là lõi của API của chúng tôi, được thiết kế cho các nhà phát triển cần đầu ra mô hình thô, không lọc. Nó không cung cấp embedding hoặc tạo hình ảnh, giữ cho dịch vụ tập trung và tiết kiệm chi phí. Bạn trả $0.15 cho mỗi triệu token đầu vào và $0.50 cho mỗi triệu token đầu ra. Lỗi không tiêu thụ tín dụng của bạn, vì vậy bạn có thể kiểm tra tự do mà không lo lắng về việc lãng phí tiền bạc.

Streaming và Việc Sử Dụng Token

Bật phát trực tiếp bằng cách đặt stream: true trong thân yêu cầu của bạn. API trả về Sự kiện được gửi bởi máy chủ (SSE) với mỗi token được tạo. Chunk cuối cùng trong luồng chứa thống kê sử dụng token đầy đủ cho yêu cầu. Điều này cho phép bạn theo dõi chi phí theo thời gian thực khi mô hình tạo văn bản. Luồng dữ liệu lý tưởng cho các giao diện trò chuyện nơi người dùng mong đợi phản hồi tức thì.

Đối tượng sử dụng token bao gồm token đầu vào, token đầu ra và đôi khi là tổng số token. Vì API của chúng tôi là trả trước, bạn có thể theo dõi số dư còn lại của mình dựa trên các số liệu sử dụng này. Lỗi trong quá trình phát trực tiếp sẽ không tính phí bạn cho các token đã gửi. Sự minh bạch này giúp bạn quản lý ngân sách hiệu quả, đặc biệt khi chạy các cuộc trò chuyện dài hoặc xử lý các tài liệu lớn. Cửa sổ ngữ cảnh 100,000 token hỗ trợ ngữ cảnh lịch sử sâu mà không bị cắt ngắn.

Function Calling và chế độ JSON

Sử dụng gọi hàm để tích hợp API của chúng tôi vào các quy trình làm việc agent. Xác định công cụ của bạn trong tools tham số và đặt tool_choice để auto hoặc một ID hàm cụ thể. Mô hình sẽ trả về một đối tượng gọi công cụ nếu đầu vào yêu cầu hành động bên ngoài. Tính năng này hoạt động cùng với chế độ JSON, buộc đầu ra vào một lược đồ JSON nghiêm ngặt bằng cách sử dụng response_format. Bạn có thể kết hợp những điều này để trích xuất dữ liệu có cấu trúc mạnh mẽ.

Gọi hàm hỗ trợ nhiều công cụ trong một yêu cầu. Mô hình quyết định sử dụng công cụ nào dựa trên ngữ cảnh đầu vào. Chế độ JSON hữu ích khi bạn cần cấu trúc dữ liệu dự đoán được để xử lý ở bước sau. Cả hai tính năng đều có cùng giá cơ bản là $0.15 cho mỗi triệu token đầu vào. Sự linh hoạt này khiến API của chúng tôi phù hợp cho các ứng dụng phức tạp yêu cầu định dạng đầu ra chính xác.

Giới hạn và Thực tiễn tốt nhất

Mỗi khóa API được 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 phần thân yêu cầu là 8 MB. Các giới hạn này đảm bảo sử dụng công bằng và hiệu suất ổn định cho tất cả người dùng. Nếu vượt quá giới hạn tỷ lệ, bạn sẽ nhận được lỗi 429. Bạn có thể tạo khóa mới để thay thế khóa cũ nếu cần, nhưng chỉ một khóa được kích hoạt cho mỗi tài khoản. Sự đơn giản này giúp giảm tải quản lý cho các nhóm nhỏ.

Thực tiễn tốt nhất bao gồm việc đặt một max_tokens giới hạn để kiểm soát chi phí và tránh tạo vô hạn. Sử dụng stop chuỗi để ngăn mô hình nói lan man. Theo dõi việc sử dụng token của bạn qua điểm cuối streaming để duy trì trong hạn mức tín dụng trả trước của bạn. Vì tín dụng không bao giờ hết hạn, bạn có thể nạp thêm bất cứ khi nào thuận tiện. Mô hình không kiểm duyệt không từ chối nội dung người lớn hợp pháp, nhưng nó sẽ chặn nội dung tình dục liên quan đến trẻ em. Giới hạn cứng này áp dụng bất kể cấp tài khoản của bạn.

Ví dụ về máy khách

Dưới đây là các đoạn mã mẫu cho các ngôn ngữ phổ biến. Sử dụng các SDK chính thức của OpenAI hoặc bất kỳ khách hàng tương thích nào. Thay thế YOUR_API_KEY với khóa được tạo của bạn. URL cơ sở là https://api.deepseekapidiscount.com/v1. Những ví dụ này minh họa việc tạo văn bản cơ bản và streaming. Bạn có thể điều chỉnh chúng cho trường hợp sử dụng cụ thể của mình, dù đó là chat, tóm tắt hay trích xuất dữ liệu.

cURL

Copycurl https://api.deepseekapidiscount.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check server status for uptime reliability and latency metrics"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Phát trực tiếp

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)