Union Alpha 怎么用？OpenRouter 免费接入教程

接入 Union Alpha 不需要任何特殊 SDK：它挂在 OpenRouter 上，走 OpenAI 兼容协议，你只要注册 OpenRouter、生成 API Key，把接口地址换成 OpenRouter 的端点，模型 ID 填 stealth/union-alpha 即可。预览期标价 0 美元，全程不用充值。下面按步骤走一遍。

前置准备：账号、Key 和网络

开始之前确认三件事：

1. 一个 OpenRouter 账号：在官网用邮箱或第三方账号注册，不需要充值。
2. 一把 API Key：登录后进控制台的 Keys 页面创建，Key 只在创建时完整显示一次，记得保存。
3. 可用的网络：OpenRouter 是海外平台，注册和调用 API 都要求你的环境能正常访问它的网站和接口域名，国内网络下可用性请以你的实际环境为准。

如果你还不了解这类隐身模型的背景，先看这篇Union Alpha 是什么，再回来动手。

第一步：Playground 零代码试玩

不建议上来就写代码。先在 Union Alpha 的模型页点 Playground，网页里直接发消息，验证两件事：模型能不能正常响应，它的输出风格适不适合你的任务。图片输入也在这里试，把截图拖进对话框即可。

这个步骤还能帮你提前发现限流问题：如果网页里频繁报 429，说明当前时段提供方比较拥挤，写代码前就知道要加重试逻辑。

第二步：用 API 调用（curl 与 Python 示例）

OpenRouter 的接口与 OpenAI SDK 完全兼容，唯一要改的是 base_url 和模型名。

curl 示例：

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer sk-or-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model": "stealth/union-alpha", "messages": [{"role": "user", "content": "用一句话介绍你自己"}]}'

Python（openai SDK）示例：

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-你的Key",
)

resp = client.chat.completions.create(
    model="stealth/union-alpha",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

Union Alpha 支持 tools 和 tool_choice 参数，可以把函数定义直接传进去做 Agent 实验。函数调用的写法可以参考站内什么是 Function Calling，协议与 OpenAI 一致，不用额外学习。想把它编进更完整的 Agent 流程，可以对照OpenAI Agents API 教程里的编排思路。

第三步：接入编码工具实测

从 OpenRouter 公开的流量数据看，Cline、Claude Code、Hermes Agent 是当前调用 Union Alpha 最多的三类应用，说明社区已经把它当 Agent 后端模型在用。

以 Cline 为例的接入路径：

1. 打开 Cline 设置，API Provider 选 OpenRouter。
2. 粘贴你的 API Key。
3. 模型栏手动输入 stealth/union-alpha。
4. 发一个小任务（比如修一个单测），观察它能不能正确规划并调用工具。

验证成功与限流规则

验证跑通：响应 JSON 的 model 字段应显示 stealth/union-alpha，且能正常返回中文内容。

关于免费额度，按 OpenRouter 官方限流文档：带 :free 后缀的免费模型，未充值账户每天 50 次请求，累计充值满 10 美元提升到每天 1000 次，两类都是每分钟 20 次。注意 Union Alpha 当前标价 0 美元但模型 ID 不带 :free 后缀，实际请求上限以响应头里的 X-RateLimit 信息和账号面板为准，不要照搬上面的数字硬卡。

常见报错速查

429 的排查思路与OpenRouter 限流文档一致：先用 GET /api/v1/key 查剩余额度，再决定是等待、充值还是换模型。

另一种常见省钱路线是把接入改到其他平台，思路可以参考这篇GPT Live 1 API 上线指南里的多平台比价逻辑。