# プロバイダー URL: /ja/docs/providers 自分のAPIキーを持ち込み、接続ウィザードを実行し、ハウスを切り替えても同じエージェントワークフローを維持します。 Spirit AgentはBYOKです。プロバイダーのコンソールでキーを作成し、それをDesktopまたはCLIに貼り付けます。SpiritはそれをOSのキーリングに保存します。ハウスを切り替えても、ワークスペースの開き方、編集の承認方法、エージェントの実行方法は変わりません。 接続ウィザードは、Desktopでは**Settings → Models**、CLIでは`/model add`または`spirit model add`です。追加フィールドは、そのプロバイダーが必要とする場合にのみ表示されます。 Spiritは4つのトランスポートのいずれかでプロバイダーと通信します。ウィザードはタイプを固定するか、選択させます。 | トランスポート | ウィザードのラベル | 一般的な用途 | | ------------------- | ---------------------------------- | ------------------------------------------------------------- | | `openai-compatible` | Chat Completions API | ほとんどのOpenAI互換エンドポイント | | `open-responses` | Responses API / Open Responses API | OpenAI、Azure、Vercel AI Gateway、Hugging Face、およびオプションのゲートウェイパス | | `anthropic` | Messages API | Anthropic、MiniMax、およびオプションのMessages互換エンドポイント | | `bedrock` | Amazon Bedrock | Amazon Bedrockのみ | Google GeminiとVertex AIは常にChat Completionsを使用します。プロファイルがResponsesまたはMessagesを要求する場合、Spiritは`openai-compatible`にフォールバックします。 一部のハウスでは、キーに加えて2番目の次元が追加されます： * **リージョンサイト** — Moonshot AI、SiliconFlow、MiniMax（中国/国際）；Alibaba（リージョン + `workspaceId`）；Tencent TokenHub（広州/シンガポール） * **プランエンドポイント** — Alibaba Token Plan、StepFun Step Plan、Z.ai / Zhipu AI GLM Coding Plan * **クラウドフィールド** — Bedrockリージョン、Azureリソース名、Cloudflareアカウント（およびオプションのゲートウェイ）、Vertexプロジェクト/ロケーション これらのいずれも持たないプロバイダーの場合、ウィザードはキー → モデルのインポート → アクティブなチャットモデルの選択だけです。 Spiritはモデルカタログをインポートし、アクティブなチャットモデルを割り当てることができます。さらに、カタログがその機能をマークしている場合、画像/ビデオ/軽量チャットのスロットも割り当てられます。推論と組み込みのウェブ検索は、モデルとトランスポートに従い、Spiritの別のトグルではありません。 ## カタログ [#カタログ] これらは接続ピッカーに表示されるハウスで、同じ順序です。各セクションは、そのハウスのキー、トランスポート、追加フィールドです。上記のDesktopおよびCLIウィザードは、すべてのハウスで同じです。 ### OpenAI [#openai] [OpenAIプラットフォーム](https://platform.openai.com/api-keys)でAPIキーを作成します。SpiritはOpenAIの使用量を販売しません。 ウィザードは**Responses API**（`open-responses`）を固定します。トランスポートのピッカーはありません。デフォルトのベース：`https://api.openai.com/v1`。 インポート後にチャットします。推論はモデルに従います。画像およびビデオ生成は、カタログがそれらの機能をマークした場合にのみ表示されます — 画像/ビデオモデルスロットで割り当ててください。 ### Anthropic [#anthropic] [Anthropicコンソール](https://console.anthropic.com/settings/keys)でAPIキーを作成します。 **Messages API**（`anthropic`）を固定します。デフォルトのベース：`https://api.anthropic.com/v1`。 インポート後にチャットします。推論はモデルに従います。Spirit側の画像またはビデオ生成スロットは、後のカタログエントリがそれをマークしない限りありません。 ### Google [#google] [Google AI Studio](https://aistudio.google.com/apikey)でAPIキーを作成します。 **Chat Completions API**（`openai-compatible`）を固定します。ResponsesまたはMessagesを要求すると、Chat Completionsにフォールバックします。デフォルトのベース：`https://generativelanguage.googleapis.com/v1beta`。 インポート後にチャットします。画像生成は、カタログがそれをマークした場合にのみ割り当てられます。Vertex AI（GCPプロジェクト/ロケーション）の場合は、[Google Vertex AI](#google-vertex-ai)を使用してください。 ### SpaceXAI [#spacexai] [SpaceXAIコンソール](https://console.x.ai/team/default/api-keys)でAPIキーを作成します。 **Chat Completions API**（`openai-compatible`）を固定します。デフォルトのベース：`https://api.x.ai/v1`。 インポート後のチャット。推論、画像、ビデオはインポートされたカタログに従います。表示されたらスロットを割り当てます。 ### Vercel AI Gateway [#vercel-ai-gateway] [Vercel AI Gateway](https://vercel.com/docs/ai-gateway) ダッシュボードでキーを作成します。 固定 **Open Responses API** (`open-responses`)。デフォルトのベース: `https://ai-gateway.vercel.sh/v1`。 チャットとゲートウェイのカタログが公開するものすべて。画像生成はタグではなく、カタログの `type=image` から取得されます。 タグからビジョンや画像生成を推測しないでください。このゲートウェイを介した MiniMax M3 は、Open Responses で表示可能な思考ストリームを返しません。 ### Cloudflare AI Gateway [#cloudflare-ai-gateway] [Cloudflare ダッシュボード](https://developers.cloudflare.com/ai-gateway/) で API トークンを作成します。アカウント ID も必要です。 ピッカー: **Chat Completions**、**Open Responses**、または **Messages**。ベースはアカウントから構築されます: `https://api.cloudflare.com/client/v4/accounts/{accountId}/ai/v1`。 * **アカウント ID** (必須) — 32文字の16進数 * **ゲートウェイ ID** (オプション) アカウント ID がないとウィザードは API ベースを構築できません。チャットやその他の機能は、ゲートウェイが公開するモデルに従います。 ### DeepSeek [#deepseek] [DeepSeek プラットフォーム](https://platform.deepseek.com/api-keys) で API キーを作成します。 ピッカーなし。接続デフォルトは **Open Responses** (`open-responses`)。互換ベースは `https://api.deepseek.com/v1` (Chat) と `https://api.deepseek.com/anthropic` (Messages) にも存在します。 インポート後のチャット。推論はモデルに従います。 ### OpenRouter [#openrouter] [OpenRouter](https://openrouter.ai/keys) でキーを作成します。 ピッカー: **Chat Completions**、**Open Responses**、または **Messages**。デフォルトのベース: `https://openrouter.ai/api/v1`。 チャットに加えて、OpenRouter がそのモデルを公開している場合、カタログでマークされた画像またはビデオ生成。 ### Fireworks AI [#fireworks-ai] [Fireworks コンソール](https://app.fireworks.ai/settings/users/api-keys) で API キーを作成します。 ピッカー: **Chat Completions**、**Messages**、または **Open Responses**。Chat / Responses ベース: `https://api.fireworks.ai/inference/v1`。Messages ベース: `https://api.fireworks.ai/inference`。 インポート後のチャット。その他の機能は Fireworks カタログに従います。 ### Together AI [#together-ai] [Together AI コンソール](https://api.together.ai/settings/api-keys) で API キーを作成します。 固定 **Chat Completions API**。デフォルトのベース: `https://api.together.ai/v1`。 インポート後のチャット。カタログがマークしている場合のみ、画像またはビデオのスロットを割り当てます。 ### Groq [#groq] [Groq コンソール](https://console.groq.com) で API キーを作成します。 固定 **Chat Completions API**。デフォルトのベース: `https://api.groq.com/openai/v1`。 インポート後のチャット。推論は、Groq が公開する場合にモデルに従います。 ### DeepInfra [#deepinfra] [DeepInfra ダッシュボード](https://deepinfra.com/dash/keys) で API キーを作成します。 固定 **Chat Completions API**。デフォルトのベース: `https://api.deepinfra.com/v1/openai`。 インポート後のチャット。その他の機能はカタログに従います。 ### Baseten [#baseten] [Baseten コンソール](https://app.baseten.co/settings/api_keys) で API キーを作成します。 固定 **Chat Completions API**。デフォルトのベース: `https://inference.baseten.co/v1`。 インポート後のチャット。その他の機能はカタログに従います。 ### Hugging Face [#hugging-face] [Hugging Face 設定](https://huggingface.co/settings/tokens) でトークンを作成します。 **Open Responses API** に固定。デフォルトのベース: `https://router.huggingface.co/v1`。 インポート後にチャット可能。その他の機能はルーターカタログに従います。 ### Moonshot AI [#moonshot-ai] 使用するサイトの Moonshot コンソールで API キーを作成します: [中国](https://platform.kimi.com/console/api-keys) または [国際](https://platform.kimi.ai/console/api-keys)。 **Chat Completions API** に固定。トランスポートピッカーなし。 * **国際** (デフォルト) — `https://api.moonshot.ai/v1` * **中国** — `https://api.moonshot.cn/v1` これは Moonshot Open Platform プロバイダーであり、[Kimi Code](#kimi-code) ではありません。moonshot-ai の組み込み検索は Kimi Code のホスト検索パスを使用しません。Kimi Code キーと Moonshot Open Platform キーは別の接続です。 ### Kimi Code [#kimi-code] [Kimi Code コンソール](https://www.kimi.com/code/console) で Kimi Code API キーを作成します。 **Chat Completions API** に固定。デフォルトのベース: `https://api.kimi.com/coding/v1`。Messages ベースは `https://api.kimi.com/coding` にありますが、ウィザードにはピッカーはありません。 インポート後にチャット可能。ホスト検索は、利用可能な場合、このプロバイダー固有です — moonshot-ai ではありません。 ### Z.ai [#zai] [Z.ai コンソール](https://z.ai/manage-apikey/apikey-list) で API キーを作成します。コーディングプランの注意: [GLM Coding Plan](https://docs.z.ai/devpack/quick-start)。 **Chat Completions API** に固定。デフォルトのベース: `https://api.z.ai/api/paas/v4`。 デフォルトの PaaS ベースの代わりに `https://api.z.ai/api/coding/paas/v4` を使用するには、ウィザードで **GLM Coding Plan** をオンにします。 インポート後にチャット可能。推論はモデルに従います。 ### Zhipu AI [#zhipu-ai] [Zhipu AI コンソール](https://bigmodel.cn/console) で API キーを作成します。コーディングプランの注意: [GLM Coding Plan](https://docs.bigmodel.cn/cn/coding-plan/quick-start)。 **Chat Completions API** に固定。デフォルトのベース: `https://open.bigmodel.cn/api/paas/v4`。 **GLM Coding Plan** をオンにして、`https://open.bigmodel.cn/api/coding/paas/v4` を使用します。 インポート後にチャット可能。推論はモデルに従います。 ### Alibaba [#alibaba] [Alibaba Cloud Model Studio / Bailian](https://bailian.console.aliyun.com) で API キーを作成します。 **Chat Completions API** に固定。互換デフォルト: `https://dashscope.aliyuncs.com/compatible-mode/v1`。 * **cn-beijing** (デフォルト) — `https://{workspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` (ワークスペース ID 必須) * **ap-southeast-1** — ワークスペース ID 必須 * **us-virginia** — `https://dashscope-us.aliyuncs.com/compatible-mode/v1` (ワークスペース ID なし) * **eu-central-1** — ワークスペース ID 必須 **Token Plan** は `https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` に切り替え、サイト / ワークスペースを無視します。注意: [Token Plan](https://bailian.console.aliyun.com/cn-beijing?tab=doc#/doc/?type=model\&url=3029020)。Token Plan は、別のサイトを選択しても常に cn-beijing プランのエンドポイントを使用します。 インポート後にチャット可能。その他の機能はカタログに従います。 ### MiniMax [#minimax] 使用するサイトの MiniMax コンソールで API キーを作成します: [中国](https://platform.minimaxi.com/console/) または [国際](https://platform.minimax.io/console/)。 **Messages API** (`anthropic`) に固定。国際 Messages ベース: `https://api.minimax.io/anthropic/v1`。 * **国際** (デフォルト) — `https://api.minimax.io/v1` (Chat 形式) / `https://api.minimax.io/anthropic/v1` (Messages) * **中国** — `https://api.minimaxi.com/v1` インポート後にチャット可能。上流の `/models` リストにはマルチモーダルフラグがなく、M3 のみが画像 / ビデオ入力をサポートするものとして扱われます。Vercel AI Gateway 経由の Open Responses では、MiniMax M3 は表示可能な思考ストリームを返しません。 ### Xiaomi [#xiaomi] [Xiaomi MiMo コンソール](https://platform.xiaomimimo.com/console/api-keys) で API キーを作成します。 固定 **Chat Completions API**。デフォルトのベース: `https://api.xiaomimimo.com/v1`。 インポート後にチャット。その他の機能はカタログに従います。 ### SiliconFlow [#siliconflow] 使用するサイトの SiliconFlow コンソールで API キーを作成します: [International](https://cloud.siliconflow.com/me/account/ak) または [China](https://cloud.siliconflow.cn/me/account/ak)。 ピッカー: **Chat Completions** または **Messages**。 * **国際** (デフォルト) — `https://api.siliconflow.com/v1` * **中国** — `https://api.siliconflow.cn/v1` インポート後にチャット。その他の機能はカタログに従います。 ### StepFun [#stepfun] [StepFun プラットフォーム](https://platform.stepfun.com) で API キーを作成します。Step Plan の注記: [Step Plan](https://platform.stepfun.com/docs/zh/step-plan/integrations/reasoning-api)。 固定 **Chat Completions API**。デフォルトのベース: `https://api.stepfun.com/v1`。 **Step Plan** は `https://api.stepfun.com/step_plan/v1` に切り替えます。 インポート後にチャット。推論はモデルに従います。 ### Volcengine [#volcengine] [Volcengine Ark コンソール](https://console.volcengine.com/ark/apiKey) で API キーを作成します。 ピッカー: **Chat Completions** または **Responses API**。デフォルトのベース: `https://ark.cn-beijing.volces.com/api/v3`。 インポート後にチャット。その他の機能はカタログに従います。 ### BytePlus [#byteplus] [BytePlus Ark コンソール](https://console.byteplus.com/ark/apiKey) で API キーを作成します。 ピッカー: **Chat Completions** または **Responses API**。デフォルトのベース: `https://ark.ap-southeast.bytepluses.com/api/v3`。 インポート後にチャット。その他の機能はカタログに従います。 ### Meituan [#meituan] [LongCat コンソール](https://longcat.chat/platform/api_keys) で API キーを作成します。 固定 **Chat Completions API**。デフォルトのベース: `https://api.longcat.chat/openai/v1`。 インポート後にチャット。その他の機能はカタログに従います。 ### Tencent TokenHub [#tencent-tokenhub] [Tencent TokenHub コンソール](https://console.cloud.tencent.com/tokenhub) で API キーを作成します。 固定 **Chat Completions API**。ウィザードは Responses や Messages を提供しません。 * **広州** (デフォルト) — `https://tokenhub.tencentmaas.com/v1` * **シンガポール** — `https://tokenhub-intl.tencentmaas.com/v1` インポート後にチャット。Chat に組み込まれた Web 検索に依存しないでください。TokenHub は Chat の `web_search_options` と Responses の `web_search` を文書化していますが、Chat の注入は実際には機能せず、Responses は一部のモデルでのみ利用可能です。したがって、Spirit は Chat Completions のみを保持します。 ### Mistral [#mistral] [Mistral コンソール](https://console.mistral.ai) で API キーを作成します。 固定 **Chat Completions API**。デフォルトのベース: `https://api.mistral.ai/v1`。 インポート後にチャット。その他の機能はカタログに従います。 ### Cohere [#cohere] [Cohere ダッシュボード](https://dashboard.cohere.com) で API キーを作成します。 固定 **Chat Completions API**。デフォルトのベース: `https://api.cohere.com/v2`。 インポート後にチャット。その他の機能はカタログに従います。 ### Azure [#azure] [Azure portal](https://portal.azure.com) で Azure OpenAI リソース用のキーを作成します。 **Responses API** (`open-responses`) に固定されます。トランスポート選択はありません。 * **リソース名** (必須) — 2〜64文字、英字、数字、ハイフンを使用可能。ハイフンで始まるまたは終わることはできません。 Spirit は `https://{resource}.openai.azure.com/openai/v1` を構築します。インポート後にチャットできます。画像生成は、マークされている場合に Azure カタログに従います。 ### Amazon Bedrock [#amazon-bedrock] [AWS Bedrock コンソール](https://console.aws.amazon.com/bedrock) で、Bedrock を呼び出せる Bearer API キーまたは IAM ユーザーを作成します。 **Amazon Bedrock** (`bedrock`) に固定されます。デフォルトのホスト形式: `https://bedrock.us-east-1.amazonaws.com`。 * **AWS リージョン** (必須)、例: `us-east-1` * **認証**: **Bearer** または **IAM** * Bearer — Bedrock API キーとモデル ID を貼り付けます。モデルは自動的に取得されません。 * IAM — Access Key ID + Secret Access Key。Spirit はアカウントから基盤モデルを一覧表示します。 モデルを選択した後にチャットできます。他の機能はそのモデルに従います。Bearer キーは推論のみで機能します。`ListFoundationModels` は Bearer を受け付けないため、カタログのインポートには IAM が必要です。 ### Google Vertex AI [#google-vertex-ai] Vertex AI が有効な GCP プロジェクトを使用します。認証は ADC、サービスアカウント、または Express API キーです。一般的な OpenAI キーではありません。 **Chat Completions API** に固定されます。Responses または Messages リクエストは Chat Completions にフォールバックします。ベースは `https://{location}-aiplatform.googleapis.com/v1/projects/{project}/locations/{location}` になります。 * **GCP プロジェクト ID** と **ロケーション** (必須)、例: `us-central1` * **認証** * **ADC** — このマシン上の Application Default Credentials (`GOOGLE_APPLICATION_CREDENTIALS`) * **サービスアカウント** — クライアントメール + 秘密鍵。モデル一覧の取得に使用されます。 * **Express API キー** — カタログを取得できません。モデル ID を手動で追加してください。 モデルを選択した後にチャットできます。GCP プロジェクトを持たない AI Studio キーの場合は、[Google](#google) を使用してください。Express モードではモデル一覧をインポートできません。サービスアカウントモードでは、モデルを一覧表示するためにメールと秘密鍵の両方が必要です。 ### カスタム [#カスタム] エンドポイントが期待する API キーを使用します。Spirit がホストするカスタムプロバイダーはありません。 選択肢: **Chat Completions**、**Open Responses**、または **Messages**。**ベース URL** を指定する必要があります。空のままにした場合のプレースホルダーのデフォルトは `https://api.openai.com/v1` です。 ベンダーが文書化しているルートを入力します。ベンダーが要求する場合はバージョンサフィックスも含めます (`/v1`、`/v1/openai` など)。Spirit はカスタムエンドポイントのパスを推測しません。 プロバイダーグループの表示名を設定して、複数のカスタムエンドポイントを区別しやすくすることもできます。 接続後、モデル ID をインポートまたは入力します。エンドポイントが Spirit が理解できるカタログを公開しない場合は、ウィザードでチャット/画像/ビデオの機能をマークします。