Truy cập nhiều mô hình AI trong ứng dụng Python thông qua OpenRouter

--> Truy cập nhiều mô hình AI trong ứng dụng Python bằng OpenRouter - KDnuggets --> Blog Bài viết hàng đầu Giới thiệu Chủ đề AI Tư vấn nghề nghiệp Thị giác máy tính Kỹ thuật dữ liệu Khoa học dữ liệu Mô hình ngôn ngữ Học máy MLOps NLP Lập trình Python SQL Tập dữ liệu Sự kiện Tài nguyên Tài liệu tóm tắt Khuyến nghị Bản tin công nghệ Quảng cáo Đăng ký nhận bản tin Truy cập nhiều mô hình AI trong ứng dụng Python bằng OpenRouter Tìm hiểu cách bắt đầu với API của OpenRouter để gọi nhiều mô hình AI thông qua một API duy nhất, so sánh phản hồi, chuyển đổi mô hình và thiết lập cơ chế dự phòng tự động. Tác giả: Bala Priya C, Biên tập viên cộng tác kiêm Chuyên viên nội dung kỹ thuật của KDnuggets, ngày 28/10/2026 trong chuyên mục Trí tuệ nhân tạo --> Giới thiệu Giả sử một hệ thống trợ lý xử lý phiếu hỗ trợ đang được xây dựng, và cần so sánh cách các mô hình GPT, Claude và Llama xử lý cùng một thông điệp từ khách hàng trước khi đưa ra lựa chọn. Thông thường, quy trình này đòi hỏi phải đăng ký tài khoản với ba nhà cung cấp riêng biệt, tìm hiểu ba cơ chế xác thực khác nhau và viết lại mã yêu cầu ba lần chỉ để thực hiện một phép so sánh. OpenRouter loại bỏ sự trùng lặp đó. Nền tảng này đóng vai trò trung gian kết nối hàng chục nhà cung cấp thông qua một API duy nhất, giúp việc chuyển đổi giữa các mô hình chỉ cần thay đổi một dòng mã thay vì phải tích hợp lại từ đầu. Mã nguồn Python được giữ nguyên bất kể nhà cung cấp nào phản hồi yêu cầu. Bài viết này bao gồm các nội dung: Tạo tài khoản OpenRouter và nhận khóa API Gửi yêu cầu đầu tiên đến mô hình bằng Python thuần và thư viện requests Chuyển đổi mô hình bằng cách thay đổi một chuỗi ký tự duy nhất mà không cần sửa đổi phần mã khác Cho phép OpenRouter tự động lựa chọn mô hình và bổ sung các mô hình dự phòng nhằm bảo đảm độ tin cậy Nội dung sẽ được triển khai qua từng đoạn mã ngắn, bắt đầu từ bước thiết lập tài khoản. Điều kiện tiên quyết Người đọc không cần có nền tảng về AI hay học máy để thực hiện theo hướng dẫn. Tuy nhiên, người đọc cần nắm vững kiến thức cơ bản về Python, cách cài đặt các gói bằng pip và thiết lập biến môi trường trên terminal. OpenRouter đảm nhiệm việc tích hợp mô hình, do đó mã nguồn chỉ cần gửi văn bản và đọc phản hồi. Tạo tài khoản OpenRouter và khóa API Truy cập OpenRouter và tạo một tài khoản miễn phí. Sau khi đăng nhập, mở mục Keys từ trình đơn tài khoản và tạo một khóa API mới. Đặt một tên dễ nhận biết sau này, ví dụ learning-key, và giữ nguyên các thiết lập mặc định còn lại. Sao chép và lưu trữ khóa ở nơi an toàn. Cần lưu khóa dưới dạng biến môi trường để tránh việc vô tình đẩy lên kho lưu trữ mã nguồn. Trên macOS hoặc Linux: export OPENROUTER_API_KEY="your-key-here" Tóm tắt nhanh: Một số mô hình trên OpenRouter được cung cấp thử nghiệm miễn phí, do đó có thể thực hiện toàn bộ hướng dẫn này mà không cần bổ sung phương thức thanh toán. Thông tin chi tiết: OpenRouter gắn hậu tố :free cho một số mô hình nhất định; các mô hình này được điều hướng đến những phiên bản hoàn toàn miễn phí mà không yêu cầu phương thức thanh toán. Mọi ví dụ trong bài viết này đều sử dụng các mô hình nói trên, do đó toàn bộ quy trình có thể vận hành mà không phát sinh chi phí. Trường hợp mã định danh (ID) của mô hình không còn phản hồi tại thời điểm đọc bài, hãy kiểm tra danh sách cập nhật tại openrouter.ai/models với bộ lọc miễn phí, hoặc thay thế bằng openrouter/free — phương án sẽ được đề cập dưới đây và luôn tự động điều hướng đến mô hình miễn phí hiện khả dụng. Thiết lập dự án Khởi tạo một thư mục cho dự án và thiết lập môi trường ảo bên trong: mkdir support-bot-demo cd support-bot-demo python -m venv .venv source .venv/bin/activate Khi môi trường ảo đã được kích hoạt, tiến hành cài đặt thư viện requests. Đây là phần phụ thuộc duy nhất cần thiết. Do OpenRouter là một giao diện lập trình ứng dụng HTTP thuần túy (HTTP API), quy trình không đòi hỏi bộ công cụ phát triển phần mềm (SDK) chuyên dụng để khởi chạy: pip install requests Lưu ý: OpenRouter cũng cung cấp một SDK chính thức. Người dùng có thể cài đặt openrouter thông qua pip để sử dụng các đối tượng máy khách định kiểu thay vì các từ điển dữ liệu thô. Tài liệu hướng dẫn này chỉ sử dụng requests nhằm bảo đảm mọi yêu cầu đều được hiển thị dưới dạng JSON thuần túy, qua đó giúp việc theo dõi dữ liệu gửi đi và nhận về trở nên trực quan hơn trong quá trình tìm hiểu cấu trúc của API. Sau khi đã nắm vững phương thức vận hành, việc chuyển đổi sang SDK sau đó sẽ không gặp nhiều trở ngại. Gửi yêu cầu đầu tiên đến một mô hình Mọi yêu cầu gửi tới OpenRouter đều có cấu trúc đồng nhất, bất kể mô hình tiếp nhận xử lý là gì: một yêu cầu POST gửi tới một điểm cuối (endpoint), đi kèm khóa API (API key) trong phần tiêu đề (headers) và danh sách các thông điệp trong phần thân (body). Dưới đây là đoạn mã gửi thông điệp hỗ trợ khách hàng đến một mô hình và in kết quả phản hồi: import os import requests API_URL = "https://openrouter.ai/api/v1/chat/completions" API_KEY = os.getenv("OPENROUTER_API_KEY") customer_message = ( "My order #48213 arrived with the wrong charger. " "I need the correct one before Friday, can you help?" ) payload = { "model": "meta-llama/llama-3.2-3b-instruct:free", "messages": [ {"role": "system", "content": "You are a concise, polite customer support agent."}, {"role": "user", "content": customer_message}, ], } headers = { "Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json", } response = requests.post(API_URL, headers=headers, json=payload) data = response.json() print(f"Model used: {data['model']}") print(f"Reply: {data['choices'][0]['message']['content']}") Từ điển dữ liệu tải trọng (payload) chứa toàn bộ nội dung yêu cầu: trường model thông báo cho OpenRouter về mô hình cần áp dụng, được viết theo cấu trúc tên-nhà-cung-cấp/tên-mô-hình, còn trường messages tuân theo định dạng vai trò/nội dung (role/content) tương tự như cấu trúc sử dụng ở bất kỳ mô hình đàm thoại nào. Thông điệp hệ thống (system message) đóng vai trò thiết lập văn phong chung, trong khi thông điệp của người dùng (user message) là nội dung phiếu hỗ trợ thực tế. Kết quả trả về dưới định dạng JSON, với văn bản phản hồi nằm tại data["choices"][0]["message"]["content"] — cấu trúc tương đương với phần lớn các API hoàn thiện hội thoại (chat completion APIs), do OpenRouter đã chuẩn hóa phản hồi của mọi nhà cung cấp về cùng định dạng tương thích với OpenAI. Chuyển đổi các mô hình mà không cần thay đổi mã nguồn Do mô hình chỉ là một chuỗi ký tự trong tải trọng dữ liệu, việc so sánh