# 模型提供商与试用密钥

此类别中的每个代码：其含义、最常见的原因、应如何处理以及由谁处理。

[全部错误代码](https://www.azothos.ai/zh/docs/errors)

### `provider_key_rejected`

- **含义**: 模型提供商拒绝了您输入的 API 密钥，因此未保存。
- **最常见的原因**: 密钥已在提供商处撤销、复制不完整，或来自另一个账户或项目。
- **如何处理**: 提供商拒绝了此 API 密钥，因此未保存。请从提供商控制台重新复制 — 该密钥可能已被撤销或不完整。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_permission_denied`

- **含义**: 模型提供商接受了工作区的 API 密钥，但拒绝了此次调用（HTTP 403）。
- **最常见的原因**: 密钥所属账户或项目无权访问该模型、该模型在其区域不可用，或密钥缺少调用所需的权限（受限或只读密钥）。
- **如何处理**: 提供商接受了密钥，但拒绝了此次调用：该密钥所属账户或项目无权在此区域使用该模型，或缺少所需权限。请在提供商控制台授予访问权限，或改用其他模型 — 更换密钥无济于事。
- **由谁处理**: 工作区的所有者或管理员

### `provider_key_unusable`

- **含义**: 输入的内容不是提供商接受用于调用模型的 API 密钥，因此未保存。
- **最常见的原因**: 使用了管理员密钥或订阅的登录令牌（聊天应用、编程工具），而非标准 API 密钥；或复制的密钥内部含有空格、换行或其他字符。
- **如何处理**: 这不是可用于调用模型的 API 密钥，因此未保存 — 可能是管理员密钥、登录令牌，或复制时混入了空格、换行或多余字符。请在提供商控制台创建一个标准 API 密钥，并单独粘贴。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_key_storage_unavailable`

- **含义**: Azoth 无法加密该密钥，因此未将其存储：此部署目前无法存储提供商密钥。
- **最常见的原因**: 部署端的配置问题 — 存储密钥的加密设置缺失或无效 — 而不是密钥本身的问题。在 SaaS 之外，由部署的运维方修复。
- **如何处理**: 密钥未保存：此部署目前无法存储提供商密钥。您的密钥本身没有问题 — 请联系支持人员修复后再次保存。
- **由谁处理**: Azoth，或此部署的运营方

### `provider_not_connected`

- **含义**: 该调用发往的提供商在此工作区中没有 API 密钥。
- **最常见的原因**: 该提供商从未连接，或其密钥已被移除。
- **如何处理**: 此工作区未连接该提供商的 API 密钥。请在“设置 › 提供商与模型”中添加。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_model_not_found`

- **含义**: 提供商不提供此模型，或您的密钥无法使用它。
- **最常见的原因**: 模型名称输入错误或已下线，或您在该提供商处的账户无权访问该模型。
- **如何处理**: 提供商不提供此模型，或您的密钥无权使用。请检查模型名称或选择其他模型。
- **由谁处理**: 调用方代码的开发者

### `azure_config_required`

- **含义**: 对 Azure OpenAI 的调用未指明目标资源或部署，因此无法发送。
- **最常见的原因**: 请求中缺少 `azureEndpoint` 或 `azureDeployment` 字段，或者某条规则将调用路由到 Azure OpenAI，而调用方并未提供它们。
- **如何处理**: 调用 Azure OpenAI 必须指明其资源和部署：请随调用发送 azureEndpoint 和 azureDeployment。
- **由谁处理**: 调用方代码的开发者

### `azure_endpoint_not_allowed`

- **含义**: 对 Azure OpenAI 的调用所给的 `azureEndpoint` 不是 Azure OpenAI 主机，因此不会把工作区的密钥发给它。
- **最常见的原因**: 该端点指向其他主机、端口、用户名或普通 http——或 Azure 前面的代理。
- **如何处理**: Azure OpenAI 只能通过其自身的主机访问：请将 azureEndpoint 设为 https://<resource>.openai.azure.com（或您的 Azure AI services 主机）。
- **由谁处理**: 调用方代码的开发者

### `invalid_azure_deployment`

- **含义**: 对 Azure OpenAI 的调用所给的 `azureDeployment` 不是 Azoth 可以放入请求的部署名称。
- **最常见的原因**: 名称中包含 `/`、`?`、`..` 或空格，或超过 64 个字符。
- **如何处理**: Azure 部署名称只能包含字母、数字、点、连字符和下划线，最多 64 个字符：请按 Azure 显示的名称发送部署名。
- **由谁处理**: 调用方代码的开发者

### `endpoint_url_not_allowed`

- **含义**: 要求 Azoth 调用的地址——Ollama 基础 URL、审计导出目标、S3 端点——在发出任何请求之前即被拒绝：它不是公网地址。
- **最常见的原因**: 该地址位于私有网络、环回或链路本地范围，或解析到这些范围，或使用 http(s) 以外的协议；响应中的 `reason` 字段说明是哪一种。
- **如何处理**: Azoth 不会调用此地址：请提供公网 https 地址——不得是私有网络、环回或链路本地主机，也不得包含用户名。响应中的 reason 字段说明了被拒绝的原因。
- **由谁处理**: 调用方代码的开发者

### `ollama_endpoint_missing`

- **含义**: 此调用被拦截：此工作区没有 Ollama 地址。
- **最常见的原因**: 网关只在工作区于“设置 › 提供商与模型”中保存的地址调用 Ollama，而目前没有保存任何地址。
- **如何处理**: 请所有者或管理员在“设置 › 提供商与模型”中保存您的 Ollama 服务器地址，然后重新发送调用。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=providers)

### `ollama_endpoint_not_declared`

- **含义**: 此调用被拦截：它指定的 Ollama 地址并非此工作区保存的地址。
- **最常见的原因**: 网关只在“设置 › 提供商与模型”中保存的地址调用 Ollama；调用中的 ollamaBaseUrl 是另一个地址。
- **如何处理**: 请从调用中去掉 ollamaBaseUrl，或发送与保存地址完全相同的地址。如需使用其他服务器，请所有者或管理员在该处保存其地址。
- **由谁处理**: 调用方代码的开发者 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_rate_limited`

- **含义**: 提供商因速率限制或您在其处账户的额度限制而拒绝了该调用。
- **最常见的原因**: 短时间内调用过多，或在该提供商处已无可用额度。
- **如何处理**: 提供商拒绝了该调用：已达速率限制或您在该提供商的账户余额不足。请检查您在提供商处的套餐和账单后重试。
- **由谁处理**: 工作区的所有者或管理员

### `provider_payment_required`

- **含义**: 模型提供商因账单原因拒绝了该调用（HTTP 402，或其错误表明为此类拒绝）。
- **最常见的原因**: 工作区 API 密钥所属的提供商账户已无余额、付款方式失败或过期、已达到支出上限，或其套餐已被取消。
- **如何处理**: 提供商因账单原因拒绝了该调用：此工作区密钥所属的提供商账户已无余额、没有有效的付款方式，或已达到支出上限。请在提供商控制台充值、处理账单问题或提高上限，然后重新发送调用。
- **由谁处理**: 工作区的所有者或管理员

### `provider_request_too_large`

- **含义**: 模型提供商拒绝了该调用，因为请求超出了它对该模型可接受的大小（HTTP 413）。
- **最常见的原因**: 单次调用中的消息过多或过长，或附件过大。
- **如何处理**: 提供商拒绝了该调用：请求超出了它对此模型可接受的大小。请减少消息或附件的数量，或缩短消息，然后重新发送调用。
- **由谁处理**: 调用方代码的开发者

### `provider_request_rejected`

- **含义**: 模型提供商未处理便拒绝了该调用（HTTP 400、422 或其他 4xx），重试无法解决该原因。
- **最常见的原因**: 最常见的是提供商账户余额耗尽——部分提供商此时会以 400 拒绝所有调用——其次是模型不接受的参数：某个选项、消息格式，或消息超出模型的上下文长度。
- **如何处理**: 提供商拒绝了该调用，在原因解决之前重试无济于事。请先在提供商控制台检查此工作区密钥所属账户的余额和账单——部分提供商在账户余额耗尽时会以这种方式拒绝所有调用——再检查调用的参数：模型选项、消息的格式和长度。
- **由谁处理**: 工作区的所有者或管理员

### `provider_not_supported`

- **含义**: 此调用被阻止：一条规则将其发送到此端点无法访问的提供商。
- **最常见的原因**: 您工作区的一条规则将此调用重定向到 ‹提供商›，而此端点不支持该提供商。
- **如何处理**: 请使用 /api/v1/chat 端点，或请规则负责人更改其重定向目标。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/regles?tab=rules)

### `provider_failure`

- **含义**: 提供商没有响应。
- **最常见的原因**: 模型提供商返回了错误。Azoth 没有收取任何费用。
- **如何处理**: 请重试，或选择其他模型。
- **由谁处理**: 调用方代码的开发者

### `onboarding_no_provider`

- **含义**: 此次首次调用未发送：工作区尚未连接任何模型提供商。
- **最常见的原因**: 首次调用会使用您自己的密钥发送到您自己的提供商——没有密钥，Azoth 不会发送任何调用。
- **如何处理**: 请在“设置 › 提供商与模型”中（或在本页的表单中）连接一个提供商，然后重新发送。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_exhausted`

- **含义**: Azoth 试用密钥已不再响应此工作区的调用。
- **最常见的原因**: 其试用调用次数已用完：试用密钥用于首次试用，而非日常使用。
- **如何处理**: 请在“设置 › 提供商与模型”中连接您自己的提供商密钥：之后您的调用仍会像以前一样经过 Azoth。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_unavailable`

- **含义**: Azoth 试用密钥无法响应此调用。
- **最常见的原因**: 试用密钥仅服务于 Free 或试用中的工作区，受所有工作区共享的每日上限约束，且仅在 Azoth 自身的 AI 运行时可用。
- **如何处理**: 请在“设置 › 提供商与模型”中连接您自己的提供商密钥，或稍后再试。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_limits_exceeded`

- **含义**: 此调用超出了 Azoth 试用密钥的响应范围。
- **最常见的原因**: 试用密钥只响应发往其唯一模型的、不使用流式传输的简短调用。
- **如何处理**: 请发送更短、不使用流式传输且发往试用模型的调用，或在“设置 › 提供商与模型”中连接您自己的提供商密钥。
- **由谁处理**: 调用方代码的开发者 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_not_eligible`

- **含义**: Azoth 试用密钥仅提供给使用 Free 套餐或处于试用期的工作区。
- **最常见的原因**: 该工作区使用的是付费套餐。
- **如何处理**: Azoth 试用密钥仅适用于 Free 或试用中的工作区。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_already_used`

- **含义**: 每人只能使用一次 Azoth 试用密钥。
- **最常见的原因**: 您已在另一个工作区开启过它。
- **如何处理**: 您已在另一个工作区使用过 Azoth 试用密钥。请在“设置 › 提供商与模型”中连接您自己的提供商密钥。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=providers)

### `egress_blocked`

- **含义**: 此调用被拦截：此部署无法访问 ‹提供商›。
- **最常见的原因**: 此 Azoth 在无互联网访问的环境中运行，只能访问其运维方允许的主机，而 ‹提供商› 不在其中。
- **如何处理**: 请使用部署内部托管的模型，或询问运维方是否应允许 ‹提供商›。此设置属于部署配置，而不是规则。
- **由谁处理**: 调用方代码的开发者

### `secnumcloud_blocked`

- **含义**: 此调用被拦截：该提供商未获得 SecNumCloud 认证。
- **最常见的原因**: 此部署只允许使用获得 SecNumCloud 认证的提供商，而 ‹提供商› 不在其中。
- **如何处理**: 请使用下方提供的认证提供商。此设置属于部署配置，而不是规则。
- **由谁处理**: 调用方代码的开发者
