快速开始

目标：用一枚独立的测试密钥，完成一次简单文本调用，并找到对应的消费记录。

1. 登录 COCO API

打开 COCO API，按页面提供的方式注册或登录。不要在不明链接中填写本站密码。

进入「钱包」确认有可用余额。支付入口未开放或无法完成付款时，先查看站内公告，不要自行向陌生账号转账。详见余额与计费。

2. 选择模型与分组

从顶部「模型广场」查看已启用模型，选择适合的分组，复制模型名称。留意该分组的输入、输出、缓存价格，以及接口类型。

本文不固定推荐某一个模型。模型名称需要替换为你在本站实际有权限使用的值。

3. 创建测试密钥

打开 API 密钥，点击创建，填写便于识别的名称，例如 first-test。按页面设置分组、额度和有效期。

保存后使用页面提供的复制操作获取密钥。不要把密钥放进截图、群聊或公开代码仓库。详细操作见API 密钥管理。

4. 先检查模型列表

下面示例适用于 macOS / Linux 的 shell。Windows PowerShell 用户可使用Python 示例，不要直接套用 shell 的环境变量语法。

先将 COCO_API_KEY 设置为你的密钥。示例中的占位符必须替换；正式项目应通过私密环境配置或密钥管理服务注入。

export COCO_API_KEY='YOUR_COCO_API_KEY'

curl --connect-timeout 10 --max-time 30 --fail-with-body \
  https://api.cocoapi.top/v1/models \
  -H "Authorization: Bearer ${COCO_API_KEY}"

正常响应通常包含 data 数组及模型 id。401 代表鉴权未通过，不是模型生成失败。能列出模型，也不代表其上游生成请求一定成功。

5. 发出小额度请求

将下面的 YOUR_MODEL_ID 替换为实际模型名称。此请求会产生模型用量，可能收费。

curl --connect-timeout 10 --max-time 120 --fail-with-body \
  https://api.cocoapi.top/v1/chat/completions \
  -H "Authorization: Bearer ${COCO_API_KEY}" \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "Reply with OK only."}],
    "max_tokens": 32,
    "stream": false
  }'

此示例使用 Chat Completions。若模型只支持 Claude Messages，改用对应协议示例。max_tokens 是否受支持由所选模型和协议决定；收到参数错误时按错误详情调整，不要无限重试。

6. 核对响应和账单

确认 HTTP 状态成功，并检查响应中的 choices[0].message。返回内容不一定逐字等于 OK；判断时也要查看错误信息和结束原因。

随后进入「使用日志」，按时间、密钥和模型查找这次请求，核对分组、Token 用量及扣费。必要时记录响应中的请求编号，用于反馈问题。

测试完成不等于全面兼容

一条短文本成功，只能说明该密钥、分组、模型和当前参数组合在当时可用。流式输出、长文本、工具调用等仍需要各自验证。

接下来可以配置客户端，或查看流式输出。