Перейти к содержимому
GetAPI
Русский
Меню

GetAPI.ONE

Вызов GetAPI.ONE из Python

Установите официальный SDK OpenAI для Python, направьте его на базовый URL ONE, выполните контролируемый запрос Responses и проверьте результат, не помещая учётные данные в исходный код.

Подготовьте проект и учётные данные

  • Python 3.10 или новее и виртуальная среда.
  • Включённый API-ключ GetAPI.ONE с осознанно заданными сроком действия и квотой.
  • Идентификатор модели из текущего каталога с заявленной конечной точкой Responses.
powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openai

Настройте и отправьте запрос

  1. Задайте GETAPI_ONE_API_KEY в среде процесса; не вставляйте ключ в файл.
  2. Создайте клиент с https://www.getapi.one/v1 в качестве base_url.
  3. Замените заметный заполнитель модели точным текущим идентификатором каталога, поддерживающим Responses.
  4. Запускайте скрипт, только если принимаете возможную оплату запроса.
  5. Первая проверка отключает повторы 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_urlhttps://www.getapi.one/v1
api_keyGETAPI_ONE_API_KEY из серверной среды
modelТочный идентификатор из текущего каталога
methodclient.responses.create

Проверьте ожидаемый результат

  • Процесс завершается без ошибки аутентификации или конечной точки.
  • response.output_text содержит запрошенный короткий ответ.
  • В консоли GetAPI.ONE показана соответствующая ключу запись запроса или использования.

Исправьте распространённые ошибки

СимптомПроверка
401 или ошибка аутентификацииСкопируйте ключ ONE заново, убедитесь, что он включён, и проверьте, что переменная окружения относится к этому процессу.
404Сохраните ровно один /v1 в base_url и используйте метод Responses только для модели, поддерживающей эту конечную точку.
Модель недоступна или несовместимаСнова скопируйте точный идентификатор из текущего каталога; не предполагайте псевдонимы.

Обеспечьте безопасность интеграции

  • Запускайте SDK только в доверенном серверном или локальном инструментальном коде, но никогда в JavaScript браузера.
  • Исключите файлы .env из контроля версий и немедленно ротируйте ключ при раскрытии.
  • Используйте отдельные ограниченные ключи для разработки и продакшена.

Дальнейшие действия