Base URL và Xác thực
Sử dụng URL cơ sở được cung cấp và khóa API hợp lệ để kết nối client của bạn. Điểm cuối là https://api.qwencodeapikey.com/v1. Bạn phải bao gồm khóa của bạn trong Authorization header của mọi yêu cầu. Điều này đảm bảo dịch vụ xác định đúng tài khoản tín dụng trả trước của bạn.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
Bạn có thể tạo khóa qua Google hoặc email trên trang đăng ký. Khóa xuất hiện ngay lập tức. Giữ nó an toàn, vì nó kiểm soát chi tiêu của bạn.
Endpoint Hoàn thành Trò chuyện
Gửi tin nhắn đến /v1/chat/completions endpoint để nhận phản hồi văn bản. Đây là giao diện tiêu chuẩn cho hầu hết các SDK OpenAI. Bạn xác định model như uncensored và cung cấp một danh sách các tin nhắn trong messages mảng. API xử lý đầu vào của bạn và trả về phần hoàn thành đã được tạo.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
Đảm bảo thư viện khách hàng của bạn trỏ đến URL cơ sở chính xác. ID mô hình uncensored kích hoạt mô hình trọng lượng mở được tinh chỉnh để giảm thiểu việc từ chối. Nó xử lý các lượt hội thoại giống như bất kỳ API trò chuyện nào khác.
Điểm cuối Models
Truy vấn GET /v1/models để xác minh các mô hình có sẵn và chi tiết của chúng. Điểm cuối này trả về danh sách các mô hình có sẵn cho khóa của bạn. Nó giúp bạn xác nhận uncensored model đang hoạt động và sẵn sàng cho các yêu cầu. Sử dụng điều này để gỡ lỗi cấu hình khách hàng trước khi gửi các tải trọng đầy đủ.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
Kiểm tra cấu trúc phản hồi để đảm bảo SDK của bạn phân tích cú pháp danh sách mô hình chính xác. Điểm cuối này không tiêu tốn tín dụng, nên an toàn cho các kiểm tra khởi tạo.
Tham số yêu cầu và Phát trực tiếp
Hỗ trợ các tham số tiêu chuẩn như temperature, top_p, stop, và seed. Bật luồng dữ liệu bằng cách đặt stream: true. API gửi token thông qua các Sự kiện gửi qua máy chủ (SSE). Thống kê sử dụng token xuất hiện trong chunk cuối cùng của luồng. Điều này cho phép hiển thị văn bản được tạo theo thời gian thực.
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)
Đặt max_tokens để kiểm soát độ dài đầu ra. Giá trị mặc định là 2,048 token. Bạn có thể tăng giá trị này lên đến 16,000 token cho mỗi yêu cầu. Điều chỉnh các tham số để cân bằng giữa sự sáng tạo và độ chính xác trong các phản hồi của bạn.
Giới hạn tốc độ và Ràng buộc
Mỗi khóa cho phép 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời. Kích thước thân yêu cầu tối đa là 8 MB. Các giới hạn này ngăn chặn lạm dụng và đảm bảo hiệu suất ổn định. Nếu bạn vượt quá tốc độ, bạn sẽ nhận được lỗi 429. Hãy điều chỉnh logic client của bạn để xử lý các lần thử lại với cơ chế backoff theo cấp số nhân.
Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100.000 token. Điều này bao gồm cả prompt và completion. Ngữ cảnh lớn đòi hỏi quản lý token cẩn thận để nằm trong giới hạn.
Chế độ JSON và Gọi hàm
Sử dụng response_format: {"type": "json_object"} cho đầu ra có cấu trúc. Điều này đảm bảo mô hình trả về JSON hợp lệ, hữu ích cho tích hợp lập trình. Gọi hàm hoạt động thông qua tools tham số. Xác định các công cụ theo định dạng OpenAI tiêu chuẩn. Mô hình sẽ gọi các hàm khi cần thiết.
Lỗi và từ chối không tiêu thụ tín dụng. Điều này áp dụng ngay cả khi mô hình từ chối một yêu cầu do giới hạn nội dung cứng. Bạn chỉ trả tiền cho việc sử dụng token thực tế. Tín dụng không bao giờ hết hạn, vì vậy bạn có thể nạp thêm khi thuận tiện.
Xử lý lỗi và Sử dụng
Xử lý lỗi HTTP một cách duyên dáng. Lỗi 401 cho biết khóa API không hợp lệ hoặc đã hết hạn. Lỗi 402 nghĩa là tiền nạp trước của bạn đã hết. Lỗi 429 báo hiệu đã vượt quá giới hạn tốc độ. Kiểm tra thân phản hồi để biết thông báo lỗi chi tiết.
Việc sử dụng được theo dõi theo từng khóa. Một khóa hoạt động mỗi tài khoản giúp đơn giản hóa việc thanh toán. Nếu bạn mắc lỗi, chẳng hạn như tính phí trùng lặp, hãy sử dụng trang Hỗ trợ. Số dư không được hoàn lại nhưng vẫn còn hiệu lực. Lỗi miễn phí, vì các yêu cầu thất bại không làm cạn kiệt số dư của bạn.
Tóm tắt và Các thực hành tốt nhất
Bắt đầu với URL cơ sở và khóa hợp lệ. Sử dụng uncensored ID mô hình để giảm thiểu từ chối. Stream phản hồi để cải thiện trải nghiệm người dùng. Theo dõi giới hạn tỷ lệ để tránh gián đoạn. Sử dụng chế độ JSON cho dữ liệu có cấu trúc. Xử lý lỗi để duy trì độ tin cậy. Tín dụng được trả trước và không bao giờ hết hạn. Nạp tiền bằng crypto khi cần. API này tích hợp liền mạch vào các cơ sở mã OpenAI hiện có. Không cần SDK mới. Chỉ cần thay đổi base URL và khóa.
