快速开始

用最短路径完成注册、创建 Key、选协议并发出第一条请求。通常 5 分钟内完成。

1. 注册并进入控制台

1. 打开 注册页面 创建账号（新用户送 $10 体验金）；
2. 登录控制台；
3. 在「钱包」确认余额或体验金已到账。

2. 创建 API Key

进入 API 密钥，点「创建」：

1. 起一个能认出用途的名字，例如 local-codex、backend-dev；
2. 按需选择模型分组（不同分组可用模型与价格不同）；
3. 建议设置额度上限与过期时间；
4. 创建后立即复制 sk- 开头的 Key。

3. 选择协议与 Base URL

4. 从模型广场复制模型 ID

打开 模型广场，选择模型并复制完整 ID（如 claude-sonnet-4-6、gpt-5.6-sol）。下面示例里的 YOUR_MODEL_ID 必须替换成实际模型 ID。

5. 发送第一条请求

OpenAI 协议

curl https://console.bloomai.vip/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "只回复 pong"}]
  }'

Anthropic 协议

curl https://console.bloomai.vip/v1/messages \
  -H "x-api-key: sk-你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "只回复 pong"}]
  }'

Gemini 协议

curl "https://console.bloomai.vip/v1beta/models/gemini-3-flash:generateContent" \
  -H "x-goog-api-key: sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"只回复 pong"}]}]}'

6. 确认接入成功

• HTTP 状态码为 200；
• 响应里包含模型输出内容；
• 流式请求能持续收到事件；
• 控制台「用量日志」能看到本次请求的模型、Token 与费用。

如果失败，按顺序排查：

1. Key 是否完整、有效、未过期（sk- 开头）；
2. Base URL 是否与协议匹配（见第 3 步）；
3. 模型 ID 是否准确、Key 分组是否允许访问该模型；
4. 余额或 Key 额度是否足够；
5. 对照 错误码 定位。

下一步