Official site
00 / OVERVIEW
开始之前
CloudAIKey 是 AI API 服务平台。创建 API Key 后，可通过统一接口接入支持的模型与客户端。
API Key 相当于账户密码。请勿发送给他人、上传到公开仓库或写入公开截图。密钥泄露后，应立即删除并重新创建。
01 → 02 → 03
简单三步
沿着账户、密钥、请求这条路径完成配置。每一步都只保留真正需要的信息。
注册并登录
- 打开 CloudAIKey 注册页。
- 填写长期可用的邮箱，并设置不少于 6 个字符的安全密码。
- 有邀请码时填写；没有可留空。创建账户后前往 登录页。
建议将密码保存到可信的密码管理工具中。
获取额度并创建 API Key
登录后先在控制台确认余额、订阅或可用额度。有兑换码时，可进入“兑换”页面完成兑换。
随后进入“API 密钥”页面创建密钥。使用容易识别的名称，例如 Codex-Mac，并按实际用途设置配额上限。
密钥通常只完整显示一次。创建后立即复制并妥善保存。
填写连接配置
Base URL
https://api.cloudaikey.com
API Key
填写刚创建的密钥，不要添加空格或引号。
Model
从控制台复制准确的模型 ID，不要猜测。
不同客户端可能自动补全 /v1，也可能要求完整路径。遇到 404 时，先检查是否重复或遗漏了 /v1。
CLIENT / OPENAI-COMPATIBLE
配置 Codex 或兼容客户端
在支持自定义 OpenAI API 的客户端中，填写 CloudAIKey 地址、密钥与控制台提供的模型 ID。字段名也可能显示为“API Endpoint”或“自定义接口地址”。
环境变量 · bash
export OPENAI_BASE_URL="https://api.cloudaikey.com/v1"
export OPENAI_API_KEY="你的_API_Key"如果客户端会自动拼接 /v1，Base URL 请改为 https://api.cloudaikey.com，避免形成重复路径。
TEST / REQUEST
手动 API 调用
用以下请求验证网络、密钥和接口是否可用。请将密钥、模型 ID 与请求字段替换为控制台当前支持的内容。
Anthropic Messages 兼容请求
curl https://api.cloudaikey.com/v1/messages \
-H "x-api-key: 你的_API_Key" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "控制台中的模型_ID",
"max_tokens": 256,
"messages": [{"role": "user", "content": "你好"}]
}'OpenAI Chat Completions 兼容请求
curl https://api.cloudaikey.com/v1/chat/completions \
-H "Authorization: Bearer 你的_API_Key" \
-H "Content-Type: application/json" \
-d '{
"model": "控制台中的模型_ID",
"messages": [{"role": "user", "content": "你好"}]
}'若某个兼容接口或字段未开放，请以控制台显示的最新说明为准。
TROUBLESHOOTING
常见问题
先根据 HTTP 状态码定位问题，通常比反复修改客户端配置更快。
401 · 未授权
检查 API Key 是否完整、是否带入多余空格，以及客户端要求的是 Bearer Token 还是独立的 API Key 字段。必要时重新创建密钥。
402 · 余额或配额不足
检查账户余额、订阅状态和密钥配额上限。如果额度已经用完，请先补充额度或联系售后。
404 · 接口路径不存在
通常是 Base URL 路径错误。检查客户端是否自动拼接 /v1，避免重复或遗漏。
429 · 请求过于频繁
降低并发和请求频率，稍后重试。持续出现时，记录请求时间、模型 ID 和错误信息并联系售后。
提示模型不存在或不可用
从控制台复制准确的模型 ID，并确认该模型当前可用。不要直接把“Claude”“GPT”等品牌名当作模型 ID。
客户端连接成功但没有正常回复
检查所选协议是否与模型匹配、请求格式是否正确，以及客户端是否发送了平台暂不支持的参数。
SUPPORT / TELEGRAM
带着有效信息反馈
连接、额度或模型可用性问题，请通过唯一社群入口联系 CloudAIKey。
加入 Telegram：@Cloudaikey ↗
反馈时提供下面的信息，有助于更快定位问题。发送前务必隐藏 API Key、邮箱等敏感内容。
- 客户端名称与版本
- 控制台中的模型 ID
- 请求发生的准确时间
- HTTP 状态码
- 完整错误文本