Enviar una solicitud API de GetAPI.ONE

Requisitos previos y límites

• Una clave limitada de GetAPI.ONE almacenada en GETAPI_ONE_API_KEY.
• Un modelo actual del catálogo que incluya explícitamente el tipo de endpoint que desea llamar.
• Una línea de comandos con curl instalado y conexiones HTTPS salientes permitidas hacia www.getapi.one.
• Aceptar que una solicitud real puede generar cargos de uso. Los ejemplos se revisaron sin enviar solicitudes a modelos.

• Crear y cargar una clave
• Elegir un modelo compatible con el endpoint

1. Elegir el endpoint declarado

Otras familias de protocolos usan rutas y cuerpos diferentes. Siga el endpoint de la página del modelo seleccionado; no adapte las llamadas Anthropic, Gemini, de imagen o vídeo a los dos ejemplos anteriores.

2. Ejemplo de la API Responses

Úselo solo tras elegir un modelo del catálogo con el endpoint Responses. Sustituya YOUR_RESPONSES_MODEL antes de ejecutarlo.

curl --fail-with-body https://www.getapi.one/v1/responses \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "Reply with the word ready."
  }'

3. Ejemplo de Chat Completions

Úselo únicamente si el modelo seleccionado del catálogo incluye el endpoint OpenAI Chat. Sustituya YOUR_CHAT_MODEL antes de ejecutarlo.

curl --fail-with-body https://www.getapi.one/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with the word ready."}
    ]
  }'

4. Comprobar el resultado

1. Lea primero el estado HTTP. Un estado 2xx indica que la pasarela aceptó y completó la solicitud HTTP, pero el cliente aún debe revisar el objeto de respuesta para verificar la salida esperada.
2. Para Responses, revise la estructura de estado y salida devuelta. Para Chat Completions, revise la estructura choices. No suponga que ambos protocolos tienen el mismo formato de respuesta.
3. Abra el registro de solicitudes o uso de GetAPI.ONE y coteje hora, endpoint, modelo e identificador de solicitud cuando esté disponible.

Streaming y reintentos

El streaming cambia el transporte de respuesta y el manejo de eventos; su compatibilidad depende del endpoint y modelo elegidos. Empiece sin streaming y consulte la referencia del protocolo y la página del modelo antes de añadir parámetros stream.

• No reintente automáticamente errores de autenticación, cuota, permisos o selección de modelo.
• Antes de reintentar tras un tiempo de espera agotado o fallo del proveedor, determine si la solicitud original pudo procesarse y si es seguro repetir la operación.
• Limite los reintentos y aplique esperas progresivas en las aplicaciones; conserve identificadores de solicitud y marcas de tiempo para el diagnóstico.

Ramas de error

• Lista de resolución de problemas
• Preparar un informe de asistencia