构建 Python 网关 CLI

​

示例项目

• GitHub：examples/gateway-python-quickstart
• 仓库本地路径：examples/gateway-python-quickstart

​

此应用的功能

• 支持以下控制路由：
  • GET /v1/health
  • GET /v1/models
  • GET /v1/providers
• 支持以下生成路由：
  • POST /v1/responses
  • POST /v1/chat/completions
  • POST /v1/embeddings
  • 以及其他多个端点

​

此示例的用途

• 无第三方依赖的 Python 实现参考
• 明确的请求载荷和响应处理方式
• 可用于 worker、脚本和内部工具的实用模式

​

前置条件

• Python 3
• Phaseo API 密钥

​

运行示例

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

​

检查结果

• 冒烟测试模式会确认 API 是否可访问。
• Responses 命令会输出 integration_ok。
• --help 会列出可用命令，但不会发送请求。
• 终端会清晰显示身份验证错误和 API 错误。

​

阅读代码时关注这些内容

• 如何加载环境变量
• CLI 如何分派命令
• 如何构建不同的请求载荷
• 如何将异步视频和音乐路由与一次性文本路由分开处理

​

按需修改示例

• 删除服务不需要的端点
• 使用一个共享的请求辅助函数，避免重复编写请求头
• 如果之后需要更高层的客户端，可以改用 Python SDK

​

相关指南

• 迷你应用入门提示词
• 使用 Python 输出结构化 JSON
• 示例