API 与开发者
把法规能力接进你的系统
对外 API 处于计量内测阶段,只向受邀组织开放。当前不公开售卖,费率与结算方式在签约时确认。
能力清单
五类能力共用一套鉴权与计量。能力编号用于调用与对账,具体参数以正式接口文档为准。
| 能力 | 能力编号(规划) | 输入 | 输出 | 计量 |
|---|---|---|---|---|
| 法规与标准检索 | kb.search |
主题词、类型、编号 | 条目列表与命中片段 | 按次 |
| 条文速查 | law.article |
法规名或编号、条号 | 条文原文、章名、上下文 | 按次 |
| 注册路径报告 | report.nmpa |
产品信息、说明书或技术要求 | PDF 报告与结构化结论 | 按页 |
| 说明书解析 | doc.extract |
说明书文件 | 产品档案 JSON | 按次 |
| 行业模型问答 | model.chat |
问题、可选上下文 | 回答与引用来源 | 按千 token |
报告类能力按 PDF 实际页数计量;问答类按输入与输出 token 合计计量。能力编号与参数在正式开放前可能调整。
接入流程
内测阶段由人工开通,三步完成。
提交组织信息
企业名称、统一社会信用代码、使用场景与预计调用量。个人开发者可先用个人主体申请。
开通应用与 Key
一个组织可有多个应用,一个应用一把 Key。Key 只在创建时显示一次,服务端只存哈希。
联调与计量
先在测试环境联调,确认计量口径;正式调用后可在控制台查看每次记录与汇总用量。
计量与结算
- 计量以服务端记录为准,不接受客户端上报的数字。
- 失败、超时与被限流的请求不计费;同一幂等键的重试只记一次。
- 调用前校验余额或信用额度,成功后扣减;余额不足返回明确错误码,不产生半成功记录。
- 内测阶段默认预充值;年框客户可另行约定后付费与账期。
- 发票按实际消费金额开具,默认增值税普通发票;专票按资质另行申请。
限流与错误
- 限流按应用与能力两级配置,按分钟与每日配额分别计算。
- 余额不足返回
402;额度或频率超限返回429;鉴权失败返回401。 429与5xx可按指数退避重试;4xx参数错误不建议原样重试。- 每个响应带请求编号,排障时提供该编号即可定位到调用记录。
安全
- Key 只存哈希,控制台不提供再次查看;泄漏后立即停用并新建。
- 支持按应用设置能力范围、来源 IP 白名单与到期时间。
- 密钥创建、停用、费率变更与人工入账全部写入审计日志。
当前阶段:计量内测。
接口、计量口径与结算流程在正式开放前可能调整。正式开放时间取决于备案与经营性资质进度,暂不承诺日期。