API 文档

按顺序完成下面几项，就能确认 API Key、网络和账号积分都可正常使用。

1. 创建 API Key

登录 Piccc AI，进入“个人中心 → API Key”，创建一枚密钥。

密钥以 pcc_live_ 开头，只在创建成功时完整显示一次。复制后保存在服务端环境变量或密钥管理服务中，不要写进网页、App、公开仓库或日志。

macOS 或 Linux：

export PICCC_API_KEY="pcc_live_xxxxxxxxxxxxxxxxxxxxxxxx"
export PICCC_API_BASE_URL="https://api.picccai.cn"

PowerShell：

$env:PICCC_API_KEY = "pcc_live_xxxxxxxxxxxxxxxxxxxxxxxx"
$env:PICCC_API_BASE_URL = "https://api.picccai.cn"

2. 检查账号和积分

curl "$PICCC_API_BASE_URL/v1/user" \
  -H "Authorization: Bearer $PICCC_API_KEY"

正常响应会包含账号、积分和会员信息：

{
  "id": "usr_xxx",
  "email": "user@example.com",
  "name": "User",
  "role": "user",
  "credits": 1200,
  "membership": {
    "level": "free",
    "active": false,
    "api_enabled": true,
    "expires_at": null
  }
}

所有会员等级都能使用开放 API。实际调用仍需要有效的 API Key、可用账号和足够积分。

3. 查看文本模型

curl "$PICCC_API_BASE_URL/v1/models" \
  -H "Authorization: Bearer $PICCC_API_KEY"

从响应的 data[].id 中选一个模型名称。模型由后台维护，可能随时启用、停用或改名，调用前不要依赖写死的名称。

{
  "object": "list",
  "data": [
    {
      "id": "YOUR_MODEL_NAME",
      "object": "model",
      "owned_by": "piccc-ai"
    }
  ]
}

4. 发起第一次对话请求

把 YOUR_MODEL_NAME 换成上一步返回的 data[].id：

curl "$PICCC_API_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $PICCC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_NAME",
    "messages": [
      {"role": "user", "content": "用一句话介绍 Piccc AI。"}
    ],
    "stream": false
  }'

文本接口会把请求交给所选模型的上游服务，并原样返回上游响应。不同模型的响应字段可能略有差异，客户端应按该模型实际返回的格式处理。

每个已鉴权请求的响应头都带有 X-Request-Id。遇到问题时保留这个值，排查会快很多。