Pular para o conteúdo principal
Execute uma CLI em Python, só com a biblioteca padrão, que chama os endpoints do Phaseo um comando por vez. No fim, você tem python quickstart.py <command> funcionando para health, models, Responses e Chat Completions, além de comandos para embeddings, moderação, imagens, OCR, vídeo e música que você pode copiar para um worker ou backend. A CLI é ilustrativa: ela serve de referência para o formato das solicitações, não é uma ferramenta empacotada. Vários IDs de modelo padrão dos comandos de mídia não são mais atendidos, então passe --model nesses casos (veja Escolha modelos para os comandos de mídia). Para que um agente de programação crie uma CLI parecida do zero, cole este prompt:

Crie uma CLI do Gateway em Python com as rotas do Phaseo.

Abrir no Cursor

O que a CLI faz

O exemplo é examples/gateway-python-quickstart: um único arquivo, quickstart.py, que usa apenas urllib, json e argparse. Cada solicitação tenta de novo duas vezes em caso de 429, 5xx e erros de rede, com esperas de 1 s e depois 2 s, e expira após 45 segundos. Cada comando termina com 1 quando a chamada não retorna 2xx, então você pode usá-lo em scripts.

Execute

Você precisa do Python 3 e de uma chave de API do Phaseo.
1

Crie o .env.local

O script lê o .env.local da pasta em que você o executa. O exemplo não tem .env.example, então crie o arquivo:
.env.local
As variáveis já definidas no seu shell têm prioridade sobre o arquivo. Sem PHASEO_MODEL, os comandos de texto usam openai/gpt-5.6-sol.
2

Execute a verificação smoke

smoke também envia uma solicitação curta para Responses, então consome alguns créditos.
3

Envie uma solicitação

Confira se funcionou

  • smoke imprime HTTP 200 em todos os blocos e termina com 0.
  • A saída do comando responses contém integration_ok.
  • --help lista os comandos sem fazer nenhuma solicitação.
  • Sem uma chave, o script imprime Missing PHASEO_API_KEY e termina com 1.
  • As solicitações aparecem em Configurações → Uso → Registros.

Escolha modelos para os comandos de mídia

Estes padrões em quickstart.py foram aposentados ou não têm provedor ativo. Passe um modelo atual com --model e escolha um na página de modelos ou com python quickstart.py models: Os padrões de embeddings (google/gemini-embedding-2) e image (openai/gpt-image-2) são atendidos. Os trabalhos de vídeo e música são assíncronos: guarde o ID retornado e consulte o comando de status; Vídeo assíncrono e batch explica o ciclo de vida dos trabalhos. Reduza o arquivo aos comandos de que o seu serviço precisa, mantenha o único helper compartilhado gateway_request() e passe para o SDK de Python quando quiser solicitações tipadas.
Última modificação em 5 de novembro de 2026