Tài liệu tham khảo API queen

Base URL và Xác thực

Xác thực sử dụng mã thông báo Bearer tiêu chuẩn được truyền trong Authorization header. Phương pháp này đảm bảo tương thích với các SDK OpenAI hiện có mà không yêu cầu logic tùy chỉnh. Máy khách của bạn API_KEY được tạo ngay lập tức khi đăng ký thông qua Google hoặc email. Tất cả các yêu cầu phải trỏ đến URL cơ sở cụ thể được cung cấp cho dịch vụ.

• Base URL: https://api.apiqueen.cc/v1
• Tiêu đề: Authorization: Bearer API_KEY

Copycurl https://api.apiqueen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return current status for service api queen"}]
  }'

Gửi yêu cầu đến /v1/chat/completions

Gửi dữ liệu văn bản đến điểm cuối để nhận phản hồi trực tiếp từ mô hình. ID mô hình luôn là uncensored, xử lý các chủ đề đa dạng mà không có các từ chối tiêu chuẩn. Bạn có thể chỉ định các tham số như temperature và top_p để kiểm soát độ sáng tạo. Hệ thống mong đợi một danh sách các thông báo theo định dạng trò chuyện tiêu chuẩn.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Tham số Mô hình: Nhiệt độ, Top-P và Stop

Kiểm soát quá trình sinh phản hồi bằng các tham số LLM tiêu chuẩn. Đặt temperature giữa 0 và 2 để điều chỉnh độ ngẫu nhiên khác nhau. Sử dụng top_p để lọc các từ có xác suất thấp. Xác định stop chuỗi để dừng đầu ra tại các kích hoạt cụ thể. Các cài đặt này cho phép tinh chỉnh chính xác cho các nhiệm vụ viết sáng tạo hoặc truy xuất dữ liệu thực tế.

API bỏ qua các tham số không được hỗ trợ một cách duyên dáng. Tập trung vào temperature, top_p, và stop để đạt kết quả tốt nhất. Điều chỉnh các giá trị này dựa trên khả năng chịu nhiễu của ứng dụng của bạn.

Phản hồi luồng và sử dụng token

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ề các chunk dữ liệu thông qua Sự kiện gửi máy chủ (SSE). Chi tiết sử dụng token chỉ xuất hiện trong chunk cuối cùng của luồng. Điều này cho phép hiển thị theo thời gian thực các phản hồi trong giao diện người dùng của bạn.

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)

Xử lý cẩn thận các phản hồi từng phần. Đảm bảo máy khách của bạn đệm dữ liệu cho đến khi luồng đóng.

Function Calling và chế độ JSON

Sử dụng gọi hàm để trích xuất dữ liệu có cấu trúc. Xác định công cụ trong tools tham số. Mô hình trả về JSON hợp lệ khi response_format được đặt thành {"type": "json_object"}. Điều này đảm bảo việc phân tích cú pháp nhất quán trong các ứng dụng ở tầng dưới.

Đặt tool_choice để bắt buộc các lệnh gọi hàm cụ thể. Điều này hữu ích cho các quy trình tự động yêu cầu định dạng đầu ra nghiêm ngặt.

Xử lý lỗi và Giới hạn tốc độ

Theo dõi mã trạng thái HTTP để xử lý các vấn đề phổ biến. Lỗi 401 có nghĩa là khóa API của bạn không hợp lệ. Lỗi 402 cho biết tín dụng trả trước không đủ. Lỗi không tiêu thụ số dư token của bạn. Giới hạn tốc độ áp dụng 300 yêu cầu mỗi phút mỗi khóa. Các yêu cầu đồng thời được giới hạn ở 8. Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100.000 token.

Xử lý các lần thử lại với độ trễ tăng dần theo cấp số nhân. Kiểm tra error object trong các phản hồi JSON để biết chi tiết.