Hướng dẫn nhanh API Wu Shencha

Cấu hình cơ bản

API Wu Shencha cung cấp giao diện tương thích chuẩn với OpenAI. Bạn cần thiết lập URL cơ sở và khóa API trong mã của mình. URL cơ sở cố định là https://api.wushenchaapi.com/v1. ID mô hình là uncensored, một mô hình trọng số mở đã được tinh chỉnh, được thiết kế cho các tình huống không kiểm duyệt, hỗ trợ nội dung người lớn hợp pháp.

Khóa hiển thị trên trang "Lấy khóa API" sau khi đăng ký. Vì API tương thích OpenAI, bạn chỉ cần sửa tham số base_url trong SDK chính thức để kết nối. Không cần cấu hình định tuyến bổ sung hoặc cài đặt phức tạp.

Giao diện hoàn thành trò chuyện

Sử dụng endpoint POST /v1/chat/completions để gửi yêu cầu văn bản. Giao diện này chấp nhận định dạng thông báo chuẩn và trả về văn bản được tạo. Đây là cách tương tác cơ bản nhất, phù hợp cho hầu hết các tình huống tạo văn bản.

Thân yêu cầu phải chứa các trường model, messages. Đảm bảo kích thước thân yêu cầu của bạn không vượt quá 8 MB. Nếu khóa không hợp lệ hoặc số dư không đủ, API sẽ trả về mã lỗi tương ứng.

复制curl https://api.wushenchaapi.com/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."}]
  }'

SDK Python

Đối với nhà phát triển Python, bạn có thể sử dụng SDK openai chính thức. Chỉ cần trỏ base_url đến endpoint của API Wu Shencha và truyền khóa API của bạn. Phương pháp này duy trì sự nhất quán với mã gốc OpenAI, giúp di chuyển dễ dàng.

Đảm bảo cài đặt phiên bản SDK mới nhất. Ví dụ mã hiển thị cách khởi tạo máy khách và gửi thông báo. Cách tiếp cận này đơn giản và hiệu quả, phù hợp cho phát triển nguyên mẫu nhanh.

复制from openai import OpenAI

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

SDK Node.js

Nhà phát triển Node.js cũng có thể sử dụng gói npm openai để kết nối. Cách cấu hình tương tự Python, thiết lập baseURL và apiKey. Điều này đảm bảo sự nhất quán giữa các ngôn ngữ, giảm chi phí học tập.

Hỗ trợ yêu cầu không đồng bộ và xử lý lỗi. Bạn có thể dễ dàng tích hợp vào các ứng dụng Node.js hiện có. Lưu ý xử lý lệnh gọi lại không đồng bộ hoặc Promise để tránh chặn.

复制import OpenAI from "openai";

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

Truyền phát (streaming)

Hỗ trợ truyền phát qua Server-Sent Events (SSE). Đặt tham số stream: true, API sẽ trả về dữ liệu phản hồi theo từng khối. Điều này rất hữu ích cho các ứng dụng thời gian thực hoặc tạo văn bản dài, mang lại trải nghiệm độ trễ thấp hơn.

Phản hồi truyền phát không thay đổi hành vi của mô hình, chỉ thay đổi cách truyền dữ liệu. Bạn có thể chọn chế độ truyền phát hoặc không truyền phát theo nhu cầu.

复制stream = 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)

Hạn chế và hạn ngạch

Tối đa 300 yêu cầu mỗi phút. Cửa sổ ngữ cảnh là 100,000 token (bao gồm prompt và hoàn thành). Nếu vượt quá giới hạn, API trả về lỗi 429. Khóa không hợp lệ trả về 401, số dư không đủ trả về 402.

Tín dụng trả trước không bao giờ hết hạn, không có phí hàng tháng. Giới hạn kích thước thân yêu cầu cho mỗi lần gọi là 8 MB. Các giới hạn này đảm bảo sự ổn định của dịch vụ. Bạn có thể tạo khóa mới bất cứ lúc nào để thu hồi khóa cũ.