NNexithDocs
ステータスダッシュボード ↗
概要とクイックスタートモデルカタログガイドAPI リファレンス連携OAuth2 / OIDC

opencode で Nexith を使用する

opencode は標準の OpenAI 互換プロトコル(POST /v1/chat/completions)を使用します。これは最も汎用的なパスであり、 大多数のサードパーティツールが接続する方式でもあります。

設定#

opencode は provider 設定で OpenAI 互換バックエンドを宣言します:

{
  "provider": {
    "nexith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Nexith",
      "options": {
        "baseURL": "https://gateway.nexith.ai/v1",
        "apiKey": "nx-你的key"
      },
      "models": {
        "nexith-core": { "name": "Nexith Core" }
      }
    }
  }
}

設定キー名は opencode 自身のドキュメントに従ってください。Nexith 側で必要なのは baseURL に /v1 を付けること + apiKey に nx- key を使うことです。https://api.nexith.ai/v1 も同様に使用できます。

Nexith 側の対応状況#

機能 ステータス
POST /v1/chat/completions(ストリーミング/非ストリーミング) ✅
tools / tool_choice / parallel_tool_calls ✅ そのまま透過
tool_calls のストリーミング断片(index + function.arguments の差分) ✅ そのまま転送、並べ替えなし
finish_reason: "tool_calls" ✅ そのまま保持
assistant メッセージのリプレイ(tool_calls + tool_call_id) ✅
GET /v1/models ✅
Anthropic / Responses プロトコル claude-code.md / codex.md 参照

tools が空でない場合、ゲートウェイはアップストリームの reasoning_effort を none に正規化します(ツールがあると推論が遅くなり token 予算を食い尽くすため)。これは意図的な動作です。

課金と長時間タスク#

  • 1 リクエストの上限は 120 秒(現在)。opencode の長い agent ループで 1 ターンが 120s を超えると打ち切られます。対応中です。
  • ストリーミングレスポンスは現在 stream_options.include_usage を付けないため、アップストリームはストリーミング使用量を返しません。 課金は概算に基づき、prompt cache の割引も適用されません。これは同一プレフィックスの多い agent ループに大きな影響があり、 TODO に記載済みです。
  • 32k コンテキストを超える nexith-core リクエストは自動的に強力なアップストリームへエスカレーションされ、エスカレーション後のティアで課金されます。

トラブルシューティング#

ストリーミングレスポンスが止まる / 長時間出力がない アップストリームの長い推論中、ゲートウェイは一切バイトを送信しません(現在 SSE ハートビートはありません)。TODO に記載済みです。

ツール名またはパラメータが失われる アップストリームが非標準的に name より先に arguments を送信した場合、現在の実装では名前が空に固定されます。標準的なアップストリームではこの問題はありません。

401 key は nx- で始まる必要があります。Authorization: Bearer と x-api-key の両方のヘッダーをゲートウェイは受け付けます。