Ir al contenido
GetAPI
Español
Menú

GetAPI.ONE

Llamar a GetAPI.ONE desde Python

Instale el SDK Python oficial de OpenAI, apúntelo a la URL base ONE, haga una solicitud Responses controlada y verifique el resultado sin incluir credenciales en el código.

Preparar el proyecto y la credencial

  • Python 3.10 o posterior y un entorno virtual.
  • Una clave API GetAPI.ONE habilitada con caducidad y cuota deliberadas.
  • Un ID copiado del catálogo actual cuyo endpoint declarado sea Responses.
powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openai

Configurar y enviar la solicitud

  1. Defina GETAPI_ONE_API_KEY en el entorno del proceso; no pegue la clave en el archivo.
  2. Cree el cliente con https://www.getapi.one/v1 como base_url.
  3. Sustituya el marcador de modelo destacado por un ID exacto del catálogo actual que declare Responses.
  4. Ejecute el script solo cuando acepte que la solicitud puede generar cargos.
  5. La primera verificación desactiva reintentos del SDK. Añada solo reintentos limitados y observables después de decidir qué operaciones pueden repetirse con seguridad.
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)

Comprender el contrato

CampoValor requerido
base_urlhttps://www.getapi.one/v1
api_keyGETAPI_ONE_API_KEY del entorno del servidor
modelID exacto del catálogo actual
methodclient.responses.create

Verificar el resultado esperado

  • El proceso termina sin errores de autenticación ni endpoint.
  • response.output_text contiene la respuesta breve solicitada.
  • La consola GetAPI.ONE muestra un registro correspondiente de solicitud o uso de la clave.

Corregir errores habituales

SíntomaComprobación
401 o error de autenticaciónCopie de nuevo la clave ONE, confirme que está habilitada y verifique que la variable de entorno pertenece a este proceso.
404Conserve exactamente un /v1 en base_url y use el método Responses solo con un modelo que declare ese endpoint.
Modelo no disponible o incompatibleCopie nuevamente el ID exacto del catálogo actual; no deduzca alias.

Mantener segura la integración

  • Ejecute el SDK solo en código de servidor o herramientas locales fiables, nunca en JavaScript del navegador.
  • Excluya archivos .env del control de versiones y rote inmediatamente cualquier clave expuesta.
  • Use claves limitadas e independientes para desarrollo y producción.

Próximos pasos