FIRST SUCCESSFUL CALL
用一个 Key 完成首次调用
目标不是“配置看起来正确”，而是拿到一次 HTTP 200，并在 CDAPI 使用日志中看到对应请求。通常需要 3 到 5 分钟。
本页目录
开始前
准备好以下三项再发送请求，能避开绝大多数首次接入错误。
sk- 开头，状态为启用。
STEP 1
创建 API Key
打开令牌管理
登录控制台后进入 令牌管理，选择“创建令牌”。
选择正确分组
先在 模型广场确认目标模型对应的可用分组，再创建令牌。不要靠模型名称猜分组。
复制并妥善保存
完整复制 sk-...。请求头只放 Key
本身，不要把示例中的中文占位符带入真实请求。
截图、工单和日志中只保留前后少量字符。怀疑泄露时立即禁用旧 Key 并创建新 Key。
STEP 2
选择 Base URL
端点取决于任务，不取决于模型品牌。首次文本调用先使用标准端点。
| 任务 | Base URL | 何时使用 |
|---|---|---|
| 标准 | https://ai.bycomet.cc/v1 |
文本、流式、Responses、Embeddings 与常规工具调用 |
| Direct | https://api-direct.ai.bycomet.cc/v1 |
长任务、图像、视频，或标准端点发生网关超时 |
| Anthropic 客户端 | https://ai.bycomet.cc |
客户端会自行追加 /v1/messages 时 |
客户端要求 Base URL 时通常填到 /v1；只有直接发送
HTTP 请求时才追加 /chat/completions 等资源路径。
STEP 3
获取可用模型 ID
从模型广场复制完整模型名，或用当前 Key 读取模型目录。模型 ID 区分字符，不要自行缩写。
export CDAPI_API_KEY="sk-你的令牌"
curl https://ai.bycomet.cc/v1/models \
-H "Authorization: Bearer $CDAPI_API_KEY"
Windows PowerShell 可先执行
$env:CDAPI_API_KEY="sk-你的令牌"，并在请求头中使用
$env:CDAPI_API_KEY。
STEP 4
发送首次请求
把 YOUR_MODEL_ID 替换为上一步返回的完整模型
ID。先关闭流式输出，减少首次排查变量。
curl https://ai.bycomet.cc/v1/chat/completions \
-H "Authorization: Bearer $CDAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"messages": [
{"role": "user", "content": "只回复 ok"}
],
"stream": false
}'保留原始状态码和错误体，按 通用诊断顺序逐项验证 Key、URL、模型与分组。
ACCEPTANCE
验收首次调用
以下三项同时成立，才算接入完成。
- HTTP 状态码为
200，响应正文包含模型输出。 - 使用日志出现同一时间的请求记录，模型名与请求一致。
- 日志中没有重试耗尽、上游错误或异常高延迟。
接下来把同一组 Key、Base URL 和模型 ID 写入客户端，或直接进入完整 API 参考。
视频教程
需要跟着界面操作时，可播放现有的完整接入演示。