澄明 API 开发者文档

通过统一接口调用 OpenAI、Anthropic、Google、xAI、DeepSeek、Moonshot、阿里通义与智谱模型。OpenAI SDK 兼容应用只需替换 Base URL 与 API Key。

BASE URL

身份验证

登录澄明 API 后，进入“API 密钥”页面，创建一个新密钥并立即复制保存。所有模型请求都通过该密钥鉴权；密钥仅应存放在服务端环境变量或密钥管理器中。

不要使用上游渠道密钥调用公开接口，也不要把任何密钥写入浏览器前端、公开仓库或聊天记录。

GET/v1/models

返回当前用户分组可用的模型列表。

POST/v1/chat/completions

OpenAI 兼容对话接口，覆盖绝大多数文本和多模态模型。

POST/v1/responses

适用于支持 OpenAI Responses 协议的模型。

POST/v1/messages

Anthropic Messages 原生兼容接口。

POST/v1beta/models/{model}:generateContent

Gemini 原生内容生成接口。

POST/v1/images/generations

图像生成接口。

请求体与 OpenAI Chat Completions 兼容。将 stream 设为 true 可获得 Server-Sent Events（SSE）流式响应；客户端应持续读取直到收到结束事件。

当前模型目录中标记为 openai-response 的模型可使用该端点。

支持 Anthropic 协议的 Claude 模型可直接调用。鉴权统一使用 Bearer 令牌。

模型名写入 URL 路径；请求仍通过统一 Bearer 令牌鉴权。

使用模型目录中标记为 image-generation 的模型。

列表实时读取澄明 API 的公开模型配置。展示价格为当前分组的参考价格，实际可用模型、结算金额与活动规则以模型广场和控制台账单为准。

模型	厂商	能力	输入 / 1M	输出 / 1M
正在读取模型配置…

模型价格会随上游成本、汇率与运营活动调整。调用前请在模型广场确认当前价格和所属分组；账单将按实际模型、输入输出 Token 或调用次数结算。

400

请求参数、模型名或端点格式不正确。

401

用户 API Key 缺失、错误或已失效。

403

当前分组无权访问该模型，或账号状态受限。

429

触发速率限制、额度不足或上游繁忙。按指数退避重试。

5xx

上游或网关暂时异常。保留响应中的 request id 便于定位。