RaycastのAI機能では、providers.yaml のカスタムプロバイダーを通じて、任意のOpenAI互換プロバイダーを接続できるようになりました。CometAPIは、OpenAIスタイルのRESTインターフェースの背後で数百のモデルを提供するゲートウェイAPIです。そのため、Raycastの接続先を https://api.cometapi.com/v1 に設定し、CometAPIキーを追加すれば、Raycast AI（チャット、コマンド、拡張機能）内でCometAPIのモデルを利用できます。
Raycastとは？
Raycastは、コマンド、スクリプト、そして近年ではAIをmacOSに直接統合する生産性向上ランチャーです。そのAIサブシステムは、チャット、AIコマンド、モデル選択、拡張機能（LLMがアクションを実行できるツール群）、さらに ローカル モデル（Ollama経由）や Bring Your Own Key / Custom Providers を使ってリモートのモデルプロバイダーに接続する機能を提供します。Raycastはモデルピッカー、AI向け設定、そして上級ユーザーがOpenAI互換バックエンドを追加できる providers.yaml テンプレートを公開しています。
Raycastは2025年にBYOK（Bring Your Own Key）とCustom Providersの展開を進めており、ユーザーは自分自身のAPIキーやカスタムエンドポイントを使ってRaycast AIを実行できるようになりました（より柔軟なコスト管理やプライベートなプロバイダー利用が可能になります）。この変更が、エンドユーザーのRaycast設定からCometAPIを統合できる技術的基盤 です。
RaycastはAIをどのようにユーザーへ提供するのか？
- Quick AI: ランチャーから即座にプロンプトを実行。
- AI Chat: 添付ファイルやコンテキスト付きの対話セッション。
- AI Commands/Extensions: LLMを利用する開発者作成のコマンドやツール。
（モデル、BYOKキー、カスタムプロバイダーは Settings → AI から管理できます。）
CometAPIとは？
CometAPIは、単一のOpenAIスタイルRESTインターフェースを通じて、数百種類のAIモデル（テキスト、画像、音声、動画、埋め込み）を提供するAPI集約プラットフォームです。OpenAI、Anthropic、Google、Midjourney、Runwayなどに対してプロバイダーごとのクライアントコードを書く・保守する代わりに、CometAPIのエンドポイントを呼び出し、使いたいモデルをモデル文字列で指定するだけで利用できます。この単純化は、実験、コスト／フェイルオーバールーティング、請求や可観測性の一元化において強力です。
主な機能
- テキスト／チャット補完およびアシスタント（OpenAI風チャットAPI）。
- 画像生成および画像編集エンドポイント。
- セマンティック検索／RAG（検索拡張生成）のための埋め込み。
- 音声（基盤モデルが対応する場合のTTSおよびSTT）。
- 特定バックエンド向けの動画生成（Sora、Veoなど）。
CometAPIはSDKスニペットやOpenAIスタイルのリクエスト形式も提供しているため、既存コードの移行も容易です。
今これが重要である理由: 市場はゲートウェイAPI（便利な単一エンドポイント、より安価な選択肢、モデル選択の自由度）へとシフトしています。CometAPIはその領域の商用プレイヤーの1つであり、Raycastのカスタムプロバイダー対応と組み合わせることで、macOSワークフローから幅広いモデルカタログに即座にアクセスできます。
なぜCometAPIをRaycastと統合するのか？
短く言えば、CometAPIが提供する任意のモデルを、ツールを切り替えることなく、Raycast AIのフロー—Quick AI、AI Chat、またはカスタムAIコマンド—から直接実行するためです。
利点:
- Raycast内にとどまったまま、用途別により安価／高速／特化型のモデルを使い分けられる（要約、コード、埋め込み、画像生成など）。
- Raycastからモデル選択を制御しつつ、CometAPIで請求とスロットリングを一元管理できる。
- コード変更が最小限で済む。RaycastはOpenAI互換のカスタムプロバイダーとBYOKをサポートしているため、CometAPIは
base_urlとAPIキーを差し替えるだけで接続できることが多い。
（これらは、RaycastがカスタムプロバイダーとBYOKをサポートし、CometAPIが https://api.cometapi.com/v1. でOpenAI互換エンドポイントを公開しているため実現可能です。）
この統合の良いユースケースは？
- 開発者支援: コード説明、リファクタ提案、ユニットテスト生成、PR要約をRaycastから呼び出し、その場で回答を得る。
- ノートと要約: テキストを選択し、RaycastコマンドでCometAPIの要約モデルを使って要約やアクションアイテム抽出を行う。
- ドキュメント作成: Raycast AIコマンドで関数ドキュメントやREADME断片を生成し、ローカルで反復作業を続ける。
- 画像／マルチメディア生成: CometAPIが画像エンドポイントを提供している場合、画像エンドポイントを呼び出すRaycast拡張機能（例: "Generate Image from Prompt" 拡張機能）を使えます。クイックなモックアップ作成に便利です。
- 埋め込み + セマンティック検索: CometAPIの埋め込みを使ってローカル検索ワークフローを強化し、Raycastをフロントエンドとして、小さなローカルスクリプトやクラウド関数経由で埋め込みインデックスに問い合わせられます。
どのような環境や条件を準備すべきか？
始める前に、以下を用意してください。
システムとRaycast
- macOS（RaycastはmacOSネイティブです）。
- Raycast がインストール済みであること。Custom Providers / BYOKをサポートする比較的新しいバージョンが望ましいです（Raycastはv1.100.0でBYOKを追加し、その後もCustom Providersを展開中）。古い場合は更新してください。
アカウントとキー
- CometAPIアカウント と有効な CometAPI APIキー（Raycast設定または環境変数で使用します）。CometAPIのダッシュボード／ドキュメントを参照してください。
任意の開発者ツール（テストやローカル開発用）
- ターミナル（cURL用）。
- Python / Node / OpenAI SDKs。Raycastへ組み込む前にCometAPIアクセスを直接テストしたい場合に便利です。CometAPIは
base_urlを上書きすることで標準SDKから直接利用できます。
権限とネットワーク
- RaycastとmacOSのネットワークポリシーが
api.cometapi.comへのHTTPS通信を許可していることを確認してください。 - 企業環境でプロキシやファイアウォールを使用している場合は、
api.cometapi.comに到達可能であることを確認してください。
ローカルファイルと保存場所
RaycastのAI プロバイダー設定 は、Raycastの設定ディレクトリ配下の providers.yaml に保存されます（アプリからコピー可能なプロバイダーテンプレートを表示できます）。カスタムプロバイダーを定義するために providers.yaml を編集または作成します。
RaycastをCometAPIと統合するには？
中核となる考え方は、CometAPIをRaycast内でカスタムのOpenAI互換プロバイダーとして登録し、Raycastの接続先を https://api.cometapi.com/v1 に向け、CometトークンをRaycastのカスタムAPIキーに追加することです。
ステップ1: CometAPIキーを取得する
- CometAPI に登録し、コンソール／ダッシュボードを開きます。
- APIトークンを作成 します。トークンは安全な場所にコピーしておいてください（または次の手順ですぐ使えるように保持してください）。
ステップ2: RaycastのAI設定を開き、カスタムプロバイダーを有効にする
- Raycastで
Preferences→AIを開きます。 - “Custom Providers”（または “Custom OpenAI-compatible APIs”）を探し、Reveal Providers Config をクリックします。RaycastがFinderで設定ディレクトリを開き、テンプレートファイル（通常は
providers.template.yaml）を表示します。これをコピーしてproviders.yamlにリネームします。
ステップ3: providers.yaml にCometAPIプロバイダーを追加する
providers.yaml を作成または編集します。Raycastが期待する正確なスキーマはバージョンによって異なる可能性がありますが、コミュニティテンプレートやRaycastマニュアルでは、id、name、base_url、および任意の models ブロックを持つプロバイダーエントリの一覧という一般的な構造が示されています。以下は、CometAPIをOpenAI互換プロバイダーとして 登録する ための、安全で動作する例です。
重要な注意点
YOUR_COMETAPI_KEYは安全な参照先に置き換えてください。個人利用ならトークンを直接貼り付けてもよいですが、可能であればmacOSキーチェーンやRaycastの安全な入力欄を利用してください。- 重要なのは
base_urlの行です。これをhttps://api.cometapi.com/v1. に向けてください。RaycastはOpenAI互換の呼び出しにこのベースURLを使用します。 - すべてのモデルを事前に列挙する必要は厳密にはありません。プロバイダーが適切に実装したOpenAIスタイルの
GET /v1/modelsエンドポイントを公開していれば、Raycastはモデル一覧を取得できます。CometAPIがモデル一覧を公開している場合、Raycastは更新して利用可能なモデルを表示できます。
ステップ4: モデルを更新してテストする
- Raycastに戻り、新しいプロバイダーからモデルを取得してモデルピッカーへ反映するために、アプリの再起動または“Refresh Models”コマンド（バージョン依存）が必要になる場合があります。モデルが表示されない場合は、更新または再起動をおすすめします。
- シンプルなQuick AIプロンプトを使い、モデルピッカーからCometAPIのモデルを選択してテストプロンプトを実行してください。
Raycast内でCometAPIを使う際のベストプラクティス
セキュリティのベストプラクティス: 共有される providers.yaml にトークンをハードコードしないでください。可能であればRaycastの安全な入力欄やmacOSキーチェーンを使用し、ローカルプロキシを使う場合は環境変数でキーを注入してください。機密データを扱う場合は、CometAPIとRaycastの両方のプライバシードキュメントを確認してください。
信頼性とパフォーマンス: 使用予定のモデルについて レイテンシをテスト してください。ゲートウェイAPIはルーティングによって応答時間が変動することがあります。対話型ワークフロー（自動要約、素早い検索など）には小型で高速なモデルを、より深い推論タスクには高コンテキストなモデルを選ぶのが適しています。
コスト管理: モデル選択 を積極的に行ってください。短いタスクには軽量モデルを、重い推論には高性能モデルを使い分けます。CometAPIのダッシュボードで使用量を追跡し、予算アラートを設定しましょう。トークン使用量を減らすため、プロンプトも工夫してください（例: 短いシステムメッセージ、効率的なコンテキスト管理）。
プロンプト設計とUX: RaycastのAIコマンドを作成する際（内蔵コマンドを複製してプロンプトを調整する方法）、実用系コマンド（要約、トリアージ、検索）では決定的なプロンプトを保ち、アイデア出し系ワークフローではより自由度の高いプロンプトにするとよいでしょう。内蔵コマンドをコピーしてプロンプトをカスタマイズする方法が推奨されています。
よくある問題のトラブルシューティング方法
Raycastにモデルが表示されない: Raycastの providers.yaml が、Reveal Providers Config で表示された正確なフォルダーに置かれているか確認してください。テンプレートをベースにして、Raycastを再起動してください。再起動または“Refresh Models”が有効です。
401 / 無効なトークン: CometAPIトークンが有効で期限切れでないことを確認してください。上記のcurlテストを試してください。Bearerトークンを使用していること、Authorization ヘッダーが正しいことを再確認してください。
モデルエラーまたは互換性のないレスポンス形式: CometAPIはOpenAI互換を目指していますが、いくつかのエッジケース（モデルID、ストリーミング動作など）が存在する可能性があります。Raycastが特定のストリーミング形式を期待していて、CometAPIがわずかに異なる形式を返す場合は、まず非ストリーミング呼び出しを試し、必要に応じてCometAPIサポートへ問い合わせてください。
結論
CometAPI は、多くのモデル（テキスト、画像、音声、動画）への統一されたマルチベンダーアクセスを提供し、チームが請求とルーティングを一元化できるようにします。Raycast は、デスクトップワークフローの文脈でそれらのモデルを呼び出せる、即時性の高いキーボード中心のインターフェースを提供します。両者を組み合わせることで、モデル実験やデスクトップ自動化は非常にスムーズになります。コストや品質に応じてモデルを切り替え、キーをローカルに保持しつつ、スクリプトやアプリで既に使い慣れたOpenAIスタイルのパターンをそのまま利用できます。
すぐに試したい場合は、Playground でCometAPIの models's(Gemini 3 Pro Preview API etc) capabilities を確認し、詳細な手順についてはAPIガイドを参照してください。アクセス前に、CometAPIへログインし、APIキーを取得済みであることを確認してください。CometAPI offer a price far lower than the official price to help you integrate.
準備はできましたか？→ 今すぐRaycastでCometAPIを使う !