LLM プロバイダー

Minara が対応する 7 つのモデルプロバイダーと、Minara カタログ上の Auto。API キーと OAuth の経路、課金リスク、選び方を解説します。

Minara が推論するには LLM プロバイダーが 1 つ必要です。プロバイダーは 7 系統あります。多くは 2 つのサインイン方法（API キー（トークン従量課金）か、OAuth（すでに支払っているサブスクリプションを再利用））を提供します。一部は単一経路で、Kimi と Ollama Cloud は API キーのみ、Minara は組み込みのプラットフォームアカウントで、OAuth のみです。本ページではトレードオフ、課金リスク、選び方を説明します。実際のログインコマンドはインストールを、変数名は環境変数を参照してください。

一覧

プロバイダー	API キー経路	OAuth 経路	OAuth の実行基盤	OAuth で使えるモデル	課金
Minara	：（なし）	`minara-oauth`	あなたの Minara アカウント	Auto と、Minara ゲートウェイが提供するモデル	Minara アカウント経由で課金。
Anthropic	`anthropic-api-key`	`anthropic-oauth`	Claude Max と追加利用クレジット	Claude モデル	API キー：トークン従量。OAuth：購入した追加利用クレジットを消費。
OpenAI	`openai-api-key`	`openai-oauth`（Codex）	ChatGPT サブスク、Codex バックエンド経由	Codex 対応モデルのみ	API キー：トークン従量。OAuth：ChatGPT プランに含まれる。
OpenRouter	`openrouter-api-key`	`openrouter-pkce`	OpenRouter アカウント残高	各社 300+ モデル	どちらも OpenRouter 残高から課金。
Kimi	`kimi-api-key`	（なし）	（なし）	（なし）	Kimi API アカウントでトークン従量課金。
xAI（Grok）	`xai-api-key`	`xai-oauth`	SuperGrok または X Premium+ サブスク	Grok モデル	API キー：トークン従量。OAuth：X サブスクに含まれる。
Ollama Cloud	`ollama`	：（なし）	—	：	無料枠（上限あり）と有料 Turbo。Minara が計測するトークン課金はありません。

経路の選び方：API キー vs OAuth

API キー は使用量メーターです。使った分だけ支払い、プロバイダーの全モデルが使えます。この経路は誰でも使えます。

OAuth はすでに購入済みのサブスクリプションを再利用します。トークン従量の別請求は発生しません。その代わり一部のモデルしか使えず、プランの上限があります。各プロバイダーの OAuth 経路には固有の落とし穴があり、以下で説明します。

モデルと推論レベルを選ぶ

Chat の入力欄にあるモデルコントロールで、モデルと推論レベルを選択します。モデルと推論の選択肢は同じ形式のサブメニューで開き、表示位置と操作方法も統一されています。

選択内容は現在の Chat セッションに適用されます。Minara は次のメッセージからその設定を使い、同じ Chat の後続ターンでも維持します。生成中の応答を置き換えたり、デプロイ全体の既定モデルを変更したりすることはありません。

Minara プロバイダーでは Auto から始めてください。各メッセージを評価し、そのターンに合うカタログモデルを選びます。戦略は次の節で説明します。入力欄で特定のモデルを固定することもできます。現在のセッションで選んだモデルが、その Chat の後続メッセージで優先されます。

Minara

Minara は組み込みのプラットフォームアカウントです。minara-oauth でサインインします。利用分は Minara アカウント経由で課金されます。カタログは、Minara ゲートウェイが現在提供しているモデルです。

Auto

Auto は Minara で推奨するモデルです。Chat の入力欄で一度選ぶだけです。Minara は次のメッセージを評価し、そのターンに合うカタログモデルへルーティングします。

相場確認は速くて安いモデルのままです。市場メモ、自動化、実注文の経路、コード変更では Auto が一段上に切り替えます。軽い作業は俊敏に、資金を動かす仕事や実装は精度を保ちます。

これが Minara の本業です。金融分析、スケジュールと Agent のワークフロー、取引執行、プログラミング。Auto をオンのままにすれば、1 つの Chat で全部をこなせます。ルーターは、そのターンがそれに値するときだけ追加で使います。

Auto を選んだあと、設定（プロバイダーとモデル）に 3 つの戦略が出ます。保存済みのユーザー設定は MINARA_AUTO_MODEL_STRATEGY より優先されます。バックグラウンドのタイトル生成と圧縮モデルは「バックグラウンド作業モデル」ページのままです。Auto の対象外です。

戦略	使う場面	既定の割り当て
balanced（既定）	軽いターンは速く、スコアが上がったときだけ使う量を増やしたい。	SIMPLE/MEDIUM は DeepSeek V4 Flash（ビジョンまたは PDF が必要なら Claude Sonnet 5）。COMPLEX は GPT-5.6 Terra。REASONING は GPT-5.6 Sol。
economy	クレジットを長く使いたい。	軽いターンは同じ Flash。COMPLEX は GLM 5.2。REASONING は Kimi K3。
quality	どの難易度でもカタログ上で最も強いモデルを使いたい。	軽いターンは Claude Sonnet 5。COMPLEX は GPT-5.6 Terra。REASONING は Claude Opus 5。

セッションの後半を 1 つのカタログモデルに固定したいときは、そのモデルをピン留めしてください。次の Chat では Auto がピッカーに残ります。

Anthropic（Claude）

Anthropic は Claude を提供します。

anthropic-api-key はリクエストを api.anthropic.com に送ります。console.anthropic.com でキーを取得し、トークン従量で支払います。すべての Claude モデルが使えます。

anthropic-oauth は Claude Max サブスクを再利用します。Minara は Claude Code ツールと同じ方法でサインインするため、Anthropic はあなたのリクエストを Claude Code の利用として扱います。

Anthropic OAuth には Claude Max と追加利用クレジットが必要です

minara auth login anthropic は Claude Code と同じ方法でサインインします。Anthropic はそれらのリクエストを Claude Code の利用として課金します。この経路は Claude Max プランでのみ動作します。Max の上に購入した「追加利用」クレジットを消費します。基本の Max 枠には一切手をつけません。追加クレジットがないと、有効な Max プランでもリクエストは失敗します。Claude Pro はこの経路を使えません。Pro の場合、またはトークン従量で支払いたい場合は、代わりに ANTHROPIC_API_KEY を設定してください。

OpenAI

OpenAI には 2 つのサインイン方法があり、両者は大きく異なります。

openai-api-key はリクエストを api.openai.com に送ります。platform.openai.com でキーを取得し、トークン従量で支払います。gpt-5.5-pro、gpt-4.1、o3 を含む OpenAI の全ラインアップが使えます。

openai-oauth は Codex OAuth です。Minara は OpenAI Codex CLI のデバイスフローでサインインし、Codex CLI として振る舞います。リクエストは api.openai.com ではなく OpenAI のファーストパーティ Codex バックエンド chatgpt.com/backend-api/codex に送られ、あなたの ChatGPT サブスク上で動作します。

OpenAI OAuth は Codex OAuth であり、OpenAI プラットフォーム API ではありません

minara auth login openai は OpenAI Codex CLI としてサインインします。リクエストは OpenAI の Codex バックエンド経由で、あなたの ChatGPT サブスク上で動作します。この経路は Codex 対応モデルのみをサポートします。gpt-5.5-pro、gpt-4.1、o3 のようなモデルはここでは使えません。OpenAI の全ラインアップを使うには、代わりに OpenAI API キーでサインインしてください。

ChatGPT Codex バックエンドは回転する許可リストを提供します。Settings の live catalog が正です。現行世代のモデルは次のとおりです。

gpt-5.6-terra（デフォルト）
gpt-5.6-sol
gpt-5.6-luna

gpt-5.3-codex など古い *-codex スラッグは、バックエンドが廃止すると HTTP 400 を返します。

設定画面のモデルピッカーは、常に OpenAI の全ラインアップを表示します。接続済みのアカウントで動かせないモデルはグレーアウトされ、短い理由が添えられます。ChatGPT サインインでは、OpenAI API キーを接続するまで非 Codex モデルはグレーのままです。ChatGPT サインインと API キーの両方を接続している場合は、どのモデルでも選べます。もう一方のアカウントが必要なモデルを選ぶと、アクティブな接続が自動的に切り替わります。

OpenRouter

OpenRouter は、多数のベンダー（Anthropic、OpenAI、Google、Meta など）の 300+ モデルへの単一の入り口です。どちらのサインイン経路も同じ OpenRouter クレジット残高から課金されます。

openrouter-api-key は openrouter.ai のキーを使います。openrouter-pkce はブラウザでサインインし、キーをコピーする必要はありません。いずれの場合も Minara は帰属ヘッダーを付与し、OpenRouter ダッシュボード上で利用が Minara に紐づくようにします。

OpenRouter は常にあなたの OpenRouter 残高から引き落とします

ここにサブスクリプション経路はありません。API キーもブラウザサインインも、OpenRouter アカウントに入金したクレジットを消費します。長いセッションの前に残高を補充してください。残高がゼロになるとリクエストは停止し、補充するまで再開しません。

Kimi

Kimi は公式 Kimi API プラットフォームへ直接接続する API キー専用プロバイダーです。platform.kimi.ai でキーを作成し、minara auth login kimi --api-key <key> を実行するか、KIMI_API_KEY を設定します。

kimi-api-key は OpenAI 互換の Chat Completions を https://api.moonshot.ai/v1 へ送信します。モデル一覧は公式 /v1/models から取得し、コールドスタート時の既定値は kimi-k2.6 です。ストリーミング、ツール呼び出し、構造化出力、K2.6 の reasoning-content 再送をサポートします。1 つのツールを強制するターンでは、thinking 有効時の Kimi API が自動または無効のツール選択しか受け付けないため、その呼び出しだけ K2.6 thinking を無効にします。

xAI（Grok）

xAI は Grok を提供します。

xai-api-key は xAI コンソールのキーを使い、api.x.ai でトークン従量課金します。xai-oauth はブラウザでサインインし、SuperGrok または X Premium+ サブスクを再利用します。

xAI OAuth には SuperGrok または X Premium+ サブスクが必要です

この経路はそれらのプランに付属する Grok アクセスを再利用します。無料の X アカウントでは動作しません。これらのサブスクがない場合は、xAI API キーを使ってください。

Ollama Cloud

Ollama Cloud は Ollama のホスト型サーバーでオープンモデル（gpt-oss、DeepSeek、Qwen3-Coder、Kimi K2 など）を実行するため、ローカル GPU は不要です。サインイン方法は API キーの 1 つだけです。

ollama は OpenAI 互換エンドポイント経由で https://ollama.com にリクエストを送ります。ollama.com/settings/keys でキーを作成し、minara auth login ollama --api-key <key> を実行（または OLLAMA_API_KEY を設定）します。自己ホストやローカルの Ollama を指す場合は OLLAMA_BASE_URL（例：http://localhost:11434）を設定するか --base-url を渡します。

Ollama Cloud には無料枠の上限と有料 Turbo プランがあります

無料枠は実行量に上限があります。ヘビーユースには有料の Turbo プランが必要です。上限に達すると、ウィンドウがリセットされるかアップグレードするまでリクエストは失敗します。Minara が計測するトークン課金はないため、このプロバイダーのコストパネルはゼロを表示します。

ツール呼び出し、ビジョン、JSON 出力は選んだクラウドモデルに依存します。大きめの指示調整モデル（例：gpt-oss:120b）はツールをうまく扱えますが、小さいモデルは扱えないことがあります。

どれを選ぶべき？

あなたの状況	これを選ぶ	理由
Minara でサインイン済みで、仕事に合わせて強くなる 1 つのモデルが欲しい	Minara プロバイダーの Auto	メッセージごとにルーティング。軽いターンは速く、分析・自動化・取引・コードでは一段強く。
Claude Max を契約し、追加利用クレジットも購入済み	Anthropic OAuth（`anthropic-oauth`）	すでに持つクレジットを再利用、新たな請求なし。
Claude を使いたいが Pro のみ、または未契約	Anthropic API キー（`anthropic-api-key`）	Pro は OAuth 経路を使えません。トークン従量に。
ChatGPT を契約し、コーディング向けモデルだけで足りる	OpenAI OAuth（`openai-oauth`）	ChatGPT プラン上で動作、追加請求なし。Codex モデルのみ。
`gpt-5.5-pro`、`gpt-4.1`、`o3`、または全ラインアップが必要	OpenAI API キー（`openai-api-key`）	OAuth では届きません。API キーなら可能。
各社の多様なモデルを試したい	OpenRouter	1 アカウントで 300+ モデル。
Kimi API アカウントがあり、Kimi モデルへ直接接続したい	Kimi（`kimi-api-key`）	公式エンドポイントとライブモデル一覧を使い、アグリゲーターを経由しません。
Grok を使いたく、SuperGrok か Premium+ を契約済み	xAI OAuth（`xai-oauth`）	サブスクを再利用。
ローカル GPU なしで 1 つのホスト型キーでオープンウェイトモデルを使いたい	Ollama Cloud（`ollama`）	キー 1 つ、トークン課金なし、gpt-oss / DeepSeek / Qwen を実行。
迷っていて、最も簡単に始めたい	任意の API キー	誰でも使え、全モデル利用可、使った分だけ支払い。

トラブルシューティング

エラー：out_of_credits または残高不足

プロバイダーの残高が尽きました。OpenRouter は openrouter.ai で補充してください。Anthropic OAuth は Claude Max プランで追加利用クレジットを購入してください。API キー経路はプロバイダーのコンソールで入金するか、上限を引き上げてください。

OpenAI OAuth でモデルが 404 または model not found を返す

Codex バックエンドが提供しないモデルを要求しました。live Codex リストから gpt-5.6-terra などを選ぶか、OpenAI API キーでサインインして全ラインアップに届くようにしてください。

サインインが拒否される、またはセッションが期限切れ

保存された認証情報が無効か期限切れです。対応する minara auth login <provider> コマンドを再実行して更新してください。Anthropic OAuth は Pro ではなく Claude Max であることを確認してください。OpenAI OAuth は ChatGPT サブスクが有効であることを確認してください。

一覧