大模型API入门：完成第一次调用

从获取密钥、选择模型到发送请求，完成一次 OpenRouter API 调用，并学会区分认证、额度和限流错误。

2026/07/03 · 4 分钟 · AI工具教程 · 更新于 2026/10/01

入门教程AI工具教程

你想把 AI 接进自己的小工具，第一步其实很小：发出一个请求，拿到一段回复。

这篇先走通 OpenRouter 的直接调用。等接口能用了，再考虑客户端和自建中转。先把一个请求弄明白，后面排错会容易很多。

预计 20—40 分钟。依据官方文档整理，实际结果取决于你的环境。本文未使用读者账户执行计费调用，实际可用模型、费用和额度以你的账户与模型页面为准。

开始前准备什么

• 一个 OpenRouter 账户和你自己的 API Key
• Node.js 22 或更新版本
• 模型列表里当前可调用的完整模型 ID
• 一个本地文件夹，用来保存示例

免费模型怎样选

打开 OpenRouter 模型列表，查看当前价格和可用性。选中模型后，复制完整 ID；不要只复制展示名称。

标为免费不代表无限调用。请求频率、每日额度和上游容量都可能限制使用。需要长期稳定运行的应用，应单独核算预算，不把免费层当作服务保证。核对额度与限流说明。

写一个最小请求

创建 .env，填入自己的值。把它加入 .gitignore，不要上传到 GitHub：

OPENROUTER_API_KEY=你的密钥
OPENROUTER_MODEL=你选的完整模型 ID

再创建 call-api.mjs：

const key = process.env.OPENROUTER_API_KEY;
const model = process.env.OPENROUTER_MODEL;

if (!key || !model) {
  throw new Error("请填写 .env 中的密钥和模型 ID");
}

const response = await fetch(
  "https://openrouter.ai/api/v1/chat/completions",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${key}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model,
      messages: [
        { role: "user", content: "用一句话解释什么是 API。" },
      ],
    }),
    signal: AbortSignal.timeout(60000),
  },
);

if (!response.ok) {
  console.error("调用失败，HTTP 状态码：", response.status);
  process.exit(1);
}

const data = await response.json();
console.log(data.choices?.[0]?.message?.content ?? "未返回文本");

在终端运行：

node --env-file=.env call-api.mjs

怎样判断跑通了

终端出现模型回复，且没有认证或额度错误，就完成了第一步。再到服务提供方的调用记录里核对模型、时间和费用。

不要仅凭“HTTP 200”判断完整成功：还要看是否拿到了所需文本。有些模型返回的内容形态不同，需要按对应文档处理。

卡住时先看哪里

重试时先减少并发。限流后应等待再试，不要用高频循环反复请求。

接下来做什么

把这次成功调用的模型 ID、日期和错误处理记下来，再将接口接到自己的应用。前端页面不应暴露服务端密钥。

想开始创作，可以继续读 ComfyUI 第一张图；想部署自己的内容站，接着看 Cloudflare Pages 博客入门。

官方参考：快速开始、模型目录、额度与限流。