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

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

API của chúng tôi sử dụng xác thực token Bearer tiêu chuẩn. Bạn nhận được khóa của mình ngay sau khi đăng ký qua Google hoặc email. Hãy giữ khóa này an toàn; nó cung cấp quyền truy cập vào tín dụng trả trước của bạn. URL cơ sở cho tất cả các yêu cầu là https://api.qwenapi.cc/v1. Cập nhật cấu hình client của bạn để trỏ đến endpoint này thay vì URL OpenAI mặc định.

Xác thực được xử lý bằng cách chuyển tiêu đề Authorization với mọi yêu cầu. Không có khóa API thì mô hình không thể xác minh số dư tài khoản của bạn, dẫn đến lỗi 401. Không có tiêu đề ẩn hoặc lược đồ xác thực tùy chỉnh nào được yêu cầu.

Yêu cầu đầu tiên

Gửi một yêu cầu hoàn thành trò chuyện tiêu chuẩn để kiểm tra kết nối. Thay thế YOUR_API_KEY bằng khóa thực tế của bạn. Endpoint chấp nhận các tải trọng JSON tiêu chuẩn với các trường model, messages và content.

• Mã định danh mô hình: uncensored
• Endpoint: POST /v1/chat/completions
• Định dạng: JSON

Yêu cầu này sẽ tiêu thụ token đầu vào từ số dư của bạn. Hãy đảm bảo client của bạn xử lý phản hồi JSON đúng cách để xác minh kết nối đang hoạt động.

Tích hợp Python SDK

Sử dụng thư viện Python OpenAI chính thức. Nó yêu cầu cấu hình tối thiểu để định tuyến lưu lượng truy cập đến endpoint của chúng tôi. Khởi tạo client với khóa của bạn và URL cơ sở chính xác. Cách tiếp cận này tận dụng các cơ sở mã hiện có mà không cần viết lại logic yêu cầu.

Chuyển mã định danh mô hình uncensored khi tạo phản hồi. Thư viện tự động xử lý việc tuần tự hóa và giải tuần tự hóa. Phương pháp này được khuyến nghị cho hầu hết các tích hợp backend và quy trình dựa trên kịch bản.

Tích hợp Node SDK

Đối với môi trường JavaScript hoặc TypeScript, hãy sử dụng @anthropic-ai/sdk hoặc gói Node OpenAI tiêu chuẩn. Cấu hình URL cơ sở để trỏ đến API của chúng tôi. Điều này cho phép bạn đưa dịch vụ của chúng tôi vào các ứng dụng Node hiện có mà không cần tái cấu trúc lớn.

Hãy đảm bảo bạn đang sử dụng phiên bản SDK gần đây hỗ trợ URL cơ sở tùy chỉnh. Chuyển mã định danh mô hình uncensored để chọn mô hình không kiểm duyệt của chúng tôi. Cấu hình này hoạt động liền mạch với các tuyến Express hoặc các hàm serverless.

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ề các sự kiện được gửi qua máy chủ (SSE) khi mô hình tạo văn bản. Điều này cung cấp độ trễ thấp hơn cho người dùng cuối và cho phép hiển thị đầu ra theo thời gian thực.

Thống kê sử dụng token được bao gồm trong phần cuối cùng của luồng. Hãy xử lý từng phần tăng dần để xây dựng phản hồi hoàn chỉnh. Tính năng này rất cần thiết cho các giao diện trò chuyện và các ứng dụng yêu cầu phản hồi ngay lập tức.

Giới hạn, Lỗi và Ngữ cảnh

Hãy tôn trọng các giới hạn tốc độ để tránh gián đoạn dịch vụ. API cho phép 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời mỗi khóa. 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, bạn sẽ nhận được lỗi 429.

Lỗi xác thực trả về 401, cho biết khóa không hợp lệ hoặc bị thiếu. Lỗi số dư trả về 402, có nghĩa là tín dụng trả trước của bạn đã hết. Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100.000 token, với tối đa 32.000 token đầu ra mỗi yêu cầu. Lỗi và từ chối không tiêu thụ tín dụng.

cURL

Copycurl https://api.qwenapi.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

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

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)