接入前准备
所有 CLI / SDK 接入 Astra API 前都要做的三步。下面每篇专项文档（Codex / Claude Code / GPT Image）都假设你已经走完这里。
1. 控制台登录
| 用途 | 地址 |
|---|---|
| 登录 | https://api.637274.xyz/login |
| API Key 管理 | https://api.637274.xyz/settings |
| 模型与价格 | https://api.637274.xyz/（首页） |
新账号联系管理员开通。
2. 创建 API Key
进 /settings → 「创建 API Key」 → 起名 → 提交。完整 Key 只显示这一次，立即复制保存到密码管理器。
后续配置里的 sk-xxx 都替换成这个完整 Key —— 不要填列表里 sk-...**** 这种脱敏预览值，那只是给你识别用的，不能拿来鉴权。
Key 泄漏后到
/settings点「重置」立即失效旧值；改 Key 不会影响已记账的请求和余额。
3. 确认模型与余额
打开控制台首页，「可用模型与价格」表里能看到：
- 你当前等级允许调用的模型清单
- 每个模型的输入 / 输出 / 缓存 / 图片单价
- 你的当前余额
如果模型列表里没有你想用的模型，或余额是 0，让管理员后台调一下。
接入地址速查
各客户端的 base_url 写法不同 —— 关键差异是要不要带 /v1：
| 协议 / 客户端 | base_url | 备注 |
|---|---|---|
| OpenAI Chat Completions / Responses（Codex CLI、OpenAI SDK、Cherry Studio 等） | https://api.637274.xyz/v1 |
必须带 /v1 |
| Anthropic Messages（Claude Code） | https://api.637274.xyz |
不带 /v1 |
| Gemini（generateContent） | https://api.637274.xyz/v1beta |
Gemini 自身就用 /v1beta |
| 图像生成 / 编辑 | https://api.637274.xyz/v1/images/generations（完整路径） |
同 OpenAI 风格 |
鉴权 Header
不同协议鉴权 header 不同，把 sk-xxx 替换成你 Key 即可：
| 协议 | Header |
|---|---|
| OpenAI 系 | Authorization: Bearer sk-xxx |
| Anthropic | x-api-key: sk-xxx 或环境变量 ANTHROPIC_AUTH_TOKEN=sk-xxx |
| Gemini | x-goog-api-key: sk-xxx |
做完这三步就可以去看具体客户端的接入文档了。