admin/Mdeical_Sur_Report
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 4 Wiki Activity

Align AI providers with current API docs

Browse Source
This commit is contained in:
admin
2026-05-11 18:14:56 +08:00
parent 91c7db0863
commit 0c8ea9135f
8 changed files with 155 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/api-contract.md
View File

@@ -541,8 +541,10 @@ pageSize?: number
- 请求上下文只能包含当前报告内容和当前报告内用户有权访问的图片/关键帧。
- 不允许跨部门检索报告作为上下文。
- 当前实现接收 OpenAI 兼容 `messages`、温度等参数，后端会用全局 Provider 的 `modelName` 覆盖请求中的 `model`，所有用户共用同一套 key。
- 报告编辑器 AI 写作请求会使用 OpenAI 兼容 JSON Mode：`response_format: { "type": "json_object" }`，同时在 prompt 中要求返回 JSON。
- Kimi 默认主模型为 `kimi-k2.6`；对 K2.6/K2.5 请求会移除不兼容的采样参数，并默认传入 `thinking: { "type": "disabled" }` 以适配报告生成的低延迟场景。
- Provider 可配置 `fallbackModelName` 作为备用模型；主模型在短暂重试后仍返回 `429/5xx` 或请求超时时，后端会自动改用备用模型再请求一次。
- 上游模型返回 `429/5xx` 等临时错误时，后端会对 `/chat/completions` 做短暂重试；无可用备用模型或备用模型仍失败时保留上游 HTTP 状态码，并通过错误码区分 `AI_PROVIDER_OVERLOADED`、`AI_PROVIDER_RATE_LIMITED`、`AI_PROVIDER_UNAVAILABLE`、`AI_PROVIDER_TIMEOUT` 或 `AI_PROVIDER_ERROR`。
- 上游模型返回过载、限流、`5xx` 等临时错误时，后端会对 `/chat/completions` 做短暂重试；无可用备用模型或备用模型仍失败时保留上游 HTTP 状态码，并通过错误码区分 `AI_PROVIDER_OVERLOADED`、`AI_PROVIDER_RATE_LIMITED`、`AI_PROVIDER_QUOTA_EXCEEDED`、`AI_PROVIDER_UNAVAILABLE`、`AI_PROVIDER_TIMEOUT` 或 `AI_PROVIDER_ERROR`。账户余额/额度不足不会触发重试或备用模型。
## Speech API