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 bên 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 các 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 hiện hành động), và khả năng sử dụng các mô hình cục bộ (qua Ollama) hoặc Bring Your Own Key / Custom Providers để kết nối với các nhà cung cấp mô hình từ xa. Raycast cung cấp bộ chọn mô hình, cài đặt cho 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 đã và đang triển khai BYOK (Bring Your Own Key) và Custom Providers trong năm 2025, cho phép người dùng chạy Raycast AI bằng chính khóa API và endpoint tùy chỉnh của họ (tạo điều kiện quản lý chi phí linh hoạt hơn và 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 trở nên khả thi từ phần tùy chọn của người dùng Raycast.
Raycast đưa AI đến người dùng như thế nào?
- Quick AI: nhắc lệnh tức thì từ launcher.
- AI Chat: phiên hội thoại với tệp đính kèm/ngữ cảnh.
- AI Commands/Extensions: các lệnh hoặc công cụ do nhà phát triển 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ừ 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, embeddings) thông qua một bề mặt REST kiểu OpenAI duy nhất. Thay vì viết và duy trì mã client riêng cho 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 định danh mô hình. Sự đơn giản hóa đó rất mạnh mẽ cho thử nghiệm, định tuyến theo chi phí/dự phòng và tập trung hóa thanh toán cũng như khả năng quan sát.
Khả năng chính
- Hoàn thành văn bản/chat và assistants (API chat kiểu OpenAI).
- Tạo ảnh và chỉnh sửa ảnh.
- Embeddings cho tìm kiếm ngữ nghĩa/RAG (retrieval-augmented generation).
- Âm thanh (TTS và STT khi được các mô hình nền tảng hỗ trợ).
- Tạo video cho backend chuyên biệt (Sora, Veo, v.v.).
CometAPI cũng cung cấp các đoạn mã SDK và định dạng yêu cầu kiểu OpenAI để việc chuyển đổi mã hiện có trở nên đơn giản.
Tại sao điều đó quan trọng lúc này: thị trường đang chuyển dịch sang các gateway API (endpoint đơn thuận tiện, tùy chọn rẻ hơn và đa dạng mô hình). CometAPI là một trong những nhà cung cấp thương mại trong không gian này, vì vậy kết hợp nó với hỗ trợ nhà cung cấp tùy chỉnh của Raycast giúp bạn có quyền truy cập ngay lập tức 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: để chạy bất kỳ mô hình nào do CometAPI cung cấp trực tiếp từ luồng Raycast AI của bạn — Quick AI, AI Chat hoặc các lệnh AI tùy chỉnh — mà không cần đổi công cụ.
Lợi ích:
- Sử 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ã, embeddings, tạo ảnh) trong khi vẫn ở trong Raycast.
- Tập trung hóa thanh toán và hạn mức qua CometAPI trong khi kiểm soát 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.
(Những khả năng này có được vì Raycast hỗ trợ nhà cung cấp tùy chỉnh và BYOK, và CometAPI cung cấp các 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?
- Trợ lý cho nhà phát triển: giải thích mã, gợi ý tái cấu trúc, tạo unit test và tóm tắt PR — gọi từ Raycast và nhận câu trả lời trực tiếp.
- Ghi chú và tóm tắt: chọn văn bản, chạy lệnh Raycast để tóm tắt hoặc trích xuất mục hành động bằng một mô hình tóm tắt của CometAPI.
- Soạn tài liệu: tạo 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ỗ.
- Tạo ảnh/đa phương tiện: nếu CometAPI cung cấp endpoint ảnh, bạn có thể dùng các tiện ích mở rộng Raycast gọi endpoint ảnh (ví dụ, tiện ích "Generate Image from Prompt") — hữu ích cho mockup nhanh.
- Embeddings + tìm kiếm ngữ nghĩa: dùng embeddings của CometAPI để tăng cường quy trình tìm kiếm cục bộ — Raycast có thể là giao diện truy vấn chỉ mục embeddings của bạn thông qua một script cục bộ nhỏ hoặc một 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, hãy đảm bảo bạn đã chuẩn bị các mục sau:
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ợ Custom Providers / BYOK (Raycast thêm BYOK từ v1.100.0 và tiếp tục triển khai Custom Providers). Nếu Raycast của bạn cũ, 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ụ nhà phát triển tùy chọn (để thử nghiệm hoặc phát triển cục bộ)
- Terminal (dùng cURL).
- Python / Node / OpenAI SDKs 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ợ dùng trực tiếp qua các SDK chuẩn bằng cách ghi đè
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.
Tệp & vị trí cục bộ
Cấu hình nhà cung cấp AI của 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 hoặc tạo providers.yaml để định nghĩa các nhà cung cấp tùy chỉnh.
Tôi tích hợp Raycast với CometAPI như thế nào?
Ý tưởng cốt lõi: đăng ký CometAPI như một nhà cung cấp tương thích OpenAI tùy chỉnh trong Raycast, trỏ Raycast tới https://api.cometapi.com/v1, và thêm token Comet vào phần API key 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 một tệp mẫu (thường là
providers.template.yaml) để bạn sao chép và đổi tên thànhproviders.yaml.
Bước 3: Thêm một 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 template cộng đồng và hướng dẫn của 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 mục đích 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ỏ vềhttps://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 nhất thiết 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 cung cấp. Nếu CometAPI có 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 danh sách 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 danh sách 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 và chạy một nhắc lệnh thử.
Thực tiễn tốt nhất khi sử dụng CometAPI trong Raycast
Thực hành bảo mật: Không hard-code token trong providers.yaml dùng chung. Ưu tiên trường bảo mật của Raycast hoặc macOS Keychain, hoặc chèn khóa cục bộ bằng biến môi trường nếu bạn dùng proxy cục bộ. Đọc tài liệu bảo mậ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ễ cho các mô hình bạn định dùng — gateway API có thể có định tuyến biến thiên. Với quy trình 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ụ lý luận sâu, chọn mô hình ngữ cảnh lớn.
Kiểm soát chi phí: Tận dụng lựa chọn mô hình một cách tích cực: 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 sử dụng trên bảng điều khiển của CometAPI và đặt cảnh báo ngân sách. Xem xét tối ưu prompt có lập trình để giảm token (ví dụ, thông điệp hệ thống ngắn hơn, quản lý ngữ cảnh hiệu quả).
Kỹ thuật prompt & trải nghiệm: Khi tạo Raycast AI Commands (nhân bản một lệnh có sẵn và tinh chỉnh prompt), hãy giữ prompt mang tính xác định cho lệnh tiện ích (tóm tắt, phân loại, tìm kiếm) và mở hơn cho các luồng ý tưởng. Cách khuyến nghị là sao chép lệnh tích hợp sẵn và tùy biến prompt.
Cách khắc phục sự cố thường gặp?
Mô hình không hiển thị trong Raycast: Đảm bảo providers.yaml của Raycast nằm đúng thư mục được mở bởi Reveal Providers Config. Dùng tệp mẫu làm cơ sở và khởi động lại Raycast. Khởi động lại hoặc “Refresh Models” thường hữu ích.
401 / invalid token: Xác nhận token CometAPI hợp lệ và chưa hết hạn. Thử bài test curl ở trên. Kiểm tra kỹ bạn dùng Bearer token và header Authorization đã đúng.
Lỗi mô hình hoặc hình dạng phản hồi không tương thích: CometAPI hướng tới tương thích OpenAI nhưng có một số trường hợp cạnh (ID mô hình, hành vi streaming). Nếu Raycast kỳ vọng định dạng streaming cụ thể và 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 cung cấp 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à giúp đội ngũ tập trung hóa thanh toán cũng như định tuyến. Raycast mang đến 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 quy trình làm việc 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 không ma sát — bạn có thể thay đổi mô hình theo chi phí hoặc chất lượng, giữ khóa cục bộ và dùng cùng các mẫu kiểu OpenAI quen thuộc mà bạn đã có trong script và ứng dụng.
Nếu bạn muốn thử ngay, hãy khám phá các 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 chỉ 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 để hỗ trợ bạn tích hợp.
Sẵn sàng bắt đầu?→ use CometAPI in Raycast today !
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!