目录
Ox Alpha怎么用？免费模型API接入教程：从注册到实战
咬代码的兽
2026年08月29日 16:49

Ox Alpha 是 2026 年 8 月 20 日上线 OpenRouter 的匿名免费大模型（模型 ID：stealth/ox-alpha），100 万 Token 上下文、支持文本/图片/视频输入，编码能力对标 Claude Fable 5 和 GPT-5.6。

关于它"是什么、有多强、到底谁开发的"，可以看这篇深度评测《Ox Alpha 是什么：OpenRouter 匿名 1M 上下文模型深度评测与上手指南》（https://xia345.com/ai-guide/ox-alpha-openrouter-guide）；本篇只解决一个问题：把它跑起来。

先给赶时间的读者一份 30 秒结论：

  • 完全免费：预览期内输入输出 0 元，不需要绑定信用卡；

  • API 完全开放：原生兼容 OpenAI 协议，Base URL 是 https://openrouter.ai/api/v1，也支持 Anthropic 格式，任何现有代码改个地址就能用；

  • 四种用法：网页 Playground 直接聊、命令行 cURL、Python/TypeScript SDK、接入 Claude Code、Cursor、OpenCode 等编码工具；

  • 一个限制要提前知道：免费账户每天最多 50 次请求（每分钟 20 次），充值 10 美元后解锁每天 1000 次。

下面从注册开始，一步步走完全流程。所有步骤均基于 2026 年 8 月 21 日的实测，配置细节以 OpenRouter 官方文档为准。

开始之前：三个必须知道的事实

事实一：免费是真的，但有每日请求上限

OpenRouter 对所有免费模型（:free 后缀变体及免费预览模型）执行统一限流：

| 账户累计充值金额 | 每分钟请求数 | 每日请求数 |

| --- | --- | --- |

| 少于 10 美元 | 20 次 | 50 次 |

| 累计 10 美元及以上 | 20 次 | 1000 次 |

注意两点：一是这里的 10 美元指账户历史累计充值，余额可以花掉，不影响档位；二是把 Claude Code 这类编码 Agent 接上之后，一次复杂任务可能连环触发几十次请求，50 次/天的免费额度很快就会用完，重度用户建议充 10 美元解锁 1000 次/天——这 10 美元本身还可以正常用于调用其他付费模型，不亏。

事实二：数据会被留存，但声明不用于训练

OpenRouter 官方说明：Ox Alpha 的提示词与生成内容会被匿名供应商留存，不会用于训练。"留存但不训练"意味着数据在供应商侧的服务器上存在，匿名供应商的身份与安全水位不可验证——测试代码、公开项目、学习用途都没问题，公司涉密代码、客户数据、生产环境的关键逻辑不建议发送。

事实三：免费窗口随时可能关闭

参照 OpenRouter 历史 stealth 模型的惯例，免费期通常在身份揭晓或盲测结束时终止（OpenCode 侧公告口径约为一周）。本文的配置方法在任何时候都适用，但"0 元"这件事本身有明确的保质期，建议尽早体验。

第一步：注册 OpenRouter，拿到 API Key

整个过程 3 分钟，全程免费，不需要信用卡。

1. 打开 openrouter.ai，点击右上角 Sign In，用 Google 或 GitHub 账号一键登录（也支持邮箱注册）；

2. 登录后进入控制台的 Keys 页面（头像 → Keys），点击 Create Key；

3. 给 Key 起个名字（比如 ox-alpha），确认创建；

4. 立刻复制保存弹出的 Key——它只完整显示这一次，关闭弹窗后就再也看不到，丢了只能重新创建。

拿到的 Key 以 sk-or-v1- 开头。把 Key 配置为环境变量，后面的所有示例都直接读它：

代码块
Shell
自动换行
复制代码
# macOS / Linux（bash/zsh）
复制成功

export OPENROUTER_API_KEY="sk-or-v1-你的key"

Windows（PowerShell）

$env:OPENROUTER_API_KEY="sk-or-v1-你的key"

第二步（可选）：Playground 网页直接体验

还不想写代码？打开 Ox Alpha 的官方模型页，点击 Playground，登录后即可直接对话。适合先感受一下模型水平，再决定要不要配进自己的工具链。

第三步：API 调用——三种语言示例

Ox Alpha 兼容 OpenAI Chat Completions 协议，把任何现有 OpenAI 客户端的 base_url 指向 OpenRouter 即可。唯一的区别是模型名写成 stealth/ox-alpha。

cURL 命令行

代码块
Shell
自动换行
复制代码
curl https://openrouter.ai/api/v1/chat/completions \
复制成功

-H "Authorization: Bearer $OPENROUTER_API_KEY" \

-H "Content-Type: application/json" \

-d '{

"model": "stealth/ox-alpha",

"messages": [

{"role": "user", "content": "用一段话解释什么是数据库死锁，并给出三个常见诱因"}

]

}'

返回标准 OpenAI 格式的 JSON。加上 "stream": true 就是流式输出。

Python（OpenAI SDK，流式输出）

代码块
Python
自动换行
复制代码
import os
复制成功

from openai import OpenAI

client = OpenAI(

base_url="https://openrouter.ai/api/v1",

api_key=os.environ["OPENROUTER_API_KEY"],

)

stream = client.chat.completions.create(

model="stealth/ox-alpha",

messages=[

{"role": "system", "content": "你是一位资深全栈工程师，回答精炼、给可运行代码。"},

{"role": "user", "content": "写一个 Python 脚本：监控目录变化并把新增文件备份到另一个目录"},

],

stream=True,

)

for chunk in stream:

text = chunk.choices[0].delta.content

if text:

print(text, end="", flush=True)

TypeScript（原生 fetch）

代码块
TypeScript
自动换行
复制代码
const res = await fetch("https://openrouter.ai/api/v1/chat/completions", {
复制成功

method: "POST",

headers: {

Authorization: Bearer ${process.env.OPENROUTER_API_KEY},

"Content-Type": "application/json",

},

body: JSON.stringify({

model: "stealth/ox-alpha",

messages: [{ role: "user", content: "把这个 JS 函数改成尾递归优化版本：..." }],

}),

});

const data = await res.json();

console.log(data.choices[0].message.content);

进阶参数：推理、图片输入、工具调用

Ox Alpha 还支持几个值得知道的进阶玩法：

代码块
JSON
自动换行
复制代码
{
复制成功

"model": "stealth/ox-alpha",

"reasoning": { "effort": "high" },

"messages": [

{

"role": "user",

"content": [

{ "type": "text", "text": "这张截图里的页面错位是什么原因？给出修复建议" },

{ "type": "image_url", "image_url": { "url": "https://你的图片地址.png" } }

]

}

]

}

  • reasoning.effort：控制推理深度，复杂任务设 high 效果更好；

  • 多模态输入：content 用数组格式，image_url 传图片（也支持视频输入），排障时"截图 + 提问"比文字描述高效得多；

  • tools / tool_choice：标准工具调用，LangChain、各类 Agent 框架可以直接接入；

  • response_format: { "type": "json_schema" }：强制 JSON 结构化输出，做数据抽取很稳。

第四步：接入 Claude Code

这是本次免费公测最实用的玩法：把 Claude Code 的后端模型整个换成 Ox Alpha。Claude Code 原生支持自定义 Anthropic 端点，而 OpenRouter 提供了 Anthropic 协议兼容层，配置只需一个 JSON 文件。

编辑 ~/.claude/settings.json（用户级配置，对所有项目生效）：

代码块
JSON
自动换行
复制代码
{
复制成功

"env": {

"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",

"ANTHROPIC_AUTH_TOKEN": "sk-or-v1-你的key",

"ANTHROPIC_API_KEY": "",

"ANTHROPIC_MODEL": "stealth/ox-alpha"

}

}

四个字段的含义：

  • ANTHROPIC_BASE_URL：指向 OpenRouter 的 Anthropic 兼容端点，注意这里是 /api 结尾，不是 /api/v1；

  • ANTHROPIC_AUTH_TOKEN：填你的 OpenRouter API Key；

  • ANTHROPIC_API_KEY：留空即可，避免和真实 Anthropic Key 冲突；

  • ANTHROPIC_MODEL：把默认模型指定为 stealth/ox-alpha。

保存后重启 Claude Code（或新开一个会话），随便发一句"你好，你是什么模型"验证。想换回官方模型，把这几个环境变量删掉即可。

提示：Claude Code 一次编码任务往往触发多轮连续请求，免费额度 50 次/天可能两三个任务就用完了。打算认真用的话，先给账户充 10 美元解锁每日 1000 次。

第五步：接入 Cursor

Cursor 支持自定义 OpenAI 兼容端点，配置路径：

1. 打开 Cursor 设置 → Models 页面；

2. 在 OpenAI API Key 区域填入你的 sk-or-v1- 开头的 Key；

3. 勾选 Override OpenAI Base URL，填入 https://openrouter.ai/api/v1；

4. 在模型列表里手动添加模型，模型名填 stealth/ox-alpha（列表里默认没有它，必须手填）；

5. 点击 Verify 验证通过后保存。

配置完成后，在对话面板的模型下拉框里选择 stealth/ox-alpha 即可使用。Tab 补全等本地功能不受影响，受影响的是 Chat 和 Agent 的后端模型。

第六步：接入 OpenCode

OpenCode 是本次事件的主角之一（Ox Alpha 同时上了 OpenCode 的免费模型池）。两种接法：

  • 方式一（推荐）：在 OpenCode 终端里执行 /connect，登录 OpenCode 账号后在免费模型列表中直接选择 stealth/ox-alpha，不需要任何配置；

  • 方式二（用 OpenRouter 直连）：编辑 opencode.json，添加 provider 配置：

代码块
JSON
自动换行
复制代码
{
复制成功

"provider": {

"openrouter": {

"npm": "@ai-sdk/openai-compatible",

"name": "OpenRouter",

"options": {

"baseURL": "https://openrouter.ai/api/v1",

"apiKey": "{env:OPENROUTER_API_KEY}"

},

"models": {

"stealth/ox-alpha": { "name": "Ox Alpha (Free)" }

}

}

}

}

方式一走 OpenCode 官方通道，免费期内近乎不限量；方式二走你自己的 OpenRouter Key，请求计入上面说的每日限额。

报错排查：三类高频问题

401 Unauthorized

API Key 错误或失效。检查三点：Key 是否以 sk-or-v1- 开头、有没有多余空格或换行、Authorization: Bearer 和 Key 之间是否只有一个空格。在 Claude Code 配置里，则确认 ANTHROPIC_BASE_URL 填的是 https://openrouter.ai/api（多了 /v1 会 404 或鉴权失败）。

402 Payment Required

账户余额为负，或 Key 设置了消费上限且已用完。免费模型正常不会触发 402，出现它说明账户欠费，充值恢复正余额即可。

429 Rate Limit Exceeded

触发限流：每分钟超过 20 次，或当天免费额度用完。排查方法——用 GET 请求查 Key 的实时状态：

代码块
Shell
自动换行
复制代码
curl https://openrouter.ai/api/v1/key \
复制成功

-H "Authorization: Bearer $OPENROUTER_API_KEY"

返回里的 usage_daily 是当天已用额度。若确认是每日 50 次上限：要么等第二天 UTC 重置，要么充值 10 美元解锁 1000 次/天。给 Agent 场景的建议是给请求加上指数退避重试，避免连环请求瞬间打满每分钟限额。

国内网络环境

OpenRouter 的 API 域名和主站在国内部分网络环境下可能无法直连，需要自备代理。网页端 Playground 与 API 的连通性一致，可先用 Playground 测试网络再配置工具链。

常见问题（FAQ）

Ox Alpha 怎么用？

四种方式：OpenRouter 官网 Playground 直接对话；cURL/SDK 通过 https://openrouter.ai/api/v1 调用（模型名 stealth/ox-alpha）；配置到 Claude Code（改 ~/.claude/settings.json 的环境变量）；配置到 Cursor（Settings → Models → 自定义 OpenAI 端点）或 OpenCode。

Ox Alpha 免费吗？要绑信用卡吗？

免费，预览期内输入输出均 0 元，注册 OpenRouter 不需要信用卡，用 Google/GitHub 账号即可登录。唯一的隐性门槛是免费账户每天 50 次请求上限。

Ox Alpha 每天能用多少次？

免费账户每分钟 20 次、每天 50 次；账户累计充值 10 美元后提升为每分钟 20 次、每天 1000 次。额度按 OpenRouter 账户计算，与 Key 数量无关。

Ox Alpha 的 API Base URL 是什么？

OpenAI 格式为 https://openrouter.ai/api/v1，Anthropic 格式（配 Claude Code 用）为 https://openrouter.ai/api。模型名统一填 stealth/ox-alpha。

遇到 429 报错怎么办？

429 表示触发限流。先查当天用量，若是每日 50 次上限，等 UTC 重置或充值 10 美元解锁 1000 次/天；若是每分钟 20 次上限，给请求加退避重试即可。

Ox Alpha 支持图片和视频输入吗？

支持。content 数组里用 image_url 类型传图片，视频同理，配合 100 万上下文可以做整库分析、录屏排障等重活。

相关阅读

  • 本文首发并持续更新于：Ox Alpha 怎么用？免费模型 API 接入教程 - xia345 AI 指南

  • Ox Alpha 是什么：OpenRouter 匿名 1M 上下文模型深度评测与上手指南

  • Claude Code 充值订阅全攻略 2026

  • Cursor vs Claude Code：2026 年 AI 编程工具怎么选

  • OpenRouter 官方模型页：

本文信息截至 2026 年 8 月 21 日，基于 OpenRouter 官方文档与实测整理。stealth 模型的价格与限额政策变化较快，以官方页面为准。

cv52732245