Crea una CLI de gateway en Python

​

Proyecto de ejemplo

• GitHub: examples/gateway-python-quickstart
• Ruta local del repositorio: examples/gateway-python-quickstart

​

Qué hace esta aplicación

• admite rutas de control como:
  • GET /v1/health
  • GET /v1/models
  • GET /v1/providers
• admite rutas de generación como:
  • POST /v1/responses
  • POST /v1/chat/completions
  • POST /v1/embeddings
  • y varios endpoints adicionales

​

Por qué sirve este ejemplo

• una referencia centrada en Python sin dependencias de terceros
• datos de solicitudes y manejo de respuestas explícitos
• un patrón práctico para workers, scripts y herramientas internas

​

Requisitos previos

• Python 3
• una clave de API de Phaseo

​

Ejecuta el ejemplo

cd examples/gateway-python-quickstart
cp .env.example .env.local

• PHASEO_API_KEY

python quickstart.py smoke
python quickstart.py responses --prompt "Return exactly: integration_ok"
python quickstart.py --help

​

Comprueba el resultado

• El modo de prueba rápida confirma que se puede acceder a la API.
• El comando Responses imprime integration_ok.
• --help muestra los comandos disponibles sin enviar una solicitud.
• Los errores de autenticación y de la API se muestran claramente en la terminal.

​

Qué revisar en el código

• cómo se carga el entorno
• cómo la CLI distribuye los comandos
• cómo se construyen los distintos datos de las solicitudes
• cómo se gestionan por separado las rutas asíncronas de vídeo y música y las rutas de texto de una sola respuesta

​

Adáptalo a tu caso

• elimina los endpoints que tu servicio no necesite
• usa una única función auxiliar para las solicitudes en vez de duplicar las cabeceras
• pásate al SDK de Python si más adelante quieres un cliente de nivel superior

​

Guías relacionadas

• Prompts iniciales para miniaplicaciones
• Envía JSON estructurado desde Python
• Ejemplos