Hướng dẫn nhanh: Tích hợp chat apertus ai

Điều kiện tiên quyết và Thiết lập

Bắt đầu bằng cách tạo tài khoản và lấy khóa API của bạn. Đăng ký bằng Google hoặc mật khẩu email trên trang tạo khóa. Hệ thống hiển thị khóa của bạn ngay lập tức, vì vậy bạn có thể sao chép nó mà không cần trì hoãn. Không cần số điện thoại để đăng ký. Bạn nhận được $0.50 tín dụng dùng thử hợp lệ trong bảy ngày, vì vậy bạn có thể kiểm tra khả năng kết nối mà không cần thêm tiền.

Cấu hình biến môi trường hoặc máy khách SDK của bạn để trỏ đến URL cơ sở chính xác. URL này hoạt động với các thư viện OpenAI tiêu chuẩn. Chỉ thay đổi URL cơ sở và khóa của bạn. ID mô hình là "uncensored". Điểm cuối duy nhất này xử lý tất cả các phần hoàn thiện văn bản. Bạn không cần quản lý định tuyến hoặc chọn các mô hình khác nhau.

Đảm bảo thư viện khách hàng của bạn hỗ trợ giao thức Hoàn thành Trò chuyện OpenAI. Hầu hết các SDK hiện đại đều hoạt động ngay lập tức. Xác minh mạng của bạn cho phép các yêu cầu HTTPS đầu ra. Dịch vụ chấp nhận các tải trọng JSON tiêu chuẩn. Không cần tiêu đề đặc biệt nào ngoài xác thực.

Xác thực với Khóa API

Đặt khóa API của bạn trong tiêu đề Authorization cho mọi yêu cầu. Sử dụng lược đồ Bearer theo sau là chuỗi khóa của bạn. Dịch vụ xác thực khóa dựa trên tài khoản của bạn. Khóa không hợp lệ sẽ trả về lỗi 401 Unauthorized. Khóa hết hạn hoặc không đủ tiền sẽ kích hoạt phản hồi 402 Payment Required. Kiểm tra số dư của bạn trong bảng điều khiển nếu các yêu cầu thất bại.

Giữ khóa của bạn an toàn. Mỗi tài khoản giữ một khóa hoạt động. Tạo một khóa mới sẽ vô hiệu hóa khóa trước đó. Không chia sẻ khóa của bạn trong các kho lưu trữ công cộng. Khóa API là định danh duy nhất cho việc sử dụng của bạn. Giới hạn tốc độ áp dụng cho mỗi khóa, không phải cho mỗi tài khoản.

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

Xác thực không trạng thái. Máy chủ kiểm tra token trên mọi lệnh gọi. Nếu bạn xoay khóa, hãy cập nhật tất cả các client đang chạy ngay lập tức. Thiếu header sẽ dẫn đến việc từ chối ngay lập tức. Thông báo lỗi nêu rõ lỗi xác thực.

Gửi yêu cầu đầu tiên của bạn

Gửi yêu cầu POST đến điểm cuối chat completions. Bao gồm ID mô hình "uncensored" và lịch sử tin nhắn của bạn. API trả về phản hồi văn bản. Bạn có thể phát trực tiếp đầu ra hoặc chờ toàn bộ phần hoàn tất. Mỗi yêu cầu tiêu thụ các token đầu vào và đầu ra. Lỗi không tính phí tín dụng. Từ chối miễn phí.

Copyfrom openai import OpenAI

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

Phản hồi bao gồm thống kê sử dụng. Theo dõi mức tiêu thụ token để quản lý tín dụng trả trước của bạn. Mô hình trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp. Bạn có thể gửi hệ thống prompt để xác định hành vi. Tin nhắn của người dùng điều khiển cuộc trò chuyện. Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100.000 token.

Bắt đầu với một trao đổi hai tin nhắn đơn giản. Điều này xác minh kết nối và chất lượng phản hồi. Điều chỉnh nhiệt độ và top_p cho các đầu ra sáng tạo hoặc chính xác. API hỗ trợ các tham số tiêu chuẩn. Các trình tự dừng hoạt động như mong đợi. Các giá trị hạt đảm bảo kết quả có thể tái lập.

Phản hồi luồng qua SSE

Bật chế độ phát trực tiếp bằng cách đặt tham số stream thành true. API trả về sự kiện gửi qua máy chủ (SSE) thay vì một đối tượng JSON đơn lẻ. Mỗi chunk chứa một phần của văn bản được tạo. Đọc các chunk cho đến khi luồng kết thúc. Chunk cuối cùng bao gồm tổng số token đã sử dụ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 giảm độ trễ cảm nhận. Người dùng thấy văn bản xuất hiện theo thời gian thực. Điều này lý tưởng cho các giao diện trò chuyện. Xử lý các token một phần cẩn thận. Nối các chunk để tạo thành phản hồi hoàn chỉnh. Máy chủ đóng kết nối khi việc tạo nội dung kết thúc.

Theo dõi lỗi luồng. Gián đoạn mạng có thể làm gián đoạn luồng. Triển khai logic kết nối lại nếu cần. API không gửi lại lịch sử. Bắt đầu một yêu cầu mới nếu luồng bị lỗi. Đếm token trong chunk cuối cùng phản ánh toàn bộ quá trình tạo.

Xử lý các tham số và chế độ

Sử dụng các tham số tiêu chuẩn để kiểm soát quá trình tạo. Đặt nhiệt độ cho tính ngẫu nhiên. Điều chỉnh top_p cho lấy mẫu hạt nhân. Xác định các chuỗi dừng để dừng quá trình tạo sớm. Truyền một hạt giống để có đầu ra xác định. Bật chế độ JSON bằng cách đặt response_format là json_object. Mô hình trả về JSON hợp lệ khi được yêu cầu.

Gọi hàm được hỗ trợ. Định nghĩa các công cụ trong yêu cầu. Mô hình trả về các lệnh gọi công cụ khi phù hợp. Phân tích cú pháp các đối số công cụ trong mã của bạn. Truyền kết quả lại để tiếp tục cuộc trò chuyện. Điều này cho phép các quy trình tác nhân phức tạp.

Copyimport OpenAI from "openai";

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

Giới hạn max tokens giới hạn độ dài đầu ra. Mặc định là 2.048 token. Đặt giá trị cao hơn nếu cần. Giới hạn cứng mỗi yêu cầu là 16.000 token. Cửa sổ ngữ cảnh là 100.000 token. Hãy lập kế hoạch độ dài lịch sử của bạn tương ứng. Các hình phạt về tần suất và sự hiện diện giúp giảm sự lặp lại.

Hiểu về Giới hạn và Lỗi

Giới hạn tốc độ bảo vệ sự ổn định của dịch vụ. Bạn có thể gửi 300 yêu cầu mỗi phút. Độ đồng thời bị giới hạn ở tám yêu cầu đồng thời trên mỗi khóa. Thân yêu cầu không được vượt quá 8 MB. Vượt quá giới hạn sẽ trả về lỗi 429 Quá nhiều Lỗi. Hãy chờ trước khi thử lại.

Kiểm tra mã lỗi để chẩn đoán. 401 có nghĩa là khóa không hợp lệ hoặc thiếu. 402 cho biết số dư nạp trước không đủ. Nạp tiền bằng tiền điện tử để tiếp tục dịch vụ. 429 báo hiệu giới hạn tốc độ. 400 chỉ ra cú pháp yêu cầu sai. Xem lại thông báo lỗi để biết chi tiết.

Quản lý cửa sổ ngữ cảnh là rất quan trọng. Hãy cộng tổng số token của prompt và kết quả. Hãy giữ mức sử dụng thấp hơn nhiều so với giới hạn 100,000 token. Hãy cắt bớt các tin nhắn cũ nếu cần. API không tự động cắt ngắn. Bạn hoàn toàn kiểm soát độ dài lịch sử. Việc sử dụng ngữ cảnh hiệu quả giúp giảm chi phí.