1. APIキーを作成する
IteraCompute アカウントを作成するかサインインし、コンソールでキーを作成します。
IteraCompute アカウントを作成するかサインインし、コンソールでキーを作成します。
IteraCompute のベース URL を使用して OpenAI 互換プロバイダーを作成し、そのモデルをgenerateText に渡します。
選択したモデルの正確な API モデル ID を使用してください。エージェントまたはビジョン機能を有効にする前に、そのコンテキストと機能を確認してください。
API キーをサーバー環境またはツール認証情報ストアに保管します。該当する場合は、サンプルのキー フィールドを独自のキーに置き換えます。
import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { generateText } from "ai";
if (!process.env.ITERACOMPUTE_API_KEY) {
throw new Error("Set ITERACOMPUTE_API_KEY on the server.");
}
const itera = createOpenAICompatible({
name: "iteracompute",
baseURL: "https://api.iteracompute.com/v1",
apiKey: process.env.ITERACOMPUTE_API_KEY,
});
const { text } = await generateText({
model: itera("qwen/qwen3.8-27b"),
prompt: "Reply with exactly: Hello!",
maxOutputTokens: 512,
providerOptions: { iteracompute: { chat_template_kwargs: { enable_thinking: false } } },
});
if (!text.trim()) throw new Error("Empty model reply: activation is incomplete.");
console.log(text);# 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を使用するには、 初めての無料通話例 思考を無効にするには、ツール内でプロンプトを送信します。
export ITERACOMPUTE_API_KEY="your-api-key"
curl --fail-with-body --max-time 180 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,"chat_template_kwargs":{"enable_thinking":false}}' \
-o response.json && python3 -c 'import json; r=json.load(open("response.json")); text=r["choices"][0]["message"]["content"]; assert text and text.strip(), "Empty model reply: activation is incomplete"; print(text)'成功とは、choices[0].message.content が空ではないことを意味します。このコマンドはそれを出力しますが、空の応答で失敗します。登録または HTTP 200 だけではアクティベーションは完了しません。期待される出力: こんにちは!(表現は異なる場合があります)。
この Qwen の例では、目に見える短い応答に対する思考を無効にします。401/403: キーとモデルの権限を確認します。429: コンソールで毎月の使用量と TPM を確認し、再試行後を尊重します。空き容量がキューに入る可能性があります。並列再試行を繰り返し実行しないでください。
mkdir itera-ai-example
cd itera-ai-example
npm init -y
npm install ai@7.0.137 @ai-sdk/openai-compatible@3.0.67
export ITERACOMPUTE_API_KEY="your-api-key"
# Save the example above as example.mjs
node example.mjsNode.js 22 以降を使用してください。サーバー上で example.mjs を実行します。キーをサーバー環境変数またはデプロイメント シークレットに保存します。NEXT_PUBLIC_ や VITE_ を使用したり、.env ファイルをコミットしたり、ブラウザ コードから API を呼び出したりしないでください。このサンプルでは、無料の Qwen でチャット完了を使用します。その思考オプションは Qwen3.8-27B に固有です。
2026 年 10 月 11 日に Node.js 25.2.1、ai 7.0.137、@ai-sdk/openai-compatibility 3.0.67 で検証。実際の API 結果: こんにちは!(先頭の空白は省略されます)。このサンプルでは、空ではない応答がないかチェックします。この例は、サーバー側 CLI アプリケーションとして実行されます。
Hello!これらは、選択したモデルの API 機能です。ワークフローで利用できる機能は、ツールとその設定によっても異なります。推論コントロールはモデルによって異なります。
qwen/qwen3.8-27bのAPIキーと権限を確認してください。無料利用枠には残高やカードは必要ありません。他のモデルでは、有料残高が必要になる場合があります。
OpenAI 互換、/v1 ベース URL、および qwen/qwen3.8-27b を正確に使用してください。チャット補完を使用します。応答のサポートを想定しないでください。Qwen3.8-2.4T-A95B は別の有料モデルです。
無料の場合、入力と要求された最大出力は 131072 トークンに適合する必要があります。添付ファイル/履歴または出力予算を削減します。コンテンツが空の HTTP 200 は不完全です。思考を妨げる短い無料通話の例を試してください。
アカウント全体の月間使用量と TPM をコンソールで確認します。Retry-After を尊重し、並列再試行を避けます。クォータを使い果たした場合でも、超過料金は自動的に支払われません。UTC の毎月のリセットを待つか、トップアップで上位ティアのロックを解除してください。
401 / 403: キーとモデルの権限を確認します。無料の Qwen には残高やカードは必要ありません。有料モデルの場合は、利用可能残高も確認してください。