1. APIキーを作成する
IteraCompute アカウントを作成するかサインインし、コンソールでキーを作成します。
3 つのステップで接続する
2. ベース URL を構成する
@ai-sdk/openai-compatibility を使用して IteraCompute カスタム プロバイダーを追加します。
3. モデルを選択します
選択したモデルの正確な API モデル ID を使用してください。エージェントまたはビジョン機能を有効にする前に、そのコンテキストと機能を確認してください。
モデルを選択してください
構成例
API キーをサーバー環境またはツール認証情報ストアに保管します。該当する場合は、サンプルのキー フィールドを独自のキーに置き換えます。
オープンコード.json
{
"$schema": "https://opencode.ai/config.json",
"model": "iteracompute/qwen/qwen3.8-27b",
"provider": {
"iteracompute": {
"npm": "@ai-sdk/openai-compatible",
"name": "IteraCompute",
"options": {
"baseURL": "https://api.iteracompute.com/v1",
"apiKey": "{env:ITERACOMPUTE_API_KEY}"
},
"models": {
"qwen/qwen3.8-27b": {
"name": "Qwen3.8-27B"
}
}
}
}
}バージョンと検証
実際のワークフローは 2026 年 10 月 14 日で検証済み · OpenCode 1.19.0 · Node.js 25.2.1 · Windows · 無料の Qwen のみ。ファイルの読み取り、slugify.mjs の修復、テストの実行、個別の再実行: 4 回成功、0 回失敗。保持された 5 ステップの実行では、30,911 個のトークンと 25.256 秒のエージェント イベント ウィンドウが報告されます。
正確なプロンプト、検証済みの構成、コードの差分、テスト、および完全な操作ログ →
達成基準
OpenCodeで短いプロンプトを送信し、空でない回答を確認してください。コーディングテストの場合は、ファイルの差分を調べ、プロジェクトテストコマンドを実行してください。
インストールされているバージョンを記録する
opencode --version以下の API チェックの後、構成されたツール自体をテストします。HTTP 200 または cURL の結果だけでは、そのツールは検証されません。
接続をテストする
cURL · チャットの完了
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
-H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'choices[0].message.content に表示されるテキストが含まれていることを確認します。HTTP 200 だけでは不十分です。推論により出力バジェットが消費される可能性があります。無料のQwenを使用するには、 初めての無料API呼び出しの例 思考を無効にするには、ツール内でプロンプトを送信します。
選択済みモデルの機能
これらは、選択したモデルの API 機能です。ワークフローで利用できる機能は、ツールとその設定によっても異なります。推論コントロールはモデルによって異なります。
- チャットの完了サポートされています
- ツール呼び出しサポートされています
- 推論サポートされています
- 画像入力サポートされています
- ストリーミングサポートされています
トラブルシューティング
プロバイダーまたはモデルが見つかりません
プロジェクトから opencode.json を読み込みます。選択された名前は iteracompute/qwen/qwen3.8-27b です。モデル キーは、iteracompute プロバイダー内の qwen/qwen3.8-27b です。
資格情報がありません
OpenCodeを起動するプロセスでITERACOMPUTE_API_KEYを設定してください。{env:ITERACOMPUTE_API_KEY}フィールドはこの環境変数を読み取ります。変更後はターミナルを再度開いてください。
エンドポイントまたはモデルの設定
@ai-sdk/openai-compatibility を使用し、baseURL に /v1 を保持します。大規模なプロジェクトをアタッチする前に、アカウント層のコンテキストと出力の制限を構成します。
429 / リクエスト制限
アカウント全体の月間使用量と TPM を確認します。Retry-After を尊重し、並列再試行を避けます。Free Qwen には、自動的に支払われる超過料金はありません。他のモデルには公開価格が適用されます。
401 / 403: キーとモデルの権限を確認します。無料の Qwen には残高やカードは必要ありません。有料モデルの場合は、利用可能残高も確認してください。
