GetAPI.ONE

使用 Python 调用 GetAPI.ONE

安装官方 OpenAI Python SDK，将其指向 ONE Base URL，发送一次受控的 Responses 请求，并在不把凭据写入源码的前提下验证结果。

准备项目与凭据

Python 3.10 或更高版本，以及一个虚拟环境。
一个已启用、设置了明确有效期与额度的 GetAPI.ONE API 密钥。
从当前目录复制一个明确声明 Responses 端点的模型 ID。

powershell

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openai

配置并发送请求

在进程环境中设置 GETAPI_ONE_API_KEY；不要把密钥粘贴进文件。
创建客户端，并将 https://www.getapi.one/v1 设为 base_url。
用当前目录中明确支持 Responses 的准确模型 ID 替换醒目的占位符。
仅在你接受该请求可能计费时运行脚本。
首次验证禁用 SDK 重试。只有在明确哪些操作可安全重复后，才添加有界且可观测的重试。

python main.py

import os
from openai import OpenAI

api_key = os.environ.get("GETAPI_ONE_API_KEY")
if not api_key:
    raise RuntimeError("Set GETAPI_ONE_API_KEY before running this program")

with OpenAI(
    api_key=api_key,
    base_url="https://www.getapi.one/v1",
    timeout=30.0,
    max_retries=0,
) as client:
    response = client.responses.create(
        model="<MODEL_ID_FROM_CURRENT_CATALOG>",
        input="Reply with one short readiness check.",
    )
    print(response.output_text)

理解调用契约

字段	所需值
base_url	https://www.getapi.one/v1
api_key	来自服务端环境的 GETAPI_ONE_API_KEY
model	当前目录中的准确 ID
方法	client.responses.create

验证预期结果

进程正常退出，且没有鉴权或端点错误。
response.output_text 包含请求的简短回答。
GetAPI.ONE 控制台中出现与该密钥匹配的请求或用量记录。

修复常见错误

现象	检查
401 或鉴权错误	重新复制 ONE 密钥，确认已启用，并核对环境变量确实传入当前进程。
404	base_url 中只保留一个 /v1，并仅对声明该端点的模型使用 Responses 方法。
模型不可用或不兼容	从当前目录重新复制准确 ID，不要推断别名。

保障接入安全

仅在可信服务端或本地工具代码中运行 SDK，绝不要放进浏览器 JavaScript。
从版本控制中排除 .env；密钥一旦暴露应立即轮换。
开发与生产使用不同且额度受限的密钥。

下一步

流式接收响应处理 SSE 生命周期事件与终止结果。
选择模型让任务匹配目录中的端点契约。