Tài liệu API

Base URL và Xác thực

API nằm ở https://api.ollamauncensoredmodels.com/v1Authorization header với mã thông báo Bearer của bạn. Cấu hình này hoạt động với bất kỳ thư viện máy khách tương thích OpenAI nào vì chúng tôi tuân thủ các mẫu xác thực tương tự. Bạn có thể tạo khóa của mình ngay lập tức qua Google hoặc email mà không cần cung cấp số điện thoại. Hệ thống cấp một khóa hoạt động cho mỗi tài khoản, thay thế bất kỳ khóa trước đó ngay lập tức khi tạo. Điều này đảm bảo quyền truy cập nhất thiết mà không cần quản lý nhiều thông tin xác thực cùng một lúc.

Yêu cầu Đầu tiên của Bạn

Gửi yêu cầu POST đến /v1/chat/completions với ID mô hình được đặt thành "uncensored". Điểm cuối chấp nhận các tham số tiêu chuẩn như messages, temperature, và max_tokens. Nó trả về các phản hồi JSON chứa văn bản được tạo và thống kê sử dụng token. Bạn có thể kiểm tra kết nối nhanh chóng bằng cách xác minh danh sách mô hình hoặc gửi một lời nhắc đơn giản. Cách tiếp cận trực tiếp này loại bỏ sự phức tạp của việc chuyển tiếp hoặc logic định tuyến thường thấy ở các dịch vụ khác.

Copycurl https://api.ollamauncensoredmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the output for 2 plus 2"}]
  }'

Tích hợp SDK Python

Sử dụng thư viện Python chính thức của OpenAI để kết nối bằng cách ghi đè base URL. Đặt các thuộc tính API key và base URL trước khi thực hiện bất kỳ lệnh gọi nào. Điều này cho phép bạn tận dụng các codebase hiện có mà không cần viết lại logic client. Thư viện tự động xử lý serialization và phân tích lỗi. Bạn có thể stream phản hồi hoặc yêu cầu các kết quả đồng bộ tùy thuộc vào yêu cầu độ trễ của ứng dụng. Phương pháp này đảm bảo tương thích với các thực hành phát triển tiêu chuẩn được sử dụng rộng rãi trong ngành.

Copyfrom openai import OpenAI

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

Khởi tạo client OpenAI với URL cơ sở và khóa API của bạn trong các môi trường Node.js. Truyền định danh mô hình "uncensored" vào phương thức hoàn thành trò chuyện. SDK quản lý các yêu cầu HTTP và phân tích cú pháp phản hồi JSON một cách hiệu quả. Bạn có thể tích hợp trực tiếp điều này vào các tuyến Express hoặc các hàm serverless. Cấu trúc mã mô phỏng các triển khai OpenAI tiêu chuẩn, giúp di chuyển từ các nhà cung cấp khác trở nên đơn giản. Cách tiếp cận này duy trì tính an toàn kiểu và xử lý lỗi nhất quán với phát triển JavaScript hiện đại.

Copyimport OpenAI from "openai";

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

Streaming và Việc 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. Máy chủ trả về Server-Sent Events (SSE) để phân phối token theo thời gian thực. Chi tiết sử dụng token chỉ xuất hiện trong chunk cuối cùng của luồng để giữ chi phí hoạt động ở mức tối thiểu. Điều này cho phép bạn hiển thị các phản hồi một cách tiến bộ cho người dùng mà không cần chờ toàn bộ quá trình tạo. Bạn có thể theo dõi tổng số token đã tích lũy để minh bạch hóa việc tính phí. Phát trực tiếp lý tưởng cho các giao diện trò chuyện nơi phản hồi ngay lập tức nâng cao đáng kể 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)

Giới hạn, Lỗi và Ngữ cảnh

Mỗi khóa API hỗ trợ 300 yêu cầu mỗi phút và tám kết nối đồng thời. Giới hạn kích thước thân yêu cầu là 8 MB, và cửa sổ ngữ cảnh bao gồm tổng cộng 100,000 token. Các lỗi như 401 cho biết khóa không hợp lệ, trong khi 402 báo hiệu số dư không đủ. Mã trạng thái 429 có nghĩa là bạn đã đạt giới hạn tốc độ. Mô hình chỉ từ chối nội dung khiêu dâm liên quan đến trẻ em, đảm bảo tính ứng dụng rộng rãi cho các trường hợp sử dụng người lớn. Tín dụng không bao giờ hết hạn, vì vậy bạn có thể tạm dừng việc sử dụng giữa các dự án mà không mất tiền. Cấu trúc dự đoán này giúp bạn lập kế hoạch năng lực cho các ứng dụng có lưu lượng truy cập cao một cách hiệu quả.