Appearance
认证方式
1XM.AI 使用 API Key 进行身份认证。
🔑 获取 API Key
- 登录 控制台
- 进入「令牌」→「创建令牌」
- 输入令牌名称,复制生成的 Key(格式:
sk-xxxxx)
⚠️ 安全提醒
- API Key 只在创建时显示一次,请立即复制保存
- 不要在客户端代码中硬编码,推荐使用环境变量
- Key 泄露后立即在控制台删除并重建
🔐 如何传递 API Key
Bearer Token(标准方式)
bash
curl -X POST https://api.1xm.ai/v1/chat/completions \
-H "Authorization: Bearer sk-你的Key" \
-H "Content-Type: application/json" \
-d '{"model": "claude-sonnet-4-6", "messages": [{"role": "user", "content": "你好"}]}'Python SDK
python
from openai import OpenAI
client = OpenAI(
api_key="sk-你的Key", # 填入你的 Key
base_url="https://api.1xm.ai/v1"
)Claude Code 环境变量
Claude Code 使用独立的环境变量名称:
bash
export ANTHROPIC_BASE_URL="https://1xm.ai/"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"🔒 环境变量最佳实践
macOS/Linux(写入 ~/.zshrc):
bash
echo 'export ANTHROPIC_BASE_URL="https://1xm.ai/"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的Key"' >> ~/.zshrc
source ~/.zshrcPython 项目(.env 文件 + python-dotenv):
bash
# .env 文件(加入 .gitignore!)
OPENAI_API_KEY=sk-你的Key
OPENAI_BASE_URL=https://api.1xm.ai/v1python
from dotenv import load_dotenv
import os
from openai import OpenAI
load_dotenv()
client = OpenAI(
api_key=os.getenv("OPENAI_API_KEY"),
base_url=os.getenv("OPENAI_BASE_URL")
)❌ 认证错误
| 错误码 | 含义 | 解决方案 |
|---|---|---|
| 401 | API Key 无效或未传递 | 检查 Key 是否正确,Header 格式是否对 |
| 403 | 权限不足 | 检查账户余额和 Key 状态 |
| 429 | 请求过于频繁 | 降低调用频率 |