OpenAI 互換

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

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

無料キャンペーンは2026年11月24日午前0時(米国太平洋時間)に終了します。期限前に入金が完了し、返金を差し引いたチャージ額がプラスのユーザーは従来の無料ティアを維持します。以降、共有の無料 Auto を利用できるのはこれらのユーザーと有効期間中のプラン加入者のみです。以降のチャージで無料特典を取得・アップグレードすることはできません。プランの Auto 利用枠と月間の共有無料特典は別枠です。

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("Auto"),
  prompt: "Reply with exactly: Hello!",
  maxOutputTokens: 512,

});
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":"Auto","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'

choices[0].message.content に表示されるテキストが含まれていることを確認します。HTTP 200 だけでは不十分です。推論により出力バジェットが消費される可能性があります。無料のQwenを使用するには、 初めての無料API呼び出しの例 思考を無効にするには、ツール内でプロンプトを送信します。

初めての無料API呼び出し

  1. ログインし、以下の利用資格に基づいてアカウントで Auto を利用できることをご確認ください。
  2. Auto を許可するキーを作成し、一度だけ表示されるシークレットを保存します。API Keys を開く
  3. 以下でシェルを選び、your-api-key を自分のキーに置き換えてください。
Auto

macOS、Linux、WSL の Bash には cURL と Python 3 が必要です。response.json はローカルに保存してください。

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":"Auto","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512,"reasoning":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!(文言は変わる場合があります)。

この Auto の例では、目に見える短い応答に対する思考を無効にします。401/403: キーとモデルの権限を確認します。429: コンソールで毎月の使用量と 同時実行 を確認し、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 でチャット完了を使用します。その思考オプションは Auto に固有です。

出力例
Hello!

バージョンと検証

テストしたバージョン
ai 7.0.137 · @ai-sdk/openai-compatible 3.0.67 · Node.js 25.2.1
結果
サーバー側テキスト生成が合格。

選択済みモデルの機能

機能は IteraCompute API の対応状況を示します。ワークフローでの利用可否はツールと設定にも依存し、推論の制御方法はモデルによって異なります。

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

トラブルシューティング

401 / 403

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

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

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

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

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

429 / 無料制限

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

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

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

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

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