The OpenRouter API Đã giải thích

API tương thích OpenAI là gì?

Đó là một REST API tuân theo giao diện chat-completions của OpenAI. Bạn gửi các prompt và nhận đầu ra văn bản bằng các tải trọng JSON tiêu chuẩn. Sự tương thích này có nghĩa là mã khách hàng hiện tại của bạn hoạt động mà không cần thay đổi lớn.

Điểm cuối chính là POST /v1/chat/completions. Nó chấp nhận danh sách các đối tượng role và content dưới dạng mảng. Bạn cũng có thể liệt kê các mô hình khả dụng qua GET /v1/models. Sự chuẩn hóa này giúp giảm đáng kể thời gian tích hợp.

Dịch vụ của chúng tôi cung cấp chính xác giao diện này. Chúng tôi phục vụ một mô hình không kiểm duyệt duy nhất dưới ID "uncensored". Nó chạy trên máy chủ của chúng tôi. Nó không định tuyến đến các nhà cung cấp khác. Bạn có quyền truy cập trực tiếp vào mô hình bạn cần.

Cửa sổ ngữ cảnh hỗ trợ lên đến 100,000 token tổng cộng. Giới hạn đầu ra là 16,000 token mỗi yêu cầu. Tính năng phát trực tiếp (streaming) có sẵn qua Server-Sent Events. Gọi hàm và chế độ JSON được hỗ trợ đầy đủ.

Hiểu URL cơ sở và khóa API

URL cơ sở trỏ đến máy chủ xử lý các yêu cầu của bạn. Bạn thay thế URL OpenAI mặc định bằng điểm cuối cụ thể của chúng tôi. URL cơ sở của chúng tôi là HTTPS://api.openrouterabliterated.com/v1. Thay đổi này định hướng lưu lượng truy cập đến cơ sở hạ tầng không kiểm duyệt của chúng tôi.

Khóa API xác thực các yêu cầu của bạn. Bạn tạo một khóa mỗi tài khoản. Khóa được hiển thị ngay sau khi đăng ký. Bạn có thể thay thế nó nếu cần. Mỗi tài khoản chỉ giữ một khóa hoạt động tại một thời điểm.

Giới hạn tốc độ được áp dụng theo từng khóa. Bạn có thể gửi 300 yêu cầu mỗi phút. Tối đa 8 yêu cầu có thể chạy đồng thời. Kích thước thân yêu cầu được giới hạn ở 8 MB. Các giới hạn này xử lý tốt các trường hợp sử dụng khối lượng lớn.

Đăng ký chỉ yêu cầu một địa chỉ email hoặc tài khoản Google. Không cần số điện thoại. Khóa xuất hiện ngay lập tức. Bạn có thể bắt đầu gửi yêu cầu ngay lập tức. Quyền riêng tư được bảo toàn; các lời nhắc không được sử dụng để huấn luyện.

Tại sao chọn một Mô hình không kiểm duyệt cho trường hợp sử dụng của bạn?

Các mô hình không kiểm duyệt không từ chối các chủ đề người lớn hợp pháp, hư cấu hoặc gây tranh cãi. Chúng rất lý tưởng cho việc viết sáng tạo, nhập vai hoặc nghiên cứu. Các mô hình phổ biến thường áp dụng các rào chắn nghiêm ngặt. Những rào chắn này có thể làm gián đoạn luồng tạo nội dung.

Mô hình của chúng tôi được tinh chỉnh để trả lời trực tiếp. Nó xử lý nội dung NSFW mà không có sự phản đối. Nó hoạt động tốt cho triết học chính trị hoặc các thể loại ngách. Bạn nhận được hành vi nhất quán mà không cần thêm prompt.

Tool use is supported. You can define tools for your application. The model respects tool choices. This makes it suitable for complex workflows. Errors and refusals are free. You only pay for real usage.

Giới hạn nội dung vẫn áp dụng. Nội dung tình dục liên quan đến trẻ vị thành niên luôn bị từ chối. Đây là giới hạn cứng. Nó đảm bảo các tiêu chuẩn an toàn cơ bản. Mọi thứ khác đều phù hợp cho trường hợp sử dụng của bạn.

Giá Token: Cách Tính Chi Phí

Giá dựa trên mức sử dụng token. Token đầu vào có giá $0.15 cho mỗi triệu token. Token đầu ra có giá $0.50 cho mỗi triệu token. Bạn chỉ trả tiền cho những gì mình sử dụng. Không có phí ẩn.

Tín dụng được trả trước. Bạn nạp tiền chỉ bằng tiền điện tử. USDT trên TRC20 hoặc USDC trên Base được chấp nhận. Bất kỳ khoản nguyên nào từ $20 đến $500 đều được phép. Tín dụng không bao giờ hết hạn. Điều này tránh bị khóa đăng ký.

Số dư thưởng có sẵn khi nạp tiền. Bạn nhận được +5% từ $50. +10% từ $100. +15% từ $200. Điều này giảm chi phí hiệu dụng của bạn. Lỗi miễn phí. Từ chối miễn phí. Bạn chỉ trả tiền cho các token thành công.

Tài khoản dùng thử được cấp $0,50. Thời hạn sử dụng là 7 ngày. Điều này cho phép bạn kiểm tra API toàn diện. Bạn có thể xác minh tích hợp trước khi cam kết nạp tiền.

Phản hồi Streaming so với Không Streaming

Streaming gửi token khi chúng được tạo ra. Điều này giảm độ trễ cảm nhận. Người dùng thấy văn bản xuất hiện theo thời gian thực. Nó rất quan trọng cho các giao diện trò chuyện. Không streaming chờ toàn bộ phản hồi. Điều này có thể cảm thấy chậm đối với các đầu ra dài.

Chúng tôi hỗ trợ streaming qua SSE. Chunk cuối cùng bao gồm thông tin sử dụng token. Điều này cho phép theo dõi hóa toán chính xác. Bạn có thể xử lý các phản hồi từng phần một cách mượt mà. Lỗi được xử lý nhất quán.

Chế độ không streaming cũng có sẵn. Nó trả về toàn bộ phản ứng cùng một lúc. Điều này đơn giản hơn cho xử lý hàng loạt. Bạn chọn dựa trên nhu cầu của mình. Cả hai chế độ đều sử dụng cùng một điểm cuối.

Gọi hàm có thể được phát trực tiếp (streaming). Các công cụ được thực thi ngay khi được xác định. Điều này cải thiện tính tương tác. Bạn có thể bắt đầu xử lý đầu vào sớm hơn. API xử lý mọi độ phức tạp cho bạn.

Function Calling và đầu ra có cấu trúc

Gọi hàm cho phép mô hình gọi các công cụ. Bạn xác định lược đồ công cụ trong yêu cầu. Mô hình trả về các lệnh gọi hàm. Mã của bạn thực thi chúng. Điều này cho phép các quy trình làm việc phức tạp. Bạn có thể xây dựng các agent hoặc trợ lý.

Chế độ JSON bắt buộc đầu ra có cấu trúc. Mô hình trả về JSON hợp lệ. Điều này hữu ích cho việc trích xuất dữ liệu. Bạn nhận được các định dạng nhất quán. Việc phân tích cú pháp dễ dàng hơn. Lỗi hiếm khi xảy ra.

Các tham số như nhiệt độ và top_p kiểm soát hành vi. Các chuỗi dừng giới hạn đầu ra. Seeds đảm bảo khả năng tái lập. Các hình phạt giảm sự lặp lại. Bạn có quyền kiểm soát chi tiết.

Tool choice can be automatic or forced. You specify the model's preference. This guides the generation process. It improves reliability. Your application stays robust.

Các thư viện khách và SDK phổ biến

Hầu hết các SDK hoạt động với những thay đổi nhỏ. Bạn chỉ cần cập nhật base URL. Phần còn lại của mã vẫn giữ nguyên. Điều này áp dụng cho Python, Node.js và các ngôn ngữ khác. Việc tích hợp rất đơn giản.

SDK OpenAI là tiêu chuẩn. Nó xử lý xác thực và thử lại. Bạn truyền khóa API của mình. URL cơ trỏ đến dịch vụ của chúng tôi. Các yêu cầu được gửi bình thường.

Streaming được hỗ trợ trong tất cả các SDK. Bạn lặp qua các chunk. Việc sử dụng token có sẵn trong chunk cuối cùng. Điều này phù hợp với mô hình tính phí của chúng tôi. Lỗi được bắt một cách nhất quán.

Gọi hàm được tích hợp sẵn trong các SDK hiện đại. Bạn truyền các định nghĩa công cụ. SDK phân tích cú pháp phản hồi. Mã của bạn thực thi các công cụ. Vòng lặp tiếp tục cho đến khi hoàn tất. Nó hiệu quả và đáng tin cậy.

Khắc phục Các Lỗi API Phổ Biến

Giới hạn tốc độ trả về lỗi 429. Bạn có thể gửi 300 yêu cầu mỗi phút. Vượt quá giới hạn này sẽ kích hoạt thời gian chờ. Hãy triển khai cơ chế backoff theo cấp số nhân. Điều này ngăn chặn việc làm quá tải máy chủ.

Các khóa không hợp lệ trả về lỗi 401. Hãy kiểm tra API key của bạn. Đảm bảo nó đang hoạt động. Thay thế nếu cần. Mỗi tài khoản có một khóa. Tạo khóa mới nếu bị mất.

Lỗi JSON xảy ra ở chế độ JSON. Hãy đảm bảo lược đồ của bạn hợp lệ. Mô hình phải trả về JSON hợp lệ. Nếu thất bại, hãy thử lại. Điều chỉnh nhiệt độ để tăng độ ổn định.

Thời gian chờ xảy ra với các quá trình tạo dài. Tăng giá trị thời gian chờ của bạn. Truyền trực tiếp giảm rủi ro thời gian chờ. Các phản hồi một phần được xử lý. Bạn có thể tái tạo đầu ra đầy đủ.

Các bước tiếp theo: Lấy Khóa API Đầu tiên của Bạn

Truy cập trang đăng ký. Sử dụng Google hoặc email. Không cần số điện thoại. Quy trình nhanh chóng. Bạn có quyền truy cập ngay lập tức.

Khóa API của bạn được hiển thị. Sao chép nó một cách an toàn. Sử dụng nó trong SDK của bạn. Đặt URL cơ sở thành điểm cuối của chúng tôi. Bắt đầu gửi yêu cầu.

Nạp tiền bằng crypto. USDT hoặc USDC được chấp nhận. Nhận tín dụng bonus cho các khoản lớn hơn. Tín dụng không bao giờ hết hạn. Sử dụng chúng theo tốc độ của bạn.

Thử nghiệm với tín dụng dùng thử. Nó kéo dài 7 ngày. Xác minh phát trực tiếp và gọi hàm. Khám phá các khả năng của mô hình. Tích hợp nó vào ứng dụng của bạn. API đã sẵn sàng cho sản xuất.