OpenRouter: API hợp nhất cho nhiều mô hình AI

OpenRouter cung cấp danh mục mô hình chung và lớp API để nhà phát triển chọn nhiều mô hình cũng như nhà cung cấp AI. Trang chính thức giới thiệu mô hình văn bản, hình ảnh, video và âm thanh, cùng cách tích hợp qua API, SDK máy khách và Agent SDK. Năng lực, giá, giới hạn ngữ cảnh, khu vực hỗ trợ và chính sách của nhà cung cấp không giống nhau. Trước khi tích hợp, hãy xem danh mục mô hình, tài liệu chính thức và trang giá.

Tính năng chính

• API và danh mục hợp nhất: tìm và gọi các mô hình hiện có qua một API. Danh mục hiển thị mô tả và giá hiện hành; có thể lấy danh sách mô hình qua API.
• Tương thích OpenAI SDK: tài liệu chính thức hướng dẫn cách kết nối. Việc chuyển đổi vẫn cần cấu hình URL cơ sở API OpenRouter, khóa và mã mô hình, đồng thời xác nhận mô hình hỗ trợ các tham số cần thiết.
• SDK máy khách và Agent SDK: có tài liệu cho SDK máy khách JavaScript/TypeScript và Python. Agent SDK hỗ trợ quy trình tác nhân có gọi công cụ, vòng hội thoại và quản lý trạng thái. Hãy xem tài liệu đúng phiên bản đang dùng.
• Định tuyến mô hình và nhà cung cấp: tùy chọn định tuyến và dự phòng có thể giúp khi mô hình hoặc nhà cung cấp không khả dụng. Hành vi tùy thuộc yêu cầu, endpoint và gói dịch vụ; không bảo đảm luôn chọn giá thấp nhất hay hoạt động liên tục.
• Tính phí theo mô hình: chi phí suy luận dựa trên giá công bố của mô hình đã chọn. Các gói có thể khác nhau về phí nền tảng, quyền truy cập mô hình, công cụ ngân sách và tính năng khác. Giá và điều khoản có thể thay đổi.
• Kiểm soát chính sách dữ liệu: mỗi nhà cung cấp có quy tắc xử lý riêng. OpenRouter mô tả tùy chọn lọc nhà cung cấp theo tài khoản hoặc từng yêu cầu. Trước khi gửi dữ liệu nhạy cảm, hãy kiểm tra chính sách nhà cung cấp và cài đặt quyền riêng tư.

Cách bắt đầu

1. Tạo tài khoản và xem gói dịch vụ, danh mục mô hình, cách tính phí và chính sách dữ liệu hiện hành.
2. Tạo khóa API trong bảng điều khiển và lưu trong biến môi trường hoặc trình quản lý bí mật. Không đưa khóa vào kho mã, ứng dụng máy khách hay nhật ký.
3. Chọn mô hình và đọc yêu cầu về đầu vào, đầu ra, công cụ và đa phương thức. Với OpenAI SDK, cấu hình baseURL, khóa và tên mô hình theo hướng dẫn chính thức.
4. Trước khi kết nối dữ liệu thật, hãy kiểm tra định dạng yêu cầu, hóa đơn, xử lý lỗi và tùy chọn dự phòng bằng dữ liệu không nhạy cảm.
5. Đặt ngân sách hoặc giới hạn khóa và thường xuyên xem mức sử dụng, chi phí và chính sách nhà cung cấp.

Mục đích và giới hạn

OpenRouter phù hợp với nhà phát triển muốn quản lý nhiều lựa chọn mô hình qua một API. Có thể dùng để so sánh mô hình, xây dựng luồng trò chuyện hoặc tác nhân, và gọi mô hình hình ảnh hoặc âm thanh được hỗ trợ. Gọi công cụ, đầu ra có cấu trúc và tính năng đa phương thức tùy thuộc mô hình và endpoint. Giao diện chung giảm một số khác biệt tích hợp nhưng không loại bỏ khác biệt về tham số, giá, giới hạn và hành vi. Không có bảo đảm về độ trễ cố định, độ chính xác hoặc tính sẵn sàng.

Yêu cầu được chuyển đến mô hình và nhà cung cấp đã chọn. Cài đặt dữ liệu của OpenRouter và chính sách của nhà cung cấp là hai phần riêng. Trước khi gửi mã nguồn, dữ liệu khách hàng hoặc thông tin cá nhân, hãy kiểm tra thời gian lưu trữ, việc dùng dữ liệu để huấn luyện, khu vực xử lý và nhật ký. Kiểm tra an toàn và tính đúng đắn của kết quả AI trong ứng dụng. Chi phí thay đổi theo mô hình và điều kiện dịch vụ; hãy tính cả lỗi và phương án dự phòng vào ước tính cũng như kiểm thử.

Câu hỏi thường gặp

OpenRouter là gì?

Đây là nền tảng API đa mô hình có danh mục, API hợp nhất và công cụ phát triển như SDK. Danh mục hiện hành cho biết mô hình và endpoint sẵn có.

Có thể dùng OpenAI SDK không?

Tài liệu chính thức mô tả kết nối tương thích. Thông thường cần đặt baseURL, khóa API, tên mô hình và kiểm tra tham số cần thiết có được hỗ trợ không.

Chi phí được tính thế nào?

Chi phí suy luận dựa trên giá công bố của mô hình; gói dịch vụ có thể có phí hoặc quyền lợi khác. Hãy xem giá và thông tin tính phí hiện tại.

Dữ liệu yêu cầu được xử lý ra sao?

OpenRouter và từng nhà cung cấp có chính sách riêng. Kiểm tra nhật ký, việc sử dụng dữ liệu, bộ lọc nhà cung cấp trong tài khoản và quy tắc lưu trữ của nhà cung cấp đã chọn.