Tài liệu API và các điểm cuối

Xác thực và Base URL

API yêu cầu một khóa hợp lệ cho mọi yêu cầu. Bạn tạo khóa này ngay lập tức khi đăng ký bằng Google hoặc địa chỉ email. Truyền khóa vào Authorization header sử dụng Bearer scheme. URL cơ sở cho tất cả các yêu cầu là HTTPS://api.qwenaipricing.com/v1. URL này hoạt động với các SDK OpenAI chính thức và bất kỳ máy khách tương thích nào bằng cách chỉ cập nhật cấu hình cơ sở.

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

Điểm cuối chính là POST /v1/chat/completions. Nó chấp nhận một đối tượng JSON với một messages mảng và một model trường. Đặt ID mô hình thành "uncensored" để truy cập mô hình ngôn ngữ lớn được tinh chỉnh cho các đầu ra không giới hạn. Bạn có thể xác định các vai trò hệ thống, người dùng và trợ lý để cấu trúc ngữ cảnh cuộc trò chuyện của mình.

Copycurl https://api.qwenaipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the monthly cost for the 72B model?"}]
  }'

Phản hồi bao gồm nội dung được tạo ra, thống kê sử dụng và lý do kết thúc. Lỗi trả về các mã HTTP chuẩn như 401 cho khóa không hợp lệ hoặc 402 nếu tín dụng trả trước của bạn đã cạn kiệt. API không hỗ trợ các điểm cuối nhúng, tạo ảnh hoặc tinh chỉnh.

Tích hợp SDK Python

Sử dụng chính thức openai Gói Python để tương tác với API. Khởi tạo client bằng cách cung cấp khóa API của bạn và đặt URL cơ sở thành điểm cuối 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 viết lại logic client của bạn. Thư viện tự động xử lý việc tuần tự hóa JSON và phân tích phản hồi.

Copyfrom openai import OpenAI

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

Đặt các tin nhắn của bạn dưới dạng danh sách các từ điển. SDK hỗ trợ tất cả các tham số tiêu chuẩn như temperature và top_p. Cách tiếp cận này đảm bảo tương thích với các cơ sở mã hiện có yêu cầu giao diện tương thích với OpenAI.

Tích hợp SDK Node.js

SDK Node.js hoạt động tương tự phiên bản Python. Cài đặt openai gói và định cấu hình URL cơ sở và khóa API. Sau đó, bạn có thể gọi điểm cuối hoàn thành trò chuyện với các tham số mong muốn của mình. Phương pháp này lý tưởng cho các ứng dụng phía máy chủ hoặc dịch vụ backend cần tạo văn bản không đồng bộ.

Copyimport OpenAI from "openai";

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

Xử lý luồng phản hồi hoặc promise để xử lý các token được tạo. SDK quản lý kết nối HTTP và xử lý lỗi cho bạn. Bạn cũng có thể sử dụng GET /v1/models endpoint để xác minh ID mô hình có sẵn.

Streaming và Sử dụng

Bật phát trực tiếp bằng cách đặt stream: true trong yêu cầu của bạn. API trả về luồng Sự kiện gửi máy chủ (SSE) của các phản hồi từng phần. Mỗi chunk chứa một đoạn văn bản được tạo. Điều này hữu ích cho các giao diện người dùng thời gian thực hiển thị văn bản ngay khi nó được tạo.

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)

Chunk cuối cùng trong luồng chứa tổng lượng token đã sử dụng cho yêu cầu. Bạn có thể theo dõi chính xác mức tiêu thụ tín dụng trả trước bằng cách giám sát các thống kê sử dụng này. Lỗi trong quá trình streaming có thể kết thúc kết nối sớm.

Giới hạn, Lỗi và Cửa sổ ngữ cảnh

Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token cho phần kết hợp giữa prompt và completion. Giới hạn tối đa cho mỗi yêu cầu là 16.000 token. Nếu bạn không đặt max_tokens, giới hạn là 2.048 token. Bạn bị giới hạn ở 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời cho mỗi khóa. Lỗi 429 cho biết bạn đã vượt quá các giới hạn này. Các yêu cầu có lỗi hoặc bị từ chối không tiêu thụ số dư. API không cung cấp đảm bảo SLA hoặc chứng nhận.