API 开放文档
统一网关 OpenAI 兼容接口 · Bearer 令牌鉴权 · SSE 流式 · Token 按量计费
总体架构
总出口 → 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上游渠道异常稍后重试或联系平台运维