Qwen API: Yêu cầu đầu tiên trong 5 phút

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

API của chúng tôi tuân theo định dạng OpenAI tiêu chuẩn, giúp bạn dễ dàng chuyển đổi cấu hình máy khách hiện có. URL cơ sở cho tất cả các yêu cầu là https://api.qwenapis.com/v1. Bạn cần một khóa API để xác thực các yêu cầu của mình. Nếu bạn chưa tạo, hãy truy cập trang Lấy khóa API để tạo khóa chỉ bằng email và mật khẩu. Không cần thẻ tín dụng để bắt đầu với tín dụng dùng thử.

Mỗi tài khoản chỉ giới hạn một khóa hoạt động tại một thời điểm. Bạn có thể tạo lại khóa bất cứ lúc nào, điều này sẽ thu hồi ngay lập tức khóa trước đó. Điều này đảm bảo rằng nếu khóa của bạn bị lộ, bạn có thể bảo mật tài khoản ngay lập tức mà không cần chờ chu kỳ hàng tháng. Hãy giữ khóa của bạn an toàn trong các biến môi trường hoặc trình quản lý bí mật.

Gửi yêu cầu đầu tiên của bạn

Xác minh cấu hình của bạn bằng cách gửi một yêu cầu hoàn tất văn bản đơn giản. Ví dụ sau sử dụng curl để gửi một prompt đến mô hình không kiểm duyệt. Thay thế YOUR_API_KEY bằng khóa được tạo ở bước trước. ID mô hình được đặt là uncensored, được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp.

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

Nếu thành công, bạn sẽ nhận được phản hồi JSON chứa văn bản được tạo. Nếu bạn nhận được lỗi 401, hãy kiểm tra xem khóa của bạn có chính xác không. Lỗi 402 cho biết tín dụng trả trước của bạn đã hết.

Tích hợp SDK Python

Đối với nhà phát triển Python, SDK OpenAI chính thức hoạt động trực tiếp với endpoint của chúng tôi. Cài đặt thư viện bằng pip, sau đó định cấu hình máy khách trỏ đến URL cơ sở của chúng tôi. Điều này cho phép bạn sử dụng các phương thức quen thuộc như chat.completions.create() mà không cần thay đổi đáng kể logic ứng dụng. SDK xử lý tuần tự hóa JSON và logic thử lại cho bạn.

Copyfrom openai import OpenAI

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

Hãy nhớ đặt api_key và base_url chính xác. Tên mô hình vẫn là uncensored. Cách tiếp cận này đảm bảo tương thích với mã được viết cho các nhà cung cấp khác, giúp bạn dễ dàng chuyển đổi hoặc thử nghiệm các endpoint khác nhau.

Sử dụng SDK Node.js

Nhà phát triển Node.js có thể sử dụng gói npm @anthropic-ai/sdk hoặc gói chính thức openai. Định cấu hình máy khách với URL cơ sở và khóa API của chúng tôi. Cấu trúc của yêu cầu giống hệt với các dịch vụ tương thích OpenAI khác. Điều này cho phép bạn tích hợp Qwen không kiểm duyệt vào các ứng dụng Node.js hiện có với ít thay đổi mã nhất.

Copyimport OpenAI from "openai";

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

Đảm bảo bạn xử lý phản hồi không đồng bộ một cách phù hợp. SDK sẽ trả về đối tượng hoàn thành đầy đủ, bao gồm thống kê sử dụng token. Điều này giúp bạn theo dõi việc tiêu thụ tín dụng trả trước theo thời gian thực.

Bật chế độ truyền phát

Để giảm độ trễ và cải thiện trải nghiệm người dùng, hãy bật chế độ truyền phát trong các yêu cầu của bạn. Truyền phát gửi phản hồi token theo token khi nó được tạo, cho phép ứng dụng của bạn hiển thị đầu ra theo từng phần. Đặt tham số stream thành true trong yêu cầu của bạn. SDK sẽ cung cấp một luồng các chunk có thể lặp lại.

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)

Điều này đặc biệt hữu ích cho việc tạo nội dung dài hoặc các ứng dụng tương tác. Mỗi chunk chứa văn bản một phần, mà bạn có thể nối vào bộ đệm hiển thị của mình. Luồng kết thúc khi mô hình hoàn thành phản hồi hoặc đạt giới hạn ngữ cảnh.

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

API của chúng tôi có các giới hạn cụ thể để đảm bảo sử dụng công bằng. Bạn được phép 300 yêu cầu mỗi phút mỗi khóa. Kích thước yêu cầu tối đa là 8 MB. Cửa sổ ngữ cảnh là 100.000 token, bao gồm cả prompt và phần hoàn thành. Nếu bạn vượt quá giới hạn tốc độ, bạn sẽ nhận được lỗi 429. Nếu tín dụng không đủ, bạn sẽ nhận được lỗi 402. Đối với khóa không hợp lệ, bạn sẽ nhận được lỗi 401. Các lỗi này giúp bạn quản lý luồng ứng dụng và sử dụng tín dụng một cách hiệu quả.