Apertus ia API Documentation

1. Quickstart: Connect Your First Request

URL cơ sở là https://api.apertusia.com/v1. Truyền khóa API của bạn trong tiêu đề Authorization. Định danh mô hình là uncensored. Cấu hình này hoạt động với bất kỳ máy khách tương thích OpenAI nào.

Sử dụng lệnh cURL này để kiểm tra kết nối ngay lập tức. Thay thế YOUR_API_KEY bằng khóa API thực tế của bạn.

Copycurl https://api.apertusia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
  }'

Lỗi xác thực trả về 401. Không đủ tiền trả về 402. Giới hạn tốc độ trả về 429.

2. Các tham số được hỗ trợ: Nhiệt độ, Top P và Seed

Kiểm soát tính ngẫu nhiên bằng temperature, đa dạng hóa bằng top_p và khả năng tái lập bằng seed. Các tham số này tuân theo các quy ước chuẩn của OpenAI. Đặt temperature ở mức 0.7 để có kết quả cân bằng hoặc 1.0 để tăng tính sáng tạo. Sử dụng top_p để giới hạn việc lấy mẫu chỉ trong khối xác suất cao nhất. Tham số seed đảm bảo đầu ra giống hệt nhau khi gỡ lỗi.

Ví dụ đoạn mã Python để kiểm tra cục bộ:

Copyfrom openai import OpenAI

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

3. Phản hồi dạng stream với Server-Sent Events

Bật chế độ streaming bằng cách đặt stream: true. API trả về các chunk qua Server-Sent Events. Mỗi chunk chứa văn bản một phần và dữ liệu sử dụng token. Điều này giảm độ trễ cảm nhận được cho các phản hồi dài. Xử lý các sự kiện SSE để cập nhật giao diện người dùng của bạn theo thời gian thực.

Ví dụ Node.js sử dụng SDK chính thức:

Copyimport OpenAI from "openai";

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

4. Cấu hình Function Calling và Chế độ JSON

Sử dụng response_format với {"type": "json_object"} để nhận đầu ra JSON chặt chẽ. Điều này đảm bảo dữ liệu có cấu trúc cho các quy trình xử lý tự động. Bật tính năng gọi hàm bằng cách cung cấp mảng tools trong thân yêu cầu. Mô hình sẽ trả về các lệnh gọi công cụ theo định dạng mong đợi. Sử dụng tool_choice để buộc thực hiện hành vi cụ thể.

5. Giới hạn tốc độ và giới hạn kích thước yêu cầu

Mỗi khóa API hỗ trợ 300 yêu cầu mỗi phút. Số lượng yêu cầu đồng thời được giới hạn ở 8 trên mỗi khóa. Kích thước tối đa của phần thân yêu cầu là 8 MB. Cửa sổ ngữ cảnh chứa tổng cộng 100,000 token. Đầu ra tối đa cho mỗi yêu cầu là lên đến toàn bộ cửa sổ 100,000 token. Để max_tokens chưa được đặt, hoặc đặt giá trị cao để tránh bị cắt ngắn. Lỗi không tiêu thụ tín dụng. Hoàn tiền không được cấp, nhưng các lỗi thanh toán sẽ được sửa chữa qua Hỗ trợ.

6. Xác thực và Xử lý Lỗi

Tạo khóa của bạn qua bảng điều khiển. Đăng nhập bằng Google hoặc email. Khóa sẽ hiển thị ngay lập tức. Thêm nó vào tiêu đề Authorization: Bearer. Khóa không hợp lệ sẽ trả về 401. Lỗi 429 cho biết bạn đã hết giới hạn tốc độ. Lỗi 402 có nghĩa là số tiền đã trả trước của bạn đã hết. Nạp thêm bằng USDT hoặc USDC. Tín dụng không bao giờ hết hạn.

Streaming

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)