主题
Cloud AI 使用文档
从创建密钥到发出第一个请求,按本页步骤即可完成接入。
API 端点
https://cloud.examplea.xyz开始前
请先登录 Cloud AI,在“API 密钥”页面创建密钥并选择所需分组。文档中的 sk-your-key 只是占位符,请替换为自己的密钥,不要把密钥发给他人。
三步开始
1. 创建密钥
进入 Cloud AI 控制台,点击“创建密钥”,填写名称并选择分组。 一个密钥对应一个分组;调用时可使用该分组支持的模型。
2. 检查可用模型
bash
curl https://cloud.examplea.xyz/v1/models \
-H "Authorization: Bearer sk-your-key"1
2
2
返回列表中的模型名称可以直接用于请求中的 model 字段。
3. 发出请求
bash
curl https://cloud.examplea.xyz/v1/chat/completions \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [
{"role": "user", "content": "你好,请用一句话介绍自己"}
],
"stream": false
}'1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
常用入口
API 密钥创建、复制、分组和安全使用分组与模型根据协议、稳定性和价格选择渠道Claude Code配置 Anthropic Messages 兼容接口Codex CLI配置 Responses API 自定义提供商API 参考鉴权、端点、请求格式和返回结构疑难解答快速定位认证、限流和上游错误
协议支持
| 协议 | 接口 | 适用场景 |
|---|---|---|
| OpenAI Chat Completions | /v1/chat/completions | 通用聊天客户端与旧版 SDK |
| OpenAI Responses | /v1/responses | Codex CLI 与新式 Agent 客户端 |
| Anthropic Messages | /v1/messages | Claude Code 与 Anthropic SDK |
| Models | /v1/models | 查询当前密钥可调用的模型 |
服务状态
遇到请求异常时,先查看 渠道状态。状态页展示各分组的主动探测结果, “降级”表示接口仍可用但响应较慢,“错误”表示最近一次探测失败。