API 通用规则

本节说明 Genesis 模型 API 与 Product API 之间可以共享的客户端处理方法。它不会覆盖两类 API 的认证差异，也不替代具体接口的参数和响应参考。

建议阅读顺序

1. 从服务地址与环境确认正在调用 Genesis 还是 Product API，并正确拼接接口地址。

2. 按身份认证选择凭据、认证 Header 和 Product 工作区作用域。

3. 使用请求与响应格式判断响应属于 Product 包络、Genesis 原生对象、JSON-RPC、SSE 还是文件流。

4. 调用列表或执行类接口时，按分页、异步任务与幂等继续读取结果并避免重复写入。

5. 请求失败后，先按状态码与错误码分类，再决定是否使用限流与重试中的恢复策略。

6. 发布和升级客户端前，检查版本与兼容性。

页面职责

页面	解决的问题
服务地址与环境	怎样选择和拼接 Base URL，以及切换环境时需要一起更新哪些值。
身份认证	Genesis 与 Product API 分别使用什么凭据、Header 和作用域。
请求与响应格式	怎样构造 JSON、上传或流式请求，并选择正确的响应解析方式。
分页、异步任务与幂等	怎样继续翻页、跟踪任务，并处理超时和重复提交。
状态码与错误码	怎样结合 HTTP、业务包络和协议对象判断错误。
限流与重试	哪些请求可以重试，以及怎样设置有边界的等待策略。
版本与兼容性	怎样保持地址、协议和 SDK 版本一致，并安全升级客户端。

需要准确的方法、路径、参数和响应字段时，请进入 Genesis 模型 API或 Product API 的对应接口页。

最后更新于 2026 年 8 月 14 日