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.
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openaiConfigurar y enviar la solicitud
- Defina GETAPI_ONE_API_KEY en el entorno del proceso; no pegue la clave en el archivo.
- Cree el cliente con https://www.getapi.one/v1 como base_url.
- Sustituya el marcador de modelo destacado por un ID exacto del catálogo actual que declare Responses.
- Ejecute el script solo cuando acepte que la solicitud puede generar cargos.
- 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.
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
| Campo | Valor requerido |
|---|---|
| base_url | https://www.getapi.one/v1 |
| api_key | GETAPI_ONE_API_KEY del entorno del servidor |
| model | ID exacto del catálogo actual |
| method | client.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íntoma | Comprobación |
|---|---|
| 401 o error de autenticación | Copie de nuevo la clave ONE, confirme que está habilitada y verifique que la variable de entorno pertenece a este proceso. |
| 404 | Conserve exactamente un /v1 en base_url y use el método Responses solo con un modelo que declare ese endpoint. |
| Modelo no disponible o incompatible | Copie 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
- Recibir una respuesta por streamingGestione eventos del ciclo de vida SSE y resultados finales.
- Elegir un modeloAjuste la tarea al contrato del endpoint del catálogo.