Spirit Agent
ダウンロード

プロバイダー

自分のAPIキーを持ち込み、接続ウィザードを実行し、ハウスを切り替えても同じエージェントワークフローを維持します。

Spirit AgentはBYOKです。プロバイダーのコンソールでキーを作成し、それをDesktopまたはCLIに貼り付けます。SpiritはそれをOSのキーリングに保存します。ハウスを切り替えても、ワークスペースの開き方、編集の承認方法、エージェントの実行方法は変わりません。

接続ウィザードは、DesktopではSettings → Models、CLIでは/model addまたはspirit model addです。追加フィールドは、そのプロバイダーが必要とする場合にのみ表示されます。

Spiritは4つのトランスポートのいずれかでプロバイダーと通信します。ウィザードはタイプを固定するか、選択させます。

トランスポートウィザードのラベル一般的な用途
openai-compatibleChat Completions APIほとんどのOpenAI互換エンドポイント
open-responsesResponses API / Open Responses APIOpenAI、Azure、Vercel AI Gateway、Hugging Face、およびオプションのゲートウェイパス
anthropicMessages APIAnthropic、MiniMax、およびオプションのMessages互換エンドポイント
bedrockAmazon BedrockAmazon 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プラットフォームでAPIキーを作成します。SpiritはOpenAIの使用量を販売しません。

ウィザードはResponses API（open-responses）を固定します。トランスポートのピッカーはありません。デフォルトのベース：https://api.openai.com/v1。

インポート後にチャットします。推論はモデルに従います。画像およびビデオ生成は、カタログがそれらの機能をマークした場合にのみ表示されます — 画像/ビデオモデルスロットで割り当ててください。

Anthropic

AnthropicコンソールでAPIキーを作成します。

Messages API（anthropic）を固定します。デフォルトのベース：https://api.anthropic.com/v1。

インポート後にチャットします。推論はモデルに従います。Spirit側の画像またはビデオ生成スロットは、後のカタログエントリがそれをマークしない限りありません。

Google

Google AI StudioでAPIキーを作成します。

Chat Completions API（openai-compatible）を固定します。ResponsesまたはMessagesを要求すると、Chat Completionsにフォールバックします。デフォルトのベース：https://generativelanguage.googleapis.com/v1beta。

インポート後にチャットします。画像生成は、カタログがそれをマークした場合にのみ割り当てられます。Vertex AI（GCPプロジェクト/ロケーション）の場合は、Google Vertex AIを使用してください。

SpaceXAI

SpaceXAIコンソールでAPIキーを作成します。

Chat Completions API（openai-compatible）を固定します。デフォルトのベース：https://api.x.ai/v1。

インポート後のチャット。推論、画像、ビデオはインポートされたカタログに従います。表示されたらスロットを割り当てます。

Vercel AI Gateway

Vercel AI Gateway ダッシュボードでキーを作成します。

固定 Open Responses API (open-responses)。デフォルトのベース: https://ai-gateway.vercel.sh/v1。

チャットとゲートウェイのカタログが公開するものすべて。画像生成はタグではなく、カタログの type=image から取得されます。

タグからビジョンや画像生成を推測しないでください。このゲートウェイを介した MiniMax M3 は、Open Responses で表示可能な思考ストリームを返しません。

Cloudflare AI Gateway

Cloudflare ダッシュボード で 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 プラットフォーム で API キーを作成します。

ピッカーなし。接続デフォルトは Open Responses (open-responses)。互換ベースは https://api.deepseek.com/v1 (Chat) と https://api.deepseek.com/anthropic (Messages) にも存在します。

インポート後のチャット。推論はモデルに従います。

OpenRouter

OpenRouter でキーを作成します。

ピッカー: Chat Completions、Open Responses、または Messages。デフォルトのベース: https://openrouter.ai/api/v1。

チャットに加えて、OpenRouter がそのモデルを公開している場合、カタログでマークされた画像またはビデオ生成。

Fireworks AI

Fireworks コンソール で 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 コンソール で API キーを作成します。

固定 Chat Completions API。デフォルトのベース: https://api.together.ai/v1。

インポート後のチャット。カタログがマークしている場合のみ、画像またはビデオのスロットを割り当てます。

Groq

Groq コンソール で API キーを作成します。

固定 Chat Completions API。デフォルトのベース: https://api.groq.com/openai/v1。

インポート後のチャット。推論は、Groq が公開する場合にモデルに従います。

DeepInfra

DeepInfra ダッシュボード で API キーを作成します。

固定 Chat Completions API。デフォルトのベース: https://api.deepinfra.com/v1/openai。

インポート後のチャット。その他の機能はカタログに従います。

Baseten

Baseten コンソール で API キーを作成します。

固定 Chat Completions API。デフォルトのベース: https://inference.baseten.co/v1。

インポート後のチャット。その他の機能はカタログに従います。

Hugging Face

Hugging Face 設定 でトークンを作成します。

Open Responses API に固定。デフォルトのベース: https://router.huggingface.co/v1。

インポート後にチャット可能。その他の機能はルーターカタログに従います。

Moonshot AI

使用するサイトの Moonshot コンソールで API キーを作成します: 中国 または 国際。

Chat Completions API に固定。トランスポートピッカーなし。

  • 国際 (デフォルト) — https://api.moonshot.ai/v1
  • 中国 — https://api.moonshot.cn/v1

これは Moonshot Open Platform プロバイダーであり、Kimi Code ではありません。moonshot-ai の組み込み検索は Kimi Code のホスト検索パスを使用しません。Kimi Code キーと Moonshot Open Platform キーは別の接続です。

Kimi Code

Kimi Code コンソール で Kimi Code API キーを作成します。

Chat Completions API に固定。デフォルトのベース: https://api.kimi.com/coding/v1。Messages ベースは https://api.kimi.com/coding にありますが、ウィザードにはピッカーはありません。

インポート後にチャット可能。ホスト検索は、利用可能な場合、このプロバイダー固有です — moonshot-ai ではありません。

Z.ai

Z.ai コンソール で API キーを作成します。コーディングプランの注意: GLM Coding Plan。

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 コンソール で API キーを作成します。コーディングプランの注意: GLM Coding Plan。

Chat Completions API に固定。デフォルトのベース: https://open.bigmodel.cn/api/paas/v4。

GLM Coding Plan をオンにして、https://open.bigmodel.cn/api/coding/paas/v4 を使用します。

インポート後にチャット可能。推論はモデルに従います。

Alibaba

Alibaba Cloud Model Studio / Bailian で 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。Token Plan は、別のサイトを選択しても常に cn-beijing プランのエンドポイントを使用します。

インポート後にチャット可能。その他の機能はカタログに従います。

MiniMax

使用するサイトの MiniMax コンソールで API キーを作成します: 中国 または 国際。

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 MiMo コンソール で API キーを作成します。

固定 Chat Completions API。デフォルトのベース: https://api.xiaomimimo.com/v1。

インポート後にチャット。その他の機能はカタログに従います。

SiliconFlow

使用するサイトの SiliconFlow コンソールで API キーを作成します: International または China。

ピッカー: Chat Completions または Messages。

  • 国際 (デフォルト) — https://api.siliconflow.com/v1
  • 中国 — https://api.siliconflow.cn/v1

インポート後にチャット。その他の機能はカタログに従います。

StepFun

StepFun プラットフォーム で API キーを作成します。Step Plan の注記: Step Plan。

固定 Chat Completions API。デフォルトのベース: https://api.stepfun.com/v1。

Step Plan は https://api.stepfun.com/step_plan/v1 に切り替えます。

インポート後にチャット。推論はモデルに従います。

Volcengine

Volcengine Ark コンソール で API キーを作成します。

ピッカー: Chat Completions または Responses API。デフォルトのベース: https://ark.cn-beijing.volces.com/api/v3。

インポート後にチャット。その他の機能はカタログに従います。

BytePlus

BytePlus Ark コンソール で API キーを作成します。

ピッカー: Chat Completions または Responses API。デフォルトのベース: https://ark.ap-southeast.bytepluses.com/api/v3。

インポート後にチャット。その他の機能はカタログに従います。

Meituan

LongCat コンソール で API キーを作成します。

固定 Chat Completions API。デフォルトのベース: https://api.longcat.chat/openai/v1。

インポート後にチャット。その他の機能はカタログに従います。

Tencent TokenHub

Tencent 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 コンソール で API キーを作成します。

固定 Chat Completions API。デフォルトのベース: https://api.mistral.ai/v1。

インポート後にチャット。その他の機能はカタログに従います。

Cohere

Cohere ダッシュボード で API キーを作成します。

固定 Chat Completions API。デフォルトのベース: https://api.cohere.com/v2。

インポート後にチャット。その他の機能はカタログに従います。

Azure

Azure portal で Azure OpenAI リソース用のキーを作成します。

Responses API (open-responses) に固定されます。トランスポート選択はありません。

  • リソース名 (必須) — 2〜64文字、英字、数字、ハイフンを使用可能。ハイフンで始まるまたは終わることはできません。

Spirit は https://{resource}.openai.azure.com/openai/v1 を構築します。インポート後にチャットできます。画像生成は、マークされている場合に Azure カタログに従います。

Amazon Bedrock

AWS 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

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 を使用してください。Express モードではモデル一覧をインポートできません。サービスアカウントモードでは、モデルを一覧表示するためにメールと秘密鍵の両方が必要です。

カスタム

エンドポイントが期待する API キーを使用します。Spirit がホストするカスタムプロバイダーはありません。

選択肢: Chat Completions、Open Responses、または Messages。ベース URL を指定する必要があります。空のままにした場合のプレースホルダーのデフォルトは https://api.openai.com/v1 です。

ベンダーが文書化しているルートを入力します。ベンダーが要求する場合はバージョンサフィックスも含めます (/v1、/v1/openai など)。Spirit はカスタムエンドポイントのパスを推測しません。

プロバイダーグループの表示名を設定して、複数のカスタムエンドポイントを区別しやすくすることもできます。

接続後、モデル ID をインポートまたは入力します。エンドポイントが Spirit が理解できるカタログを公開しない場合は、ウィザードでチャット/画像/ビデオの機能をマークします。

CLIをインストール

インストールスクリプト、SPIRIT_HOME、SPIRIT_VERSIONを使用してSpirit Agent CLIをインストールします。

ツール

エージェントが呼び出せるツール。一部はモデル、スロット、またはモードが条件を満たす場合にのみ表示されます。

このページ内