1. APIキーを作成する
IteraCompute アカウントを作成するかサインインし、コンソールでキーを作成します。
TypeScript で AI エクスペリエンスを構築します。
無料キャンペーンは2026年11月24日午前0時(米国太平洋時間)に終了します。期限前に入金が完了し、返金を差し引いたチャージ額がプラスのユーザーは従来の無料ティアを維持します。以降、共有の無料 Auto を利用できるのはこれらのユーザーと有効期間中のプラン加入者のみです。以降のチャージで無料特典を取得・アップグレードすることはできません。プランの Auto 利用枠と月間の共有無料特典は別枠です。
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("Auto"),
prompt: "Reply with exactly: Hello!",
maxOutputTokens: 512,
});
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":"Auto","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'choices[0].message.content に表示されるテキストが含まれていることを確認します。HTTP 200 だけでは不十分です。推論により出力バジェットが消費される可能性があります。無料のQwenを使用するには、 初めての無料API呼び出しの例 思考を無効にするには、ツール内でプロンプトを送信します。
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)'Windows PowerShell 5.1 または PowerShell 7+ の組み込みコマンドを使用します。WSL、cURL、Python は不要です。
$env:ITERACOMPUTE_API_KEY = "your-api-key"
$body = @{
model = "Auto"
messages = @(@{ role = "user"; content = "Reply with exactly: Hello!" })
max_tokens = 512
reasoning = $false
} | ConvertTo-Json -Depth 5
$response = Invoke-RestMethod -Method Post `
-Uri "https://api.iteracompute.com/v1/chat/completions" `
-Headers @{ Authorization = "Bearer $env:ITERACOMPUTE_API_KEY" } `
-ContentType "application/json" -Body $body -TimeoutSec 180 -ErrorAction Stop
$text = $response.choices[0].message.content
if ([string]::IsNullOrWhiteSpace($text)) {
throw "Empty model reply: activation is incomplete"
}
$textchoices[0].message.content に空でないテキストが返れば成功です。このコマンドはテキストを表示し、空の応答ではエラーになります。登録または HTTP 200 だけでは有効化は完了しません。出力例:Hello!(文言は変わる場合があります)。
この Auto の例では、目に見える短い応答に対する思考を無効にします。401/403: キーとモデルの権限を確認します。429: コンソールで毎月の使用量と 同時実行 を確認し、Retry-Afterを尊重します。空き容量がキューに入る可能性があります。並列再試行を繰り返し実行しないでください。
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 でチャット完了を使用します。その思考オプションは Auto に固有です。
Hello!機能は IteraCompute API の対応状況を示します。ワークフローでの利用可否はツールと設定にも依存し、推論の制御方法はモデルによって異なります。
AutoのAPIキーと権限を確認してください。無料利用枠には残高やカードは必要ありません。他のモデルでは、有料残高が必要になる場合があります。
OpenAI 互換、/v1 ベース URL、および Auto を正確に使用してください。チャット補完を使用します。応答のサポートを想定しないでください。Qwen3.8-Max は別の有料モデルです。
無料の場合、入力と要求された最大出力は 131072 トークンに適合する必要があります。添付ファイル/履歴または出力予算を削減します。コンテンツが空の HTTP 200 は不完全です。思考を妨げる短い無料通話の例を試してください。
アカウント全体の月間使用量と 同時実行 をコンソールで確認します。Retry-After を尊重し、並列再試行を避けます。クォータを使い果たした場合でも、超過料金は自動的に支払われません。UTC の毎月のリセットを待つか、トップアップで上位ティアのロックを解除してください。
401 / 403: キーとモデルの権限を確認します。無料の Qwen には残高やカードは必要ありません。有料モデルの場合は、利用可能残高も確認してください。