GetAPI.ONE
Вызов GetAPI.ONE из Python
Установите официальный SDK OpenAI для Python, направьте его на базовый URL ONE, выполните контролируемый запрос Responses и проверьте результат, не помещая учётные данные в исходный код.
Подготовьте проект и учётные данные
- Python 3.10 или новее и виртуальная среда.
- Включённый API-ключ GetAPI.ONE с осознанно заданными сроком действия и квотой.
- Идентификатор модели из текущего каталога с заявленной конечной точкой Responses.
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.
- Запускайте скрипт, только если принимаете возможную оплату запроса.
- Первая проверка отключает повторы SDK. Добавляйте только ограниченные наблюдаемые повторы после определения операций, которые безопасно повторять.
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 | Точный идентификатор из текущего каталога |
| method | client.responses.create |
Проверьте ожидаемый результат
- Процесс завершается без ошибки аутентификации или конечной точки.
- response.output_text содержит запрошенный короткий ответ.
- В консоли GetAPI.ONE показана соответствующая ключу запись запроса или использования.
Исправьте распространённые ошибки
| Симптом | Проверка |
|---|---|
| 401 или ошибка аутентификации | Скопируйте ключ ONE заново, убедитесь, что он включён, и проверьте, что переменная окружения относится к этому процессу. |
| 404 | Сохраните ровно один /v1 в base_url и используйте метод Responses только для модели, поддерживающей эту конечную точку. |
| Модель недоступна или несовместима | Снова скопируйте точный идентификатор из текущего каталога; не предполагайте псевдонимы. |
Обеспечьте безопасность интеграции
- Запускайте SDK только в доверенном серверном или локальном инструментальном коде, но никогда в JavaScript браузера.
- Исключите файлы .env из контроля версий и немедленно ротируйте ключ при раскрытии.
- Используйте отдельные ограниченные ключи для разработки и продакшена.
Дальнейшие действия
- Передать ответ потокомОбрабатывайте события жизненного цикла SSE и конечные исходы.
- Выберите модельСопоставьте задачу с контрактом конечной точки каталога.