1. 创建 API Key
注册或登录 IteraCompute,然后在控制台创建 API Key。
使用 TypeScript 构建 AI 应用。
本次免费活动于 2026 年 11 月 24 日 00:00(美国太平洋时间)结束。截止前已完成充值且净充值大于 0 的用户继续保留原有免费档位。此后,共享免费 Auto 仅向这些老充值用户和当前有效套餐用户开放;新充值不再获得或升级免费权益。套餐内 Auto 额度与每月共享免费权益独立计算。
注册或登录 IteraCompute,然后在控制台创建 API Key。
通过 IteraCompute baseURL 创建 OpenAI 兼容提供方,再将其模型传给 generateText。
使用准确的 API Model ID,启用智能体或视觉功能前确认上下文与模型能力。
将 API Key 保存在服务端环境或工具凭据存储中;需要手动填写密钥的字段请使用自己的 API Key。
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 本身不够。推理可能消耗输出预算。免费 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)'使用 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"
}
$text成功标准是 choices[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.mjs使用 Node.js 22 或更新版本,在服务端运行 example.mjs。将密钥保存为服务端环境变量或部署密钥;不要使用 NEXT_PUBLIC_ 或 VITE_ 前缀、提交 .env 文件,或在浏览器代码中调用。此示例通过 Chat Completions 使用免费 Auto,关闭思考的参数仅适用于 Auto。
Hello!能力表示 IteraCompute 接口的支持情况。工作流程中的可用性也取决于工具与配置,推理参数因模型而异。
检查 API Key 与 Auto 的访问权限。Free 档无需余额或绑卡,其他模型可能需要付费余额。
使用 OpenAI Compatible、带 /v1 的 Base URL 与准确的 Auto。使用 Chat Completions,不应假定支持 Responses。Qwen3.8-Max 是另一个付费模型。
Free 档输入与申请的最大输出合计不得超过 131072 tokens。减少附件、历史或输出预算。HTTP 200 但内容为空仍未完成;可尝试关闭思考的首次免费调用短示例。
在控制台检查账户共享的月用量与并发。遵循 Retry-After,避免并发重试。额度耗尽不会自动付费超额调用;等待 UTC 月度重置,或充值解锁更高档。
401 / 403:检查密钥与模型权限。免费 Auto 无需余额或绑卡;使用付费模型时还需检查可用余额。