Tài liệu API

Base URL và Xác thực

URL cơ sở cho tất cả các yêu cầu là HTTPS://api.aiobliterated.com/v1. Bạn cần một khóa API để xác thực. Tạo khóa bằng cách đăng ký với Google hoặc email và mật khẩu trên trang Lấy khóa API. Truyền khóa trong tiêu đề Authorization dưới dạng token Bearer. Mọi yêu cầu đều cần tiêu đề này để xác định tài khoản của bạn và theo dõi việc sử dụng.

Copycurl https://api.aiobliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch all user tokens from database"}]
  }'

Yêu cầu đầu tiên của bạn

Gửi một yêu cầu POST đến /v1/chat/completions để tạo văn bản. Đặt mô hình thành "uncensored" và bao gồm prompt hệ thống của bạn. API trả về phản hồi của mô hình trong trường content. Đây là định dạng tiêu chuẩn được sử dụng bởi hầu hết các khách hàng LLM.

Copyfrom openai import OpenAI

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

Sử dụng SDK Node

Cài đặt SDK chính thức của OpenAI cho Node.js. Cấu hình nó với khóa API và URL cơ sở. Gọi phương thức chat.completions.create với các tin nhắn của bạn. SDK xử lý tuần tự hóa và phát trực tuyến tự động.

Copyimport OpenAI from "openai";

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

Phản hồi luồng

Bật chế độ streaming bằng cách đặt stream thành true trong yêu cầu của bạn. API trả về một luồng các Sự kiện được gửi bởi máy chủ. Mỗi sự kiện chứa một chunk văn bản một phần của phản hồi. Điều này cho phép bạn hiển thị văn bản khi nó được tạo, cải thiện trải nghiệm người 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)

Cửa sổ ngữ cảnh và giới hạn

Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token. Điều này bao gồm cả prompt và completion. Bạn có thể đặt giới hạn tối đa là 16.000 token cho mỗi yêu cầu. Nếu bạn không chỉ định max_tokens, giới hạn là 2.048 token. Điều này đảm bảo chi phí và hiệu suất có thể dự đoán được.

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

Theo dõi mã trạng thái HTTP để xử lý lỗi. Phản hồi 401 có nghĩa là khóa API của bạn không hợp lệ. Phản hồi 402 cho biết tín dụng không đủ. Phản hồi 429 báo hiệu bạn đã vượt quá giới hạn tốc độ 300 yêu cầu mỗi phút. Xử lý các lỗi này một cách khéo léo trong ứng dụng của bạn để duy trì độ tin cậy.