OpenAI 互換

IteraCompute を通じて Vercel AI SDK でモデルを使用します。

TypeScript で AI エクスペリエンスを構築します。

3 つのステップで接続する

1. APIキーを作成する

IteraCompute アカウントを作成するかサインインし、コンソールでキーを作成します。

2. ベース URL を構成する

IteraCompute のベース URL を使用して OpenAI 互換プロバイダーを作成し、そのモデルをgenerateText に渡します。

3. モデルを選択します

選択したモデルの正確な API モデル ID を使用してください。エージェントまたはビジョン機能を有効にする前に、そのコンテキストと機能を確認してください。

モデルを選択してください

構成例

API キーをサーバー環境またはツール認証情報ストアに保管します。該当する場合は、サンプルのキー フィールドを独自のキーに置き換えます。

example.mjs · Node.js 22+
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);

接続をテストする

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呼び出し

  1. メールアドレスを登録して確認するか、Google にサインインします。カードやチャージは必要ありません。
  2. API キーを開き、qwen/qwen3.8-27b を許可するキーを作成し、表示されたシークレットを一度保存​​します。
  3. このスクリプトは、cURLとPython 3を使用してBash(macOS、Linux、またはWSL)で実行してください。your-api-keyを実際のAPIキーに置き換えてください。response.jsonはローカルに保存してください。
Bash · Qwen3.8-27B · $0
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 だけでは有効化は完了しません。出力例:Hello!(文言は変わる場合があります)。

この Qwen の例では、目に見える短い応答に対する思考を無効にします。401/403: キーとモデルの権限を確認します。429: コンソールで毎月の使用量と TPM を確認し、Retry-Afterを尊重します。空き容量がキューに入る可能性があります。並列再試行を繰り返し実行しないでください。

完全な最小限の例を実行します。

Bash · setup and run
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.mjs

Node.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 アプリケーションとして実行されます。

実際の標準出力 · 2026 年 10 月 11 日
Hello!

選択済みモデルの機能

これらは、選択したモデルの API 機能です。ワークフローで利用できる機能は、ツールとその設定によっても異なります。推論コントロールはモデルによって異なります。

  • チャットの完了サポートされています
  • ツール呼び出しサポートされています
  • 推論サポートされています
  • 画像入力サポートされています
  • ストリーミングサポートされています

トラブルシューティング

401 / 403

qwen/qwen3.8-27bのAPIキーと権限を確認してください。無料利用枠には残高やカードは必要ありません。他のモデルでは、有料残高が必要になる場合があります。

404 / 間違ったエンドポイント

OpenAI 互換、/v1 ベース URL、および qwen/qwen3.8-27b を正確に使用してください。チャット補完を使用します。応答のサポートを想定しないでください。Qwen3.8-2.4T-A95B は別の有料モデルです。

400 / コンテキストまたは空の応答

無料の場合、入力と要求された最大出力は 131072 トークンに適合する必要があります。添付ファイル/履歴または出力予算を削減します。コンテンツが空の HTTP 200 は不完全です。思考を妨げる短い無料通話の例を試してください。

429 / 無料制限

アカウント全体の月間使用量と TPM をコンソールで確認します。Retry-After を尊重し、並列再試行を避けます。クォータを使い果たした場合でも、超過料金は自動的に支払われません。UTC の毎月のリセットを待つか、トップアップで上位ティアのロックを解除してください。

401 / 403: キーとモデルの権限を確認します。無料の Qwen には残高やカードは必要ありません。有料モデルの場合は、利用可能残高も確認してください。

Vercel AI SDK 構成リファレンス →

Vercel AI SDK で構築を開始します。

キーを接続し、モデルを選択して、最初のリクエストを送信します。