CLI の料金と承認
このページは、リリース済みの CLI 0.14.1 を対象としています。CLI はプラットフォームの API を直接呼び出し、コマンドと保存済みの見積もりをローカルで管理します。ログインには Passport を使います。まずはワークフロー全体から始めてください。- 最終的なモデルと入力で
evolink estimateを実行し、見積もり額を示します。 - このモデル、パラメータ、料金が承認されたら、保存された
quote_idと--confirmを使って生成します。 - 入力またはログインが変わった場合、価格が上がった場合、見積書の有効期限が切れた場合は、見積もりをやり直して承認を得ます。別の見積書を使い回さないでください。ユーザーが、見積もりや確認は不要だと明確に述べた場合は、ステップ 1–2 の代わりに
generate --skip-estimateを使います。 - 元のタスクとアカウントの使用量を照会します。見積もりは、実際の課金や返金を裏付けるものではありません。
price_changed）、入力が変わった場合（quote_input_changed）、見積書の有効期限が切れた場合（quote_expired）は、何も送信されず、新しい見積もりと承認が必要です。見積書は、支払いの領収書ではありません。--confirm は、このタスクに対する承認を表すもので、ログインやホストでの実行権限の代わりにはなりません。モデル、残高、タスクの照会では、生成は送信されません。生成は課金されます。ファイルサービスのサイズ制限と保持期間の制限は、別途適用されます。換算の目安は $1 あたり約 68 クレジットです。実際に返された値とアカウントの記録を使ってください。
共通のアクセスルールを参照してください。このページには、このルートでのログインとログアウトの操作を記載しています。
ログイン、権限、クォータ
ブラウザでのログインは Passport が処理し、CLI の認証情報はシステムの安全なストアに保存されます。業務リクエストには、OAuth に紐付いた既存のキーが使われます。CLI とリモート MCP は、アカウントへのアクセス、キーのクォータ、権限を共有できます。共有されているキーを一時停止したり変更したりすると、それを使うすべての利用元に影響します。OAuth セッションは、それぞれ個別にログアウトします。保存と有効期限
見積書、参照素材、アップロード許可、オリジナルの URL のデフォルトの有効期間は、タスク、参照素材、結果にまとめています。実際に返された値が優先されます。レシートに対応しているかどうかは、ファイルサービスのデプロイ環境によって異なります。CLI のトラブルシューティング：失敗した段階を特定する
CLI を実行するのと同じマシン、OS ユーザー、ターミナルで、バージョンとアクセスを確認します。これらの照会では、生成は送信されません：
先に進む前に、現在の段階の問題を解決してください。接続の検証に有料生成は必要ありません。インストールを試すために、生成を繰り返さないでください。
環境とインストール：コマンドが見つからない、権限、タイムアウト
ステップ 1：実際の実行環境を確認します。エージェントが使うターミナルで、次を実行します：command not found と表示される場合や、Windows でコマンドが認識されない場合は、Node.js をインストールして、ターミナルを開き直してください。デスクトップにインストールしても、SSH、WSL、コンテナの中に CLI がインストールされるわけではありません。
ステップ 2：npm のインストール先を確認します。
お使いのシステムに合った、パス確認用のコマンドを選んでください：
- macOS / Linux
- Windows PowerShell
evolink --version を実行します。このコマンドが動作する場合にだけ、ログインに進んでください。インストール手順の全体を参照してください。
ログインとコールバック：ブラウザが開かない、ログインが完了しない
evolink auth loginまたはsetupは実行したままにします。ブラウザが開かない場合は、今回の試行のリンクを手動で開き、アカウントを確認して、承認します。- 元のターミナルに戻り、完了を待ちます。承認後、ブラウザは「承認を受け取りました」という通知のある EvoLink MCP のページに移動します。これは、コールバックが届いたことを意味するだけで、アカウントへの接続が検証されたことを意味するわけではありません。コマンドを途中で終了しないでください。
- 保存されている認証と、実際のアカウントへのアクセスを、別々に確認します：
authenticated: true と、実際の残高データが返ることを確認します。タイムアウトした場合は、認可コードを使い回さず、新しいリンクで新しい試行を開始してください。待ち時間を長くするには、次のようにします：
--no-browser でも、ブラウザのコールバックは必要です。これは、デバイスコードによる認証でも、ブラウザを使わない認証でもありません。API Key を、リモートの OAuth トークンとして入力しないでください。
スキルと権限：インストールしたファイルをエージェントが使わない
- エージェントを実行するユーザーのディレクトリを確認します。対応する
--agentを使ってください。Codex の場合：
current: trueは、インストールされているファイルが CLI と一致していることを意味します。ファイルがない場合や古い場合は、evolink skills install --agent codexを使ってください。modifiedの場合は、ローカルでの編集を保持してください。conflictの場合は、skills ディレクトリ全体を削除するのではなく、競合しているスキルまたは無効なメタデータを解消してください。- エージェントに、
evolink-cliを検出して読み込めることを確認してもらいます。必要に応じて、再読み込みするか、新しい会話を開いてください。ホスト側で、必要なコマンドの実行権限を確認します。組織による制限は、ホスト側の設定で対応する必要があります。
assistant_discovery: not_checked は、ホストでの読み込みがまだ検証されていないことを意味します。SKILL.md ファイルがあることや、ドキュメントのページを読んだことは、エージェントが CLI を実行できることの証明にはなりません。
CLI を更新したら、スキルを同期してください。--replace-modified は、ローカルでの変更を置き換えると決めた場合にだけ使ってください。バックアップは ~/.evolink-media/skill-backups/ に保存されます。ディレクトリと内容は、エージェントが読めるリソースに一覧があります。
モデルと価格：検索結果が空、パラメータが無効、見積もりが不完全
- 現在提供されているモデルを検索し、返された正式な ID を使います。シリーズ名、表示名、エイリアスは、有効な送信用 ID ではない場合があります。必要な参照素材への対応という条件は外さずに、検索の言い回しを広げてください。
- このモデルについて、
models show/models schemaを確認します。必須項目、スペル、列挙値、数値の制限、同時に指定できない参照素材を確認してください。ほかのモデルのduration、size、qualityフィールドをコピーしないでください。 - 見積もりをやり直し、
input_valid、problems、estimate.status、basis、warningsを確認します。入力またはアカウントが変わった場合、価格が上がった場合、見積書の有効期限が切れた場合は、新しい見積もりと承認が必要です。
needs_input の場合は、不足している入力を補うか、missing_usage と usage_help に示された課金使用量を --media-seconds または --pricing-parameters で指定してください。no_price は利用できず、partial は合計額ではありません。長さや参照素材の倍率が不明な場合に、開始価格で埋めることはできません。予算は維持してください。拒否を回避するために、断りなく上限を外したり、キーを切り替えたり、仕様を下げたりしないでください。
検索、models show、models recommend のどのモデルにも価格がなく、pricing_warning に Public pricing rules are unavailable or invalid と表示される場合、CLI は 0.10.1 以前のバージョンです。これらのバージョンでは、モデル一覧に multiplier のない段階制ルールが含まれていると、すべての価格が表示されなくなります。このようなルールは、10月12日から公開されています。npm install -g @evolinkai/cli@latest で 0.10.2 以降にアップグレードしてから、evolink skills install を実行してください。0.10.2 以降では、ルールを読み取れないモデルは除外されて pricing_warning に示され、ほかのモデルの価格はそのまま表示されます。
リリース済みバージョンの、公開デフォルト価格に基づく見積もりは、アカウント固有の正式な見積書（Quote）ではなく、max_cost_usd も最終的な精算額の上限ではありません。料金とコマンドリファレンスを参照してください。
生成のタイムアウト、実行中のタスク、結果不明の送信
1
ID がある場合は元のタスクを照会する
status_check: unverified（task_response_invalid、task_identity_mismatch、task_status_unknown のいずれか）を返した場合は、最新の状態を検証できなかったことを意味します。生成するのではなく、同じタスクをもう一度照会してください。submission_state: accepted の generate の結果には、状態がない場合でも、すでにタスク ID があります。2
タスク ID が返されなかった場合は元の見積書から復旧する
3
失敗に対処する前に証拠を残す
元のタスク ID、エラーコード、時刻を記録してください。失敗が確定したタスクは課金されず、送信時に仮押さえされたクレジットは自動的に返還されます。利用できる公開のキャンセルコマンドはありません。ターミナルを閉じたり待機を止めたりしても、サーバー側のタスクはキャンセルされません。
アップロードの失敗、サイズ超過、結果不明
- エージェントを実行するマシン上で、絶対パス、権限、実際の形式を確認します。リモートホストやコンテナは、デスクトップ上のパスを直接読み取れません。
- ローカルの CLI からのアップロードは、95 MiB までです。モデルによっては、形式、数、サイズについて、より厳しい制限がある場合があります。先にモデルのドキュメントを確認してください。チャットの添付ファイルは、読み取り可能なファイルか、アクセス可能な URL にする必要があります。
- 結果が不明な場合は、元の
upload_idを保持し、それを照会します：
- レシートを照会できるかどうかは、ファイルサービスのデプロイ環境によって異なります。
outcome_unknownは、何もアップロードされなかったことの根拠にはなりません。代わりのアップロードを要求するのは、失敗または失効が確定してからにしてください。参照素材の有効期間は、通常72時間です。失効した入力は再アップロードし、リクエストを更新して、生成の前に見積もりと承認をやり直してください。