接入总览

Aikey365 的推荐接入顺序是：账户安全 → 创建独立 API Key → 确认协议与 Base URL → 获取当前模型 → 发起最小请求 → 接入 SDK 或客户端 → 查看用量日志。

1. 登录控制台

打开 Aikey365 控制台。账户相关功能可能包含密码、双因素认证、Passkey 和第三方登录绑定，具体以当前控制台为准。

2. 创建独立 API Key

进入 API Keys 创建一把新的 Key。建议每个环境和应用单独使用一把 Key，例如：

local-codex
staging-backend
production-api

这样可以独立查看用量、设置限制，并在单个凭证泄露时快速撤销。

3. 确认协议

场景	推荐 Base URL	典型端点
OpenAI 兼容	https://aikey365.com/v1	/chat/completions、/responses、/models
Anthropic Messages	https://aikey365.com	/v1/messages
Gemini 原生	https://aikey365.com	/v1beta/models/{model}:generateContent

客户端是否需要在 Base URL 中包含 /v1，取决于它是否会自行拼接路径。

4. 获取当前模型

curl https://aikey365.com/v1/models \
  -H "Authorization: Bearer $AIKEY365_API_KEY"

不要根据旧教程猜模型名，也不要把模型列表长期写死在业务代码中。

5. 发起最小请求

curl https://aikey365.com/v1/chat/completions \
  -H "Authorization: Bearer $AIKEY365_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "Reply with: connected"}]
  }'

先验证纯文本与最少参数，再逐步增加流式、工具调用、视觉输入或结构化输出。

6. 上线前完成四件事

• API Key 不进入前端代码或 Git 仓库。
• 模型 ID、Base URL 和超时策略做成配置。
• 对 429 和临时 5xx 使用受控退避，不盲目重复可能计费的请求。
• 保留请求时间、模型、状态码等诊断信息，但不要把完整 Key 和敏感内容写入日志。

下一步可阅读 API Key、模型、路由 和 错误处理。