接入文档 | 智汇 API

Base URL 与认证

Base URL: https://api.example.com/v1
认证方式: Authorization: Bearer vk-你的虚拟Key

Chat Completions

POST /v1/chat/completions，请求/响应与 OpenAI Chat Completions 一致，支持 messages、tools、stream 等参数。

{
  "model": "glm-4.5",
  "messages": [{"role": "user", "content": "你好"}],
  "stream": true
}

流式响应遵循 SSE 规范，最后一个 chunk 携带usage（我们始终向上游请求 include_usage），按 usage 精确计费。

Anthropic / Gemini 端点

平台同时提供 Anthropic 与 Gemini 兼容入口，供 Claude Code 及官方 SDK 直接对接（请求在入口侧转换为统一表示，模型名填平台在售模型）：

POST /v1/messages                          # Anthropic Messages（x-api-key 或 Bearer）
POST /v1/messages/count_tokens             # 上下文预估（本地估算，不计费）
GET  /v1/models                            # 在售模型列表（Anthropic 形状，兼容 OpenAI SDK）
POST /v1beta/models/{model}:generateContent[:streamGenerateContent]  # Gemini

Anthropic 入口支持 string 或 content blocks 数组、system、 temperature / max_tokens 透传（max_tokens 必填，与官方契约一致）；流式事件、错误形状与官方 API 一致。Claude Code 对接示例见快速开始第 4 步。

绑定渠道（渠道广场）

在「虚拟 Key 管理」创建渠道模式的 Key 并绑定目标渠道（勾选第三方风险协议）后，用该 Key 发起的请求直达渠道，按渠道自定倍率计费；渠道失败不自动回退平台供给，错误直达调用方。请求级 channel参数已退役，带上会返回 400 指路。

{
  "model": "deepseek-chat",
  "messages": [...]
}

错误码

401 虚拟 Key 无效或已过期
402 积分不足（预检失败，不扣费）
404 model_not_found 模型不在允许列表
429 触发限流
502 / 504 上游异常，自动重试后仍失败（不扣费，已记录流水）

计费说明

按平台价（官方 × 8 折）× 实际 usage 计费，输入/输出分价。失败请求不扣费；每笔调用可在「调用历史」查看账单明细与错误分类。