GetAPI.ONE

将 OpenAI SDK 接入迁移到 GetAPI.ONE

盘点现有请求契约，通过配置切换凭据与 Base URL，映射准确的 ONE 目录模型，对新旧路径做灰度验证并保留回滚。

切换流量前盘点

text

Keep unchanged: request semantics → validation → output parsing
Change by configuration: API key + base URL + verified model mapping

将 Provider URL、密钥与模型映射移入环境配置。
将 Python base_url 或 Node.js baseURL 设为 https://www.getapi.one/v1，并使用 GETAPI_ONE_API_KEY。
保留现有端点族。只移除确实可选且不必要的字段；如果必需行为不受支持，应停止迁移并选择兼容模型或路径。
使用相同的获批 Fixture，在受控灰度中同时运行新旧路径。
仅在质量、错误、延迟与观测成本达到验收标准后扩大流量。

python

client = OpenAI(
    api_key=os.environ["GETAPI_ONE_API_KEY"],
    base_url="https://www.getapi.one/v1",
    timeout=30.0,
    max_retries=0,
)

javascript

const client = new OpenAI({
  apiKey: process.env.GETAPI_ONE_API_KEY,
  baseURL: 'https://www.getapi.one/v1',
  timeout: 30_000,
  maxRetries: 0,
});

契约	迁移检查
端点	Responses 保持 Responses；Chat Completions 保持 Chat Completions，除非另行设计。
模型	映射到具有声明端点的准确当前目录 ID。
参数	逐一验证每个必需行为与可选字段；不要假设每个参数都能直接替换。
流式	验证事件名、终止结果、断连处理与代理行为。
错误与重试	保留请求 ID，避免重试产生重复副作用。