总体架构
总出口 → 32 省出口 → 个人 / 企业 API
中科融合算力网 API 体系采用「总出口 — 省出口 — 下游端点」三层架构:全平台以统一网关总出口
/v1 对外提供服务(OpenAI 兼容协议、令牌鉴权、统一计费);
请求按令牌归属路由至 32 个省级出口,每省拥有独立的调用量统计与省门户;
省出口之下挂靠个人 / 企业 API 下游接入方,每方分配独立密钥、授权模型范围与日调用额度。
所有调用均以 Bearer 令牌鉴权,并按 Token 用量(quota = prompt + completion × 3)逐次计费扣减。
| 层级 | 说明 | 管理入口 |
|---|---|---|
总出口 /v1 全平台唯一 API 入口 |
OpenAI 兼容协议 · 令牌鉴权 · 统一计费 | 平台管理员 |
省出口 每省一个逻辑出口 |
/v1 + 省令牌,独立调用量统计与省门户 | 用户门户(login.html 登录)自助查看 |
个人 / 企业 API 下游接入方 |
令牌绑定端点,独立密钥与额度,超限自动拒绝 | 平台管理员 + 省门户可见 |
快速开始 · curl
# 对话补全(非流式)
curl -X POST https://www.cas-icpn.cn/v1/chat/completions \
-H "Authorization: Bearer sk-zkrh-xxxx" \
-H "Content-Type: application/json" \
-d '{"model":"qwen3.5:0.8b","messages":[{"role":"user","content":"介绍一下中科融合算力网"}]}'
# 流式(SSE):请求体中加 "stream": true,逐块返回 data: {...},结尾 data: [DONE]
# 测试环境:https://ddzx.aisdmp.cn/v1(协议与正式环境完全一致)
令牌请替换为「令牌管理」或省门户签发的 sk-zkrh-xxx · 模型全量见 GET /v1/models
快速开始 · Python(OpenAI SDK)
from openai import OpenAI
# base_url 指向本站统一网关 /v1(测试环境:https://ddzx.aisdmp.cn/v1)
client = OpenAI(
base_url="https://www.cas-icpn.cn/v1",
api_key="sk-zkrh-xxxx", # 平台签发的网关令牌
)
# 非流式
resp = client.chat.completions.create(
model="qwen3.5:0.8b",
messages=[{"role": "user", "content": "介绍一下中科融合算力网"}],
)
print(resp.choices[0].message.content)
# 流式(SSE)
stream = client.chat.completions.create(
model="qwen3.5:0.8b",
messages=[{"role": "user", "content": "你好"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")
兼容 openai>=1.x SDK,无需额外适配;用量与计费自动计入所属省出口与绑定端点
接口清单
OpenAI 兼容 · JSON · SSE
| 方法 | 端点 | 功能 | 说明 |
|---|---|---|---|
| POST | /v1/chat/completions | 对话补全 | 支持 stream(SSE 流式);按模型路由渠道,逐块返回直至 data: [DONE] |
| GET | /v1/models | 模型列表 | 返回当前令牌可调用的模型并集(OpenAI 兼容格式) |
鉴权方式
Authorization: Bearer sk-zkrh-xxx
计费口径
quota = prompt + completion × 3
错误体格式
{"error":{"message":"…","type":"invalid_request_error"}}
错误码
调用异常处理建议
| HTTP | 说明 | 处理建议 |
|---|---|---|
| 401 | 令牌缺失 / 无效 / 已停用 | 核对 Bearer 令牌是否正确且处于启用状态 |
| 403 | 无权限(模型不在令牌白名单) | 联系平台管理员调整令牌授权模型范围 |
| 429 | 额度不足(quota 用尽) | 申请提额或更换令牌 |
| 502 | 上游渠道异常 | 稍后重试或联系平台运维 |