所有文档

认证

1024X 通过 bearer token 认证每一次 API 请求。每个 key 绑定单个用户, 用量与计费按请求逐条归集。

创建 Key

进入 /user/keys 点击 Create key。每个 key 以 nub_ 开头, 只显示一次, 请用密码管理器保存。

发送 Key

每次请求随意选其中一个 header。Anthropic 风格的 x-api-key 和 OpenAI 风格的 Authorization: Bearer 都接受。

http
# Either header works.
Authorization: Bearer nub_xxxxxxxxxxxxxx
x-api-key: nub_xxxxxxxxxxxxxx
bash
curl https://api.1024x.ai/v1/messages \
  -H "Authorization: Bearer $X1024_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "claude-haiku-4-5", "max_tokens": 64,
        "messages": [{"role":"user","content":"ping"}] }'

轮转与撤销

Key 泄露? 直接在控制台删除, 立即生效。新建一把 key 在客户端轮换即可。历史用量仍记在旧 key 名下。

最佳实践

  • 每个环境一把 key (dev / staging / prod 分开)。
  • 永远不要把 key 提到代码仓库。
  • 用环境变量或专用密管 (Vault / AWS Secrets Manager / Doppler 等)。
  • 在控制台配置用量告警, 尽早发现异常调用。