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 白名单与到期时间。
  • 密钥创建、停用、费率变更与人工入账全部写入审计日志。
当前阶段:计量内测。 接口、计量口径与结算流程在正式开放前可能调整。正式开放时间取决于备案与经营性资质进度,暂不承诺日期。