Saltar al contenido principal
Ejecuta una CLI de Python hecha solo con la biblioteca estándar que llama a los endpoints de Phaseo, un comando cada vez. Al terminar tendrás python quickstart.py <command> funcionando para estado, modelos, Responses y Chat Completions, además de comandos para embeddings, moderación, imágenes, OCR, vídeo y música que puedes copiar en un worker o un backend. La CLI es ilustrativa: es una referencia de la forma de las solicitudes, no una herramienta empaquetada. Varios de los IDs de modelo predeterminados de los comandos multimedia ya no se sirven, así que pasa --model en esos casos (consulta Elige modelos para los comandos multimedia). Para que un agente de programación cree una CLI parecida desde cero, pega este prompt:

Crea una CLI de Gateway en Python en torno a las rutas de Phaseo.

Abrir en Cursor

Qué hace la CLI

El ejemplo es examples/gateway-python-quickstart: un solo archivo, quickstart.py, que usa solo urllib, json y argparse. Cada solicitud se reintenta dos veces ante 429, 5xx y errores de red, con esperas de 1 s y después 2 s, y agota el tiempo de espera a los 45 segundos. Cada comando termina con 1 cuando la llamada no devuelve 2xx, así que puedes usarlo en scripts.

Ejecútalo

Necesitas Python 3 y una clave de API de Phaseo.
1

Crea .env.local

El script lee .env.local desde la carpeta en la que lo ejecutas. El ejemplo no incluye .env.example, así que crea el archivo:
.env.local
Las variables que ya están definidas en tu shell tienen prioridad sobre el archivo. Sin PHASEO_MODEL, los comandos de texto usan openai/gpt-5.6-sol.
2

Ejecuta la comprobación rápida

smoke también envía una solicitud corta a Responses, así que consume algunos créditos.
3

Envía una solicitud

Comprueba que ha funcionado

  • smoke imprime HTTP 200 en todos los bloques y termina con 0.
  • La salida del comando responses contiene integration_ok.
  • --help lista los comandos sin hacer ninguna solicitud.
  • Sin clave, el script imprime Missing PHASEO_API_KEY y termina con 1.
  • Las solicitudes aparecen en Configuración → Uso → Registros.

Elige modelos para los comandos multimedia

Estos valores predeterminados de quickstart.py están retirados o no tienen ningún proveedor activo. Pasa un modelo actual con --model y elígelo en la página de modelos o con python quickstart.py models: Los valores predeterminados de embeddings (google/gemini-embedding-2) e image (openai/gpt-image-2) sí se sirven. Los trabajos de vídeo y música son asíncronos: guarda el ID devuelto y consulta el comando de estado; Vídeo asíncrono y lotes explica el ciclo de vida de los trabajos. Reduce el archivo a los comandos que necesita tu servicio, conserva el único helper compartido gateway_request() y pasa al SDK de Python cuando quieras solicitudes tipadas.
Última modificación el 5 de noviembre de 2026