1. APIキーを作成する
IteraCompute アカウントを作成するかサインインし、コンソールでキーを作成します。
3 つのステップで接続する
2. ベース URL を構成する
ChatOpenAIをbase_urlで設定します。Responses API ではなく Chat Completions パスを使用します。
3. モデルを選択します
選択したモデルの正確な API モデル ID を使用してください。エージェントまたはビジョン機能を有効にする前に、そのコンテキストと機能を確認してください。
モデルを選択してください
構成例
API キーをサーバー環境またはツール認証情報ストアに保管します。該当する場合は、サンプルのキー フィールドを独自のキーに置き換えます。
Python · pip インストール langchain-openai
import os
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="qwen/qwen3.8-27b",
base_url="https://api.iteracompute.com/v1",
api_key=os.environ["ITERACOMPUTE_API_KEY"],
use_responses_api=False,
stream_usage=False,
max_tokens=512,
extra_body={"chat_template_kwargs": {"enable_thinking": False}},
)
print(llm.invoke("Hello!").content)バージョンと検証
構成リファレンス · 2026 年 10 月 15 日にレビューされました。再現可能なエンドツーエンドのツール テストはここには記録されていません。以下の手順を実行するときに、インストールされているバージョンとテスト日を記録してください。
達成基準
llm.invoke を実行し、AIMessage.content が空でないことを確認します。このテキスト例とは別にツール実行をテストします。
インストールされているバージョンを記録する
python -m pip show langchain-openai以下の 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 機能です。ワークフローで利用できる機能は、ツールとその設定によっても異なります。推論コントロールはモデルによって異なります。
- チャットの完了サポートされています
- ツール呼び出しサポートされています
- 推論サポートされています
- 画像入力サポートされています
- ストリーミングサポートされています
トラブルシューティング
間違ったパッケージまたはエンドポイント
ChatOpenAI を langchain_openai からインポートします。このチャット完了レシピでは、base_url の末尾が /v1 であり、use_responses_api=False のままにしておきます。
ストリーミング使用エラー
この互換エンドポイントの例では、stream_usage=False を設定します。すべての OpenAI 固有のストリーミング オプションが選択したモデルで受け入れられると想定しないでください。
エージェントはツールを実行しません
テキスト呼び出しでは、テキスト生成のみがテストされます。ツールを個別にバインドし、返されたツール呼び出しを検査し、エージェントのサポートを要求する前に制限付きテスト ツールを実行します。
429 / リクエスト制限
アカウント全体の月間使用量と TPM を確認します。Retry-After を尊重し、並列再試行を避けます。Free Qwen には、自動的に支払われる超過料金はありません。他のモデルには公開価格が適用されます。
401 / 403: キーとモデルの権限を確認します。無料の Qwen には残高やカードは必要ありません。有料モデルの場合は、利用可能残高も確認してください。
