OpenCode Zen

Zen は OpenCode の任意の従量課金モデルサービスです。他のプロバイダーを使い続けることもできます。無料クライアントでも推論には費用が発生する場合があります。

接続とモデル選択

1. 公式コンソール (opens in a new tab)にログインし、請求設定を確認して API キーをコピーします。
2. TUI の /connect で OpenCode Zen を選択し、キーを入力します。認証情報をコミットしないでください。
3. /models でモデルを選び、機密データのない小さなリクエストとコンソールの使用記録を確認します。

モデル ID は opencode/<model-id> です。最新カタログ (opens in a new tab)の値を使い、名前から推測しないでください。既定値を固定する場合は設定の model に確認済み ID を指定します。

Zen に接続した後、このプロジェクト設定で GPT 5.5 を選択できます。必要に応じて一覧の別の利用可能な ID に変更してください。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/gpt-5.5"
}

プロトコルと直接 API

API 接頭辞は https://opencode.ai/zen/v1/ です。モデルごとに OpenAI 用 responses、Anthropic 用 messages、OpenAI 互換用 chat/completions、または Google 固有のモデル接続先を使います。以下のモデル接続先一覧に従ってください。組み込み Zen 接続が対応を処理するため、全モデルを同じ Chat Completions 接続先へ送らないでください。

Jev は https://opencode.ai/zen/v1/systemone から文章ではなく構造化された判断を返します。質問型は noul、choice、score です。現在のモデル ID と応答形式は以下の Jev の例を参照してください。

モデル一覧と接続先

以下に Zen のモデル ID、接続先、トークン料金を示します。参照表に残っていても提供終了のモデルがあるため、利用可否は最新カタログで確認してください。opencode/ はクライアント設定用の接頭辞です。API を直接呼ぶ場合は接頭辞なしの ID を使います。

Jev

シェルの OPENCODE_API_KEY に Zen キーを設定します。この例は依頼の緊急性を判断します。noul は真偽、choice は名前付き選択肢、score は評価基準に沿った採点です。この例では有料モデルへのリクエストが発生します。

curl https://opencode.ai/zen/v1/systemone \
  -H "Authorization: Bearer $OPENCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.13",
    "state": "My payments have failed for three days and I am losing sales. Please help now.",
    "questions": {
      "is_urgent": {
        "type": "noul",
        "instructions": "Does this request require urgent attention?"
      }
    }
  }'

料金と支出管理

入力・出力・キャッシュ・長いコンテキスト・決済手数料は以下のトークン料金表とコンソールで確認します。無料提供は終了する場合があり、データ条件も異なります。廃止モデルは最新カタログで確認してください。セッション名の生成が小型モデルの使用として記録される場合もあります。

自動チャージは残高が閾値を下回ると決済を行います。金額変更や無効化が可能です。無人で実行する前に実際の設定を確認してください。

月間使用上限はワークスペースやメンバーの消費額を制限し、決済総額の上限ではありません。自動チャージにより使用上限を超える請求があり得ます。残高、チャージ、使用上限を合わせて確認してください。

トークン料金

料金は米ドル／100万トークンです。入力、出力、キャッシュの読み取りと書き込みは別々に課金されます。コンテキスト量による区分がある場合は該当する行を使います。横線は無料を意味しません。DeepSeek V4 Flash Vision Exp などでは画像も課金対象のトークンになります。

無料モデル

以下のモデルには無料提供があります。利用条件やデータの扱いはモデルごとに異なり、無制限・永久無料の保証ではありません。Jev は構造化された判断を返すため、文章を生成するコーディングモデルの代わりにはなりません。

• Big Pickle
• MiMo-V2.5 Free
• Ling 3.0 Flash Fin Free
• Nemotron 3 Ultra Free
• Nemotron 3.5 Lightning Free
• Muse Spark 1.3 Contributor Free
• Jev 1.13 Free

費用の計算例

MiniMax M3 でキャッシュなしの入力10万トークンと出力2万トークンを使うと、0.1 × $0.30 + 0.02 × $1.20 = $0.054 です。その他の料金は含みません。再試行やコンテキストの再送で使用量が増えます。決済処理手数料は1回あたり 4.4% + $0.30 とされているため、コンソールで請求を確認してください。

自動リロード

残高が $5 を下回ると、Zen は自動的に $20 をリロードします。

自動リロード額は変更できます。また、自動リロード自体を完全に無効化することもできます。

月次上限

ワークスペース全体とチームの各メンバーに対して、月ごとの利用上限を設定することもできます。

たとえば、月次利用上限を $20 に設定した場合、Zen は 1 か月で $20 を超えて使われることはありません。ただし、自動リロードが有効になっていると、残高が $5 を下回った時点で Zen が $20 を自動チャージするため、結果として $20 を超えて請求される可能性があります。

提供終了モデル

プライバシー

選択するモデルの最新説明 (opens in a new tab)を確認してください。上流には米国でのホスティングと例外を伴う保持方針が記載されており、全モデルのゼロ保持を保証するものではありません。

確認資料の例外には OpenAI・Anthropic API の保持、一部無料モデルの改善目的利用、NVIDIA 無料接続先の試用ログ、Muse Spark Contributor の学習利用があります。NVIDIA の試用では個人情報や機密情報を送らないよう求めています。モデル別条件や期限付き契約を確認してください。

チームと独自キー

Admin はモデル、メンバー、キー、請求を管理し、Member は自分のキーのみを管理します。管理者はメンバーの支出上限やモデル無効化を設定できます。無効なモデルへのリクエストはエラーになります。一時的な無料ワークスペースを永久無料と解釈しないでください。

OpenAI または Anthropic の独自キーを使う場合、そのトークンは Zen ではなく提供元から請求されます。使用量を比較する前に請求先を確認してください。

ロール

チームメイトをワークスペースに招待し、ロールを割り当てられます。

• Admin : モデル、メンバー、API キー、請求を管理できます
• Member : 自分自身の API キーのみ管理できます

Admin は、コストを抑えるために各メンバーの月次支出上限を設定することもできます。

モデルアクセス

Admin は、ワークスペースで特定のモデルを有効化または無効化できます。無効化されたモデルへのリクエストはエラーになります。

これは、データを収集するモデルの利用を無効にしたい場合に便利です。

独自キーの利用

Zen のほかのモデルにアクセスしながら、自分の OpenAI または Anthropic API キーを使うこともできます。

自分のキーを使う場合、トークン料金は Zen ではなくプロバイダーから直接請求されます。

たとえば、あなたの組織がすでに OpenAI や Anthropic のキーを持っていて、Zen が提供するものではなくそちらを使いたい場合があります。

問題解決

401/403 はキー・ワークスペース・モデル権限、モデル欠落は ID と廃止状況、上限エラーは残高と支出設定を確認します。ネットワークとトラブルシューティングも参照してください。

関連ガイド

• プロバイダー設定
• モデル選択
• ネットワーク設定
• トラブルシューティング

文書の出典（MIT）