0x1c Wiki

账号与 API Key

API Key 的创建、命名、保存、轮换和常见鉴权错误排查。

API Key 是调用 0x1c 的凭证。只要别人拿到你的 Key，就可能消耗你的额度，所以请把它当成密码管理。

创建 Key

登录 0x1c 主站 后，在控制台找到 API Key、令牌或密钥管理页面。

创建时建议：

  • 每个工具单独创建一个 Key。
  • Key 名称包含用途和设备。
  • 不要把多个团队成员共用同一个 Key。
  • 临时测试 Key 用完就删除。

示例命名：

cursor-macbook-pro
codex-home-pc
claude-code-workstation
server-prod-chat

保存 Key

本地开发推荐放在环境变量中：

export OPENAI_API_KEY="sk-..."

项目里可以使用 .env.local：

OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://0x1c.io/v1

确认 .gitignore 包含：

.env
.env.local

鉴权方式

OpenAI 兼容接口通常使用：

Authorization: Bearer YOUR_API_KEY

Claude 原生协议或部分 Anthropic SDK 可能使用：

x-api-key: YOUR_API_KEY

实际使用时优先看客户端要求。如果客户端支持 OpenAI-compatible provider，通常只需要填 API Key，不需要手写请求头。

轮换 Key

当你怀疑 Key 泄漏，或更换设备、同事离职、项目迁移时，建议轮换 Key。

推荐流程：

  1. 创建一个新 Key。
  2. 把客户端配置切换到新 Key。
  3. 测试一次请求。
  4. 删除旧 Key。
  5. 观察用量是否恢复正常。

常见错误

错误可能原因处理方式
401 UnauthorizedKey 错误、少了 Bearer、复制时多了空格重新复制 Key，确认请求头格式
403 Forbidden账号无权限或套餐限制检查账号状态、余额和模型权限
429 Too Many Requests请求太频繁或达到速率限制降低并发，稍后重试
insufficient_quota余额不足或额度用尽充值、升级或更换可用模型
model_not_found模型 ID 写错或无权限从控制台模型列表复制完整 ID

团队使用建议

如果多人共用一个组织或项目：

  • 按人或按服务创建 Key，方便追踪用量。
  • 给生产服务单独 Key，避免被本地调试影响。
  • 定期检查异常用量。
  • 不要在聊天软件里明文传 Key。

快速开始

从注册 0x1c 到发出第一条 API 请求，完成最小可用配置。

模型与路由

如何选择 Claude、Gemini、OpenAI、DeepSeek 等模型，以及模型 ID 应该怎么填写。

On this page

创建 Key保存 Key鉴权方式轮换 Key常见错误团队使用建议