Ox Alpha 怎么用?

Ox Alpha 是 2026 年 8 月 20 日上线 OpenRouter 的匿名免费大模型(模型 ID:stealth/ox-alpha),100 万 Token 上下文、支持文本/图片/视频输入,编码能力对标 Claude Fable 5 和 GPT-5.6。关于它"是什么、有多强、到底谁开发的",我们写过一篇深度评测与背景分析;本篇只解决一个问题:把它跑起来。

先给赶时间的读者一份 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 美元指账户历史累计充值,余额可以花掉,不影响档位;二是把 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- 开头:

sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

把 Key 配置为环境变量,后面的所有示例都直接读它:

# 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 命令行

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,流式输出)

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)

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 还支持几个值得知道的进阶玩法:

{
  "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(用户级配置,对所有项目生效):

{
  "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 配置:

{
  "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 的实时状态:

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 测试网络再配置工具链。

相关阅读

• 站内指南:Ox Alpha 是什么:OpenRouter 匿名 1M 上下文模型深度评测与上手指南——模型评测、编码实测数据与身份之谜分析
• 站内指南:Claude Code 充值订阅全攻略 2026
• 站内指南:Cursor vs Claude Code:2026 年 AI 编程工具怎么选
• 站内指南:AI Agent 是什么:从对话回答到自动执行任务
• OpenRouter 官方模型页:https://openrouter.ai/stealth/ox-alpha

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