灿培 API 基于统一的 OpenAI 兼容接口规范提供多模型接入服务。开发者仅需将原有应用的请求地址切换至灿培平台，并使用平台颁发的 API 令牌进行鉴权，即可通过统一的调用方式接入不同模型，无需针对单一模型进行重复适配。

本服务适用于智能对话、文本生成与改写、内容生产、智能客服、代码辅助等典型场景，并支持将 AI 能力集成至网站、应用程序及企业内部系统。平台所提供模型的种类、功能说明及定价信息均于模型广场实时发布，开发者在接入前请以模型广场公示信息为准进行选型。

开发者可通过以下三个步骤完成首次接口调用：

curl https://cplicity.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-您的令牌" \
  -d '{
    "model": "模型广场公示的模型名称",
    "messages": [
      { "role": "user", "content": "您好，请介绍一下您自己" }
    ]
  }'

调用成功后，接口将以 JSON 格式返回响应结果，模型回复内容位于 choices[0].message.content 字段。请求与响应的完整规范请参阅「接口说明」章节。

所有接口请求均须在请求头（Header）中携带 API 令牌进行身份认证，格式规范如下：

Authorization: Bearer sk-您的令牌

• 令牌管理：开发者可在 cplicity.com 控制台中完成令牌的创建、查询与删除操作。建议按项目分别创建独立令牌，以便于权限管理与问题排查。
• 安全要求：请勿将令牌置于公开代码仓库、前端代码、截图等可被第三方获取的环境中，亦不得向任何第三方披露。令牌一经泄露，第三方可能使用您的账户余额发起调用。
• 泄露处置：如怀疑令牌已经泄露，请立即在控制台删除该令牌并重新创建。原令牌删除后即时失效。
• 认证失败：未携带令牌或令牌信息不正确时，接口将返回 401 状态码。具体排查方式请参阅「错误码」章节。

接口基础地址（Base URL）为 https://cplicity.com，请求与响应格式遵循 OpenAI 兼容规范。对于基于 OpenAI SDK 或相关代码的既有应用，开发者仅需完成两项调整：将 Base URL 修改为 https://cplicity.com/v1，并将 API Key 替换为灿培平台令牌，即可完成接入。

请求参数（聊天接口）

响应示例

{
  "id": "chatcmpl-xxxxxx",
  "object": "chat.completion",
  "model": "调用的模型名称",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "您好，我是……"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 42,
    "total_tokens": 60
  }
}

其中，usage 字段为本次调用的用量统计信息。平台将依据实际用量从账户余额中进行计费扣除。

通过 SDK 调用（Python 示例）

from openai import OpenAI

client = OpenAI(
    api_key="sk-您的令牌",
    base_url="https://cplicity.com/v1",
)

resp = client.chat.completions.create(
    model="模型广场公示的模型名称",
    messages=[{"role": "user", "content": "您好"}],
)
print(resp.choices[0].message.content)

其他编程语言的 OpenAI SDK 接入方式与上述示例一致，仅需修改 base_url 与 api_key 两项配置即可。

灿培平台提供覆盖对话、写作、代码、图像、音频、视频等场景的多类模型。各模型的名称及定价均以模型广场实时公示为准。本文档不提供固定价格清单；模型广场信息更新后即时生效，开发者应以实际调用时公示的定价为准。

• 模型选型：开发者可在模型广场按应用场景与定价进行筛选，并查阅各模型的功能说明与计费方式。
• 模型名称填写规范：调用时，model 参数须填写模型广场公示的模型名称，亦可通过 GET /v1/models 接口查询当前可用模型列表。
• 定价说明：不同模型采用各自的计费方式（例如按 Token 用量计费或按次计费），具体以模型广场标注为准。

访问模型广场，查阅全部模型及实时定价 →

灿培 API 采用按量计费模式。系统将依据所调用模型的计费方式统计实际用量，并从账户余额中据实扣除。

充值方式

1. 添加官方客服微信 Tree3412，并向客服说明拟充值金额及对应账户信息。
2. 按照客服指引完成付款操作。
3. 经确认收款后，平台管理员将为相应账户完成充值。余额到账后，服务即可恢复正常调用。

充值业务仅通过官方客服微信 Tree3412 受理。请勿通过任何非官方渠道进行付款，以避免造成资金损失。

消费查询

开发者可在控制台中查询账户余额及调用记录，每次调用的用量与扣费明细均可查阅。如发现用量异常，请优先核查令牌是否存在泄露风险，相关处置方式请参阅「认证」章节。

接口调用失败时，系统将返回相应的 HTTP 状态码。开发者可依据下表所列状态码含义及处理建议进行排查：