generativeaiapikey 的 OCI IAM 策略、一个特定区域的基础 URL,以及一个已配置的模型列表(在 API 密钥认证方式下,Oracle 的 /models 并不总是可用)。
1. 添加 OCI 策略
2. 配置
ORACLE_MODELS 是以逗号分隔的列表(会去除首尾空白)。其行为遵循全局的 CONFIGURED_PROVIDER_MODELS_MODE——fallback(默认)在 Oracle 的 /models 不可用或为空时使用该列表;allowlist
只公开已配置的模型,并跳过对上游的调用。
或在 config.yaml 中:
ORACLE_MODELS 会覆盖对应提供商在 YAML 中的 models:。
3. 运行 GoModel
4. 验证
GET /v1/models 会返回诸如 openai.gpt-oss-120b 之类的模型,并带有
owned_by: "oracle"。Responses API 的工作方式相同。
请使用足够高的
max_tokens 预算。某些基于 Oracle 的推理模型可能会在输出最终的助手文本之前,就把较短的补全额度耗费在推理内容上。多个 Oracle 提供商
使用带后缀的环境变量注册第二个 Oracle 实例:oracle-us。只有当自动生成的名称不合适,或者您需要按提供商覆盖弹性与容错设置时,才需要使用 YAML。
尚未集成
- 基于 OCI 原生的模型自动发现(届时将不再需要
ORACLE_MODELS/ YAMLmodels:)。 - 在 API 密钥认证方式下可靠地使用 Oracle 兼容 OpenAI 的
/models端点。
故障排查
404 Authorization failed or requested resource not found——缺少 OCI 策略、区域错误,或该账户无法使用该模型。model registry has no models——请设置ORACLE_MODELS或 YAMLmodels:。- OCI CLI 可以正常工作,但 Oracle Bearer 请求失败——两者使用的认证方式不同。 OCI CLI 使用 API 签名密钥;Oracle Generative AI 推理使用 Generative AI Bearer API 密钥。