Các tính năng AI của Raycast hiện cho phép bạn cắm kết nối với bất kỳ nhà cung cấp tương thích OpenAI nào thông qua nhà cung cấp tùy chỉnh providers.yaml. CometAPI là một gateway API cung cấp hàng trăm mô hình phía sau một bề mặt REST kiểu OpenAI — vì vậy bạn có thể trỏ Raycast tới https://api.cometapi.com/v1, thêm khóa CometAPI của bạn và sử dụng các mô hình CometAPI trong Raycast AI (chat, lệnh, tiện ích mở rộng).
Raycast là gì?
Raycast là một trình khởi chạy năng suất cho macOS, tích hợp lệnh, script và — ngày càng nhiều — AI trực tiếp vào hệ điều hành của bạn. Hệ thống con AI của nó cung cấp chat, lệnh AI, lựa chọn mô hình, tiện ích mở rộng (công cụ cho phép LLM thực thi hành động), và khả năng dùng mô hình cục bộ (qua Ollama) hoặc Tự mang khóa/ Nhà cung cấp tùy chỉnh để kết nối nhà cung cấp mô hình từ xa. Raycast hiển thị bộ chọn mô hình, phần cài đặt AI, và một mẫu providers.yaml mà người dùng nâng cao có thể tùy chỉnh để thêm backend tương thích OpenAI.
Raycast đã triển khai BYOK (Bring Your Own Key) và Nhà cung cấp tùy chỉnh trong năm 2025, cho phép người dùng chạy Raycast AI bằng các khóa API và endpoint tùy chỉnh của riêng mình (giúp linh hoạt hơn trong quản lý chi phí và tùy chọn nhà cung cấp riêng tư). Thay đổi này là nền tảng kỹ thuật giúp tích hợp CometAPI khả thi ngay từ phần tùy chọn của Raycast.
Raycast đưa AI đến với người dùng như thế nào?
- Quick AI: nhắc lệnh tức thời từ launcher.
- AI Chat: phiên hội thoại có tệp đính kèm/ngữ cảnh.
- AI Commands/Extensions: các lệnh hoặc công cụ do developer xây dựng sử dụng LLM.
(Bạn có thể quản lý mô hình, khóa BYOK và nhà cung cấp tùy chỉnh tại Settings → AI.)
CometAPI là gì?
CometAPI là một nền tảng tổng hợp API cung cấp hàng trăm mô hình AI khác nhau (văn bản, hình ảnh, âm thanh, video, embedding) thông qua một bề mặt REST kiểu OpenAI duy nhất. Thay vì viết và bảo trì mã client riêng cho từng nhà cung cấp như OpenAI, Anthropic, Google, Midjourney, Runway, v.v., bạn gọi endpoint của CometAPI và chọn mô hình bạn muốn thông qua một chuỗi tên mô hình. Sự đơn giản hóa đó rất hữu ích cho thử nghiệm, định tuyến chi phí/dự phòng và tập trung hóa thanh toán cùng khả năng quan sát.
Năng lực chính
- Hoàn tất văn bản/chat và assistants (API chat giống OpenAI).
- Sinh ảnh và chỉnh sửa ảnh.
- Embedding cho tìm kiếm ngữ nghĩa/RAG (retrieval-augmented generation).
- Âm thanh (TTS và STT khi mô hình nền tảng hỗ trợ).
- Sinh video cho các backend chuyên biệt (Sora, Veo, v.v.).
CometAPI cũng cung cấp đoạn mã SDK và định dạng yêu cầu kiểu OpenAI nên việc chuyển mã hiện có rất đơn giản.
Vì sao điều đó quan trọng lúc này: thị trường đang dịch chuyển về các gateway API (endpoint hợp nhất tiện lợi, tùy chọn rẻ hơn và đa dạng mô hình). CometAPI là một trong các nhà cung cấp thương mại trong lĩnh vực này, nên kết hợp với hỗ trợ nhà cung cấp tùy chỉnh của Raycast cho bạn quyền truy cập ngay vào một danh mục mô hình rộng lớn ngay trong quy trình làm việc trên macOS.
Tại sao tích hợp CometAPI với Raycast?
Câu trả lời ngắn gọn: để chạy bất kỳ mô hình nào CometAPI cung cấp trực tiếp từ luồng Raycast AI của bạn — Quick AI, AI Chat, hoặc lệnh AI tùy chỉnh — mà không cần đổi công cụ.
Lợi ích:
- Dùng các mô hình rẻ/nhanh hơn hoặc chuyên biệt cho các tác vụ khác nhau (tóm tắt, mã, embedding, sinh ảnh) trong khi vẫn ở trong Raycast.
- Tập trung hóa thanh toán và kiểm soát tốc độ thông qua CometAPI trong khi lựa chọn mô hình từ Raycast.
- Thay đổi mã tối thiểu: Raycast hỗ trợ nhà cung cấp tùy chỉnh tương thích OpenAI và BYOK, vì vậy CometAPI thường chỉ cần thay
base_urlvà khóa API.
(Các khả năng này có được nhờ Raycast hỗ trợ nhà cung cấp tùy chỉnh và BYOK, và CometAPI cung cấp endpoint tương thích OpenAI tại https://api.cometapi.com/v1. )
Những trường hợp sử dụng tốt cho tích hợp này là gì?
- Trợ lý cho developer: giải thích mã, gợi ý tái cấu trúc, sinh unit test và tóm tắt PR — gọi từ Raycast và nhận trả lời inline.
- Ghi chú và tóm tắt: chọn đoạn văn bản, chạy lệnh Raycast để tóm tắt hoặc trích xuất hạng mục hành động bằng mô hình tóm tắt của CometAPI.
- Soạn tài liệu: sinh tài liệu hàm hoặc đoạn README thông qua lệnh AI của Raycast và lặp nhanh tại chỗ.
- Sinh ảnh/đa phương tiện: nếu CometAPI cung cấp endpoint ảnh, bạn có thể dùng extension Raycast gọi endpoint ảnh (ví dụ, extension “Generate Image from Prompt”) — hữu ích cho mockup nhanh.
- Embedding + tìm kiếm ngữ nghĩa: dùng embedding của CometAPI để hỗ trợ workflow tìm kiếm cục bộ — Raycast có thể là front end truy vấn chỉ mục embedding của bạn qua một script cục bộ nhỏ hoặc hàm đám mây.
Cần chuẩn bị môi trường và điều kiện gì?
Trước khi bắt đầu, đảm bảo bạn đã có:
Hệ thống & Raycast
- macOS (Raycast là ứng dụng gốc trên macOS).
- Cài đặt Raycast. Ưu tiên phiên bản mới hỗ trợ Nhà cung cấp tùy chỉnh / BYOK (Raycast thêm BYOK ở v1.100.0 và tiếp tục triển khai Nhà cung cấp tùy chỉnh). Nếu Raycast của bạn cũ hơn, hãy cập nhật.
Tài khoản & khóa
- Tài khoản CometAPI và khóa API CometAPI hợp lệ (bạn sẽ dùng trong cài đặt Raycast hoặc biến môi trường). Xem bảng điều khiển/tài liệu CometAPI.
Công cụ developer tùy chọn (để kiểm thử hoặc phát triển cục bộ)
- Terminal (để dùng cURL).
- Python / Node / SDK OpenAI nếu bạn muốn thử truy cập CometAPI trực tiếp trước khi nối vào Raycast. CometAPI hỗ trợ sử dụng trực tiếp qua các SDK tiêu chuẩn bằng cách override
base_url.
Quyền & mạng
- Đảm bảo Raycast và chính sách mạng của macOS cho phép gọi HTTPS tới
api.cometapi.com. - Nếu bạn ở môi trường doanh nghiệp có proxy/tường lửa, xác minh
api.cometapi.comcó thể truy cập được.
Tệp & vị trí cục bộ
Cấu hình providers của AI Raycast nằm trong providers.yaml dưới thư mục cấu hình của Raycast (ứng dụng có thể hiển thị mẫu providers để bạn sao chép). Bạn sẽ chỉnh/sửa providers.yaml để định nghĩa nhà cung cấp tùy chỉnh.
Làm thế nào để tích hợp Raycast với CometAPI?
Ý tưởng cốt lõi: đăng ký CometAPI làm nhà cung cấp tùy chỉnh tương thích OpenAI trong Raycast, trỏ Raycast tới https://api.cometapi.com/v1, và thêm token Comet của bạn vào phần khóa API tùy chỉnh của Raycast.
Bước 1: Lấy khóa CometAPI của bạn
- Đăng ký tại CometAPI và mở console/bảng điều khiển.
- Tạo một API token . Sao chép token này ở nơi an toàn (hoặc giữ lại cho bước tiếp theo).
Bước 2: Mở cài đặt AI của Raycast và bật nhà cung cấp tùy chỉnh
- Trong Raycast:
Preferences→AI. - Tìm “Custom Providers” (hoặc “Custom OpenAI-compatible APIs”) và bấm Reveal Providers Config. Raycast sẽ mở Finder tại thư mục cấu hình và cung cấp tệp mẫu (thường là
providers.template.yaml) để sao chép và đổi tên thànhproviders.yaml.
Bước 3: Thêm nhà cung cấp CometAPI vào providers.yaml
Tạo hoặc chỉnh sửa tệp providers.yaml. Lược đồ chính xác mà Raycast mong đợi có thể khác theo phiên bản, nhưng các mẫu cộng đồng và hướng dẫn Raycast cho thấy cấu trúc chung: danh sách các mục nhà cung cấp với id, name, base_url và một khối models tùy chọn. Dưới đây là một ví dụ an toàn, hoạt động để đăng ký CometAPI như một OpenAI-co
Lưu ý quan trọng
- Thay
YOUR_COMETAPI_KEYbằng một tham chiếu an toàn — hoặc dán token (cho dùng cá nhân) hoặc tốt hơn: lưu trong macOS Keychain / trường bảo mật của Raycast nếu được hỗ trợ. base_urllà dòng quan trọng: trỏ nó tớihttps://api.cometapi.com/v1. Raycast sẽ dùng base URL đó cho các cuộc gọi tương thích OpenAI.- Bạn không bắt buộc phải liệt kê trước tất cả mô hình — Raycast có thể lấy danh sách mô hình từ endpoint
GET /v1/modelskiểu OpenAI nếu nhà cung cấp của bạn có. Nếu CometAPI cung cấp danh sách mô hình, Raycast có thể làm mới và hiển thị các mô hình sẵn có.
Bước 4: Làm mới mô hình và kiểm thử
- Quay lại Raycast, bạn có thể cần khởi động lại ứng dụng hoặc dùng lệnh “Refresh Models” (tùy phiên bản) để Raycast lấy mô hình từ nhà cung cấp mới và điền vào bộ chọn mô hình. Nên làm mới hoặc khởi động lại nếu mô hình không xuất hiện.
- Dùng một Quick AI đơn giản, chọn mô hình của CometAPI từ bộ chọn mô hình và chạy một prompt thử.
Thực hành tốt khi dùng CometAPI trong Raycast
Thực hành bảo mật: Không hard-code token trong providers.yaml được chia sẻ. Ưu tiên trường bảo mật của Raycast hoặc macOS Keychain, hoặc inject khóa cục bộ bằng biến môi trường nếu bạn đang dùng proxy cục bộ. Đọc chính sách quyền riêng tư của cả CometAPI và Raycast nếu bạn có dữ liệu nhạy cảm.
Độ tin cậy & hiệu năng: Kiểm tra độ trễ của các mô hình bạn định dùng — gateway API có thể có định tuyến biến động. Với luồng tương tác (tự động tóm tắt, tra cứu nhanh) hãy ưu tiên mô hình nhỏ, nhanh. Với tác vụ suy luận sâu chọn mô hình dung lượng lớn, ngữ cảnh cao.
Kiểm soát chi phí: Tận dụng chọn mô hình một cách mạnh mẽ: chọn mô hình nhẹ cho tác vụ ngắn, mô hình dung lượng cao cho suy luận nặng. Theo dõi mức dùng trên bảng điều khiển của CometAPI và đặt cảnh báo ngân sách. Cân nhắc tối ưu prompt để giảm token (ví dụ, rút gọn thông điệp hệ thống, quản lý ngữ cảnh hiệu quả).
Prompt engineering & UX: Khi tạo Raycast AI Commands (nhân bản một lệnh dựng sẵn và chỉnh prompt), hãy giữ prompt quyết định (deterministic) cho các lệnh tiện ích (tóm tắt, phân loại, tìm kiếm) và cởi mở hơn cho luồng ý tưởng. Cách khuyến nghị là sao chép lệnh dựng sẵn và tùy chỉnh prompt.
Khắc phục sự cố thường gặp?
Mô hình không xuất hiện trong Raycast: Đảm bảo providers.yaml của Raycast nằm đúng thư mục được hiển thị bởi Reveal Providers Config. Dùng tệp mẫu làm nền và khởi động lại Raycast. Khởi động lại hoặc “Refresh Models” sẽ hữu ích.
401 / invalid token: Xác nhận token CometAPI của bạn hợp lệ và chưa hết hạn. Thử kiểm tra bằng curl như trên. Kiểm tra lại bạn dùng Bearer token và header Authorization đúng định dạng.
Lỗi mô hình hoặc khác biệt cấu trúc phản hồi: CometAPI hướng đến tương thích OpenAI nhưng có thể có một số trường hợp biên (model ID, hành vi streaming). Nếu Raycast kỳ vọng định dạng streaming cụ thể còn CometAPI trả về hơi khác, hãy thử gọi không-stream trước và liên hệ hỗ trợ CometAPI nếu cần.
Kết luận
CometAPI mang đến quyền truy cập hợp nhất, đa nhà cung cấp tới nhiều mô hình (văn bản, hình ảnh, âm thanh, video) và cho phép nhóm tập trung hóa thanh toán cùng định tuyến. Raycast mang lại một nơi tức thì, ưu tiên bàn phím để gọi các mô hình đó trong bối cảnh workflow trên desktop của bạn. Kết hợp lại, chúng giúp thử nghiệm mô hình và tự động hóa desktop trở nên liền mạch — bạn có thể hoán đổi mô hình vì chi phí hay chất lượng, giữ khóa cục bộ, và dùng cùng các mẫu yêu cầu kiểu OpenAI quen thuộc trong script và ứng dụng của mình.
Nếu muốn dùng ngay, hãy khám phá khả năng của models's(Gemini 3 Pro Preview API etc) của CometAPI trong Playground và tham khảo hướng dẫn API để biết hướng dẫn chi tiết. Trước khi truy cập, vui lòng đảm bảo bạn đã đăng nhập CometAPI và lấy khóa API. CometAPI cung cấp mức giá thấp hơn nhiều so với giá chính thức để giúp bạn tích hợp.
Sẵn sàng bắt đầu?→ dùng CometAPI trong Raycast ngay hôm nay !
Nếu bạn muốn biết thêm mẹo, hướng dẫn và tin tức về AI, hãy theo dõi chúng tôi trên VK, X và Discord!
