Tài liệu API

Base URL và Xác thực

Điểm cuối API nằm tại https://api.openrouteraiapi.com/v1. Truyền khóa API của bạn trong Authorization header dưới dạng bearer token. Header này là thay đổi duy nhất cần thiết để chuyển hướng lưu lượng truy cập từ nhà cung cấp hiện tại của bạn sang mô hình không kiểm duyệt của chúng tôi.

Xác thực nghiêm ngặt. Nếu khóa bị thiếu hoặc không hợp lệ, máy chủ sẽ trả về lỗi 401 ngay lập tức. Bạn có thể tạo khóa ngay lập tức qua Google hoặc email trên bảng điều khiển. Giữ khóa này an toàn, vì nó cấp quyền truy cập vào số dư tín dụng trả trước của bạn.

Endpoint Hoàn thành Trò chuyện

Gửi các yêu cầu POST đến /v1/chat/completions với một mảng messages. Định danh mô hình là uncensored. Mô hình đơn lẻ này xử lý tất cả nhu cầu tạo văn bản của bạn mà không có logic định tuyến phức tạp.

Đây là một yêu cầu tiêu chuẩn sử dụng cURL để xác minh khả năng kết nối và định dạng phản hồi.

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

Phản hồi bao gồm văn bản được tạo ra trong choices[0].message.content trường. Bạn có thể phân tích cú pháp điều này trực tiếp vào quy trình làm việc ứng dụng của mình.

Tích hợp SDK Python

Sử dụng Python client OpenAI chính thức để kết nối dễ dàng. Đặt base_url và api_key biến để trỏ đến cơ sở hạ tầng của chúng tôi. Cách tiếp cận này giảm thiểu thay đổi mã khi chuyển nhà cung cấp.

Copyfrom openai import OpenAI

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

Máy khách xử lý tự động việc tuần tự hóa và thử lại. Bạn nhận được một đối tượng hoàn thành chứa văn bản và thống kê sử dụng token. Phương pháp này lý tưởng cho các dịch vụ backend và các tập lệnh.

Sử dụng SDK Node.js

Khởi tạo client Node.js OpenAI với URL cơ sở tùy chỉnh của bạn. Điều này cho phép các ứng dụng JavaScript tương tác với mô hình không kiểm duyệt bằng các phương thức quen thuộc. SDK quản lý các yêu cầu HTTP một cách hiệu quả.

Copyimport OpenAI from "openai";

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

Gọi chat.completions.create() với các thông điệp của bạn. Đối tượng phản hồi cung cấp quyền truy cập vào nội dung được tạo và dữ liệu sử dụng. Tích hợp này hoạt động tốt cho máy chủ web và các hàm biên.

Phản hồi luồng

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. Tính năng này giảm độ trễ cảm nhận cho người dùng cuối.

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)

Mỗi khối chứa nội dung một phần. Khối cuối cùng bao gồm thống kê sử dụng mã thông báo đầy đủ. Xử lý các sự kiện này trong ứng dụng khách của bạn để cập nhật giao diện người dùng theo từng bước.

Giới hạn, Lỗi và Cửa sổ ngữ cảnh

Cửa sổ ngữ cảnh hỗ trợ 100.000 token cho tổng đầu vào và đầu ra. Mỗi yêu cầu có thể xuất tối đa 16.000 token, hoặc 2.048 nếu max_tokens chưa được đặt. Giới hạn tốc độ cho phép 300 yêu cầu mỗi phút trên mỗi khóa.

Lỗi là các mã HTTP tiêu chuẩn. Mã 401 cho biết khóa không hợp lệ. Mã 402 nghĩa là tín dụng trả trước của bạn đã cạn kiệt. Mã 429 báo hiệu rằng bạn đã vượt quá giới hạn tốc độ. Các yêu cầu bị lỗi không tiêu thụ tín dụng. Lỗi là miễn phí.