Hướng dẫn nhanh API AI Qwen

Xác thực & Thiết lập Base URL

Bắt đầu bằng cách tạo khóa API của bạn trên bảng điều khiển. URL cơ sở là https://api.qwenaiapi.com/v1 và bạn truyền khóa của bạn trong Authorization header. Cấu hình này hoạt động với bất kỳ máy khách SDK OpenAI tiêu chuẩn nào mà không cần thay đổi mã. Bạn nhận được một khóa hoạt động cho mỗi tài khoản; việc tạo khóa mới sẽ vô hiệu hóa ngay lập tức khóa trước đó. Không yêu cầu số điện thoại khi đăng ký.

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

Gửi yêu cầu POST đến /v1/chat/completions với khóa và định danh mô hình của bạn. Định danh mô hình là uncensored và nó phản hồi các tin nhắn trò chuyện tiêu chuẩn. Bạn có thể kiểm tra khả năng kết nối với một lời nhắc hệ thống đơn giản để xác minh độ trễ và định dạng phản hồi. Lỗi như 401 cho biết khóa không hợp lệ, trong khi 402 có nghĩa là khoản tín dụng trả trước của bạn đã cạn kiệt.

Copycurl https://api.qwenaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this pull request diff"}]
  }'

Tích hợp SDK Python

Sử dụng client Python chính thức để tương tác với điểm cuối. Đặt base URL và API key trong các tham số khởi tạo của bạn. SDK tự động xử lý tokenization và serialization JSON. Cách tiếp cận này giữ nguyên logic ứng dụng hiện có của bạn trong khi chuyển đổi nhà cung cấp model nền tảng. Client hỗ trợ cả các hoạt động đồng bộ và bất đồng bộ.

Copyfrom openai import OpenAI

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

Sử dụng SDK Node

Khởi tạo client Node.js với URL cơ sở và khóa API của bạn. Gói thư viện hỗ trợ các yêu cầu hoàn thành trò chuyện tiêu chuẩn. Bạn có thể định cấu hình ID mô hình để đảm bảo bạn đang truy cập vào điểm cuối không kiểm duyệt. Tích hợp này lý tưởng cho các ứng dụng phía máy chủ cần quyền truy cập theo chương trình. SDK quản lý việc kết nối nhóm hiệu quả cho các yêu cầu khối lượng lớn.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qwenaiapi.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ản hồi luồng

Bật chế độ streaming bằng cách đặt stream tham số thành true. Bạn nhận được sự kiện gửi bởi máy chủ (SSE) khi token được tạo. Chunk cuối cùng chứa tổng số token sử dụng cho mục đích tính phí. Điều này giảm độ trễ cảm nhận cho người dùng bằng cách hiển thị văn bản dần dần. Bạn phải xử lý luồng đúng cách để nắm bắt dữ liệu sử dụng cuối cùng.

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)

Cửa sổ ngữ cảnh & Giới hạn

Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token cho tổng prompt và kết quả. Bạn có thể gửi tối đa 16.000 token đầu ra mỗi yêu cầu. Giới hạn tốc độ 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. Thân yêu cầu được giới hạn ở 8 MB. Hiểu các giới hạn này giúp bạn nhóm yêu cầu hiệu quả mà không gặp lỗi 429. Lỗi không tiêu thụ tín dụng trả trước của bạn.