URL cơ bản và Xác thực
API của chúng tôi tương thích hoàn toàn với OpenAI, nghĩa là bạn có thể sử dụng bất kỳ SDK tiêu chuẩn nào với những thay đổi tối thiểu. URL cơ bản cho tất cả các yêu cầu là https://api.openrouterapi.top/v1. Xác thực được xử lý thông qua token Bearer được truyền trong tiêu đề Authorization. Bạn có thể tạo khóa này ngay lập tức bằng cách đăng ký bằng Google hoặc địa chỉ email trên bảng điều khiển của chúng tôi. Hãy giữ khóa của bạn an toàn vì nó cung cấp quyền truy cập trực tiếp vào tín dụng trả trước của bạn.
Yêu cầu đầu tiên
Kiểm tra endpoint bằng lệnh curl đơn giản. Thay thế YOUR_API_KEY bằng khóa thực tế của bạn. ID mô hình được đặt thành uncensored để bỏ qua các từ chối nội dung tiêu chuẩn. Yêu cầu này gửi một prompt và chờ phản hồi đầy đủ.
curl https://api.openrouterapi.top/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Nếu khóa không hợp lệ, bạn sẽ nhận được lỗi 401. Nếu số dư trả trước của bạn đã cạn kiệt, bạn sẽ nhận được lỗi 402. Những lỗi này không tiêu tốn số dư token của bạn, nhưng chúng có tính vào hạn ngạch giới hạn tốc độ của bạn.
Tích hợp SDK Python
Sử dụng gói Python openai chính thức rất đơn giản. Khởi tạo client với URL cơ bản và khóa của bạn. SDK tự động xử lý việc tuần tự hóa JSON. Ví dụ này minh họa một yêu cầu hoàn thành trò chuyện cơ bản.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterapi.top/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 bảo bạn đã cài đặt phiên bản SDK mới nhất. Đối tượng client quản lý nhóm kết nối, vì vậy bạn có thể tái sử dụng nó cho nhiều yêu cầu mà không cần khởi tạo lại.
Tích hợp SDK Node.js
Đối với môi trường JavaScript, SDK Node.js hoạt động giống hệt nhau. Truyền URL cơ bản tùy chỉnh trong quá trình khởi tạo. Cách tiếp cận này cho phép bạn tích hợp việc tạo không kiểm duyệt vào các ứng dụng web hoặc dịch vụ backend hiện có một cách liền mạch.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterapi.top/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);SDK Node.js hỗ trợ cả mẫu dựa trên promise và async/await. Xử lý lỗi nhất quán với các dịch vụ tương thích OpenAI khác.
Phản hồi truyền phát
Bật truyền phát bằng cách đặt stream: true trong yêu cầu của bạn. API trả về các Sự kiện được gửi bởi máy chủ (SSE). Mỗi chunk chứa văn bản một phần. Chunk cuối cùng bao gồm thống kê sử dụng token để tính phí.
stream = 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)Tín dụng trả trước được tính dựa trên các token thực tế được tạo ra trong đầu ra cuối cùng. Truyền phát không thay đổi mô hình giá; bạn trả tiền cho các token được giao thành công.
Giới hạn tốc độ và Cửa sổ ngữ cảnh
Mỗi khóa API bị giới hạn ở 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời. Kích thước yêu cầu tối đa là 8 MB. Cửa sổ ngữ cảnh hỗ trợ tối đa 100.000 token tổng cộng (đầu vào cộng đầu ra). Đầu ra tối đa mỗi yêu cầu là 32.000 token, hoặc 2.048 nếu max_tokens không được đặt. Các lỗi như 401 hoặc 402 không tiêu tốn tín dụng, nhưng chúng có tính vào giới hạn tốc độ của bạn. Các từ chối đối với các loại nội dung cụ thể cũng miễn phí.
