python quickstart.py <command>,涵盖健康检查、模型、Responses 和 Chat Completions,另外还有 embeddings、内容审核、图像、OCR、视频和音乐命令,可以复制到 worker 或后端中使用。
该 CLI 仅作示例:它是请求结构的参考,而不是打包好的工具。媒体命令的几个默认模型 ID 已不再提供服务,因此请为这些命令传入 --model(见为媒体命令选择模型)。
要让编程智能体从零构建类似的 CLI,请粘贴以下提示:
围绕 Phaseo 路由构建一个 Python 网关 CLI。
CLI 能做什么
示例位于 examples/gateway-python-quickstart:只有一个文件quickstart.py,只使用 urllib、json 和 argparse。
遇到
429、5xx 和网络错误时,每个请求会重试两次,分别等待 1 秒和 2 秒,并在 45 秒后超时。调用结果不是 2xx 时,每个命令都会以 1 退出,因此可以在脚本中使用。
运行
你需要 Python 3 和一个 Phaseo API 密钥。1
创建 .env.local
脚本会从你运行它的文件夹读取 shell 中已经设置的变量优先于该文件。没有设置
.env.local。示例中没有 .env.example,所以请自己创建该文件:.env.local
PHASEO_MODEL 时,文本命令使用 openai/gpt-5.6-sol。2
运行冒烟检查
smoke 还会发送一个简短的 Responses 请求,因此会消耗少量额度。3
发送一个请求
检查是否成功
smoke为每个块打印HTTP 200,并以0退出。responses命令的输出包含integration_ok。--help列出所有命令,不会发出请求。- 没有密钥时,脚本打印
Missing PHASEO_API_KEY并以1退出。 - 这些请求会出现在设置 → 用量 → 日志中。
为媒体命令选择模型
quickstart.py 中的以下默认值已停用或没有可用的提供商。请用 --model 传入当前模型,可以从模型页面或 python quickstart.py models 中挑选:
embeddings(google/gemini-embedding-2)和 image(openai/gpt-image-2)的默认值仍在提供服务。视频和音乐任务是异步的:保存返回的 ID 并轮询状态命令;异步视频和批处理介绍了任务的生命周期。
把文件精简为你的服务需要的命令,保留共用的 gateway_request() 辅助函数;需要类型化请求时,改用 Python SDK。