Tài liệu API

Base URL và xác thực

Kết nối ứng dụng của bạn bằng cách trỏ đến endpoint chuyên dụng của chúng tôi và chuyển khóa API độc nhất của bạn. URL cơ sở cho tất cả các yêu cầu là https://api.apertusapp.com/v1. Bạn lấy khóa của mình ngay sau khi đăng ký qua Google hoặc email trên Lấy khóa API trang. Bao gồm khóa này trong Authorization header cho mọi yêu cầu.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

Mỗi tài khoản tạo ra một khóa đang hoạt động. Nếu bạn tạo khóa mới, khóa trước đó sẽ không còn hợp lệ ngay lập tức. Điều này đảm bảo kiểm soát chặt chẽ quyền truy cập của bạn mà không có gói đăng ký hoặc phí không hoạt động.

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

Gửi lời nhắc đầu tiên đến điểm cuối hoàn tất cuộc trò chuyện để nhận văn bản thô, không lọc. Sử dụng model ID uncensored để truy cập mô hình trọng lượng mở cụ thể của chúng tôi được tinh chỉnh cho các chủ đề người lớn hợp pháp và gây tranh cãi.

Copyfrom openai import OpenAI

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

API chấp nhận các tham số tiêu chuẩn như temperature và top_p. Lỗi và từ chối không tiêu thụ token, vì vậy bạn chỉ trả tiền cho những gì thực sự đạt đến mô hình. Cách tiếp cận này giữ cho chi phí dự đoán được so với các bộ tổng hợp tính phí cho độ trễ định tuyến.

Tích hợp SDK Node

Sử dụng Node SDK chính thức để xử lý chế độ JSON và gọi hàm một cách hiệu quả. Đặt response_format để {"type": "json_object"} cho đầu ra có cấu trúc hoặc xác định công cụ cho hành vi giống như agent.

Copyimport OpenAI from "openai";

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

Mô hình hỗ trợ gọi công cụ với tool_choice tùy chọn. Bạn cũng có thể đặt một seed để kết quả xác định. Sự linh hoạt này cho phép bạn xây dựng các ứng dụng phức tạp mà không cần rời khỏi hệ sinh thái tương thích OpenAI.

Các phản hồi streaming

Phát trực tiếp token theo thời gian thực bằng Server-Sent Events (SSE) cho trải nghiệm người dùng độ trễ thấp. Mỗi gói chứa văn bản được tạo, và gói cuối cùng bao gồm thống kê sử dụng token tổng 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)

Streaming làm giảm độ trễ cảm nhận cho người dùng cuối. Bạn có thể ngắt luồng nếu người dùng thay đổi ý định. API xử lý giao thức SSE tự động, yêu cầu rất ít mã từ phía bạn.

Cửa sổ ngữ cảnh và dung lượng

Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token cho cả đầu vào và đầu ra kết hợp. Bạn có thể chỉ định tối đa 16.000 token mỗi yêu cầu, hoặc quay lại 2.048 token nếu bạn bỏ qua max_tokens.

Cửa sổ lớn này cho phép phân tích tài liệu rộng rãi hoặc lịch sử hội thoại dài. Tuy nhiên, hãy giữ các thân yêu cầu dưới 8 MB. Mô hình không phải là GPT hay Llama; đó là một mô hình AI không kiểm duyệt riêng biệt được tối ưu hóa cho trường hợp sử dụng cụ thể của bạn.

Xử lý lỗi và giới hạn

Xử lý gracefully các lỗi HTTP tiêu chuẩn để duy trì luồng ứng dụng mạnh mẽ. Một 401 lỗi cho biết khóa API không hợp lệ hoặc bị thiếu. Một 402 lỗi có nghĩa là số dư trả trước của bạn đã cạn kiệt. Một 429 lỗi báo hiệu rằng bạn đã vượt quá 300 yêu cầu mỗi phút hoặc 8 yêu cầu đồng thời.

Tín dụng không bao giờ hết hạn, nên bạn có thể tạm dừng sử dụng và tiếp tục sau. Các lỗi như nạp tiền trùng lặp được sửa qua trang Hỗ trợ. Tín dụng trả trước chỉ tính phí dựa trên lượng token thực tế tiêu thụ, đảm bảo giá cả minh bạch cho từng byte.