Khóa AI OpenRouter: Hướng dẫn bắt đầu nhanh

Base URL & Xác thực

Khóa API của bạn xác thực mọi yêu cầu đến endpoint của chúng tôi. Sử dụng URL cơ sở https://api.openrouteraikeys.com/v1 và chuyển khóa của bạn trong Authorization header. Cấu hình này hoạt động với bất kỳ SDK tương thích OpenAI nào vì chúng tôi mô phỏng mẫu xác thực tiêu chuẩn của họ. Bạn không cần sửa đổi thư viện khách hàng, chỉ cần cấu hình URL cơ bản.

• Tiêu đề: Authorization: Bearer YOUR_API_KEY
• Base URL: https://api.openrouteraikeys.com/v1

Yêu cầu đầu tiên

Gửi một yêu cầu hoàn tất hội thoại tiêu chuẩn để kiểm tra kết nối và định dạng phản hồi. ID mô hình là uncensored và nó xử lý các mảng tin nhắn tiêu chuẩn. Điểm cuối này chỉ trả về văn bản, vì vậy đừng mong đợi dữ liệu hình ảnh hoặc âm thanh trong tải trọng phản hồi.

Copycurl https://api.openrouteraikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this documentation page"}]
  }'

Tích hợp SDK Python

Khởi tạo client với khóa và URL cơ sở tùy chỉnh. Điều này cho phép bạn sử dụng giao diện quen thuộc chat.completions.create phương thức mà không cần bao bọc logic bổ sung. Thư viện tự động xử lý việc tuần tự hóa và logic thử lại cho bạn.

Copyfrom openai import OpenAI

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

Tích hợp SDK Node

Cấu hình OPENAI_API_KEY và OPENAI_BASE_URL environment variables or pass them directly to the client constructor. Điều này đảm bảo tất cả các lệnh gọi tiếp theo được định tuyến qua endpoint không kiểm duyệt của chúng tôi. Bạn có thể tiếp tục sử dụng phiên bản SDK mà bạn đã cài đặt.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouteraikeys.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 phát trực tiếp bằng cách đặt stream: true trong yêu cầu của bạn. API trả về các chunk Sự kiện gửi từ máy chủ (SSE) khi mô hình tạo văn bản. Thống kê sử dụng token xuất hiện trong chunk cuối cùng của luồng, cho phép bạn theo dõi chi phí theo thời gian thực mà không cần chờ phản hồi đầy đủ.

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 & Ngữ cảnh

Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100.000 token cho cả prompt và completion. Bạn bị giới hạn ở 300 yêu cầu mỗi phút mỗi key. Lỗi 401 có nghĩa là API key của bạn không hợp lệ hoặc bị thiếu. Lỗi 402 cho biết số dư trả trước không đủ. Lỗi 429 báo hiệu rằng bạn đã vượt quá giới hạn tốc độ. Các từ chối do chính sách nội dung là miễn phí, nhưng lỗi tính toán có thể tiêu tốn token.