跳转到主要内容
运行一个只用标准库的 Python CLI,一次一个命令地调用 Phaseo 端点。完成后,你会得到可用的 python quickstart.py <command>,涵盖健康检查、模型、Responses 和 Chat Completions,另外还有 embeddings、内容审核、图像、OCR、视频和音乐命令,可以复制到 worker 或后端中使用。 该 CLI 仅作示例:它是请求结构的参考,而不是打包好的工具。媒体命令的几个默认模型 ID 已不再提供服务,因此请为这些命令传入 --model(见为媒体命令选择模型)。 要让编程智能体从零构建类似的 CLI,请粘贴以下提示:

围绕 Phaseo 路由构建一个 Python 网关 CLI。

在 Cursor 中打开

CLI 能做什么

示例位于 examples/gateway-python-quickstart:只有一个文件 quickstart.py,只使用 urllib、json 和 argparse。 遇到 429、5xx 和网络错误时,每个请求会重试两次,分别等待 1 秒和 2 秒,并在 45 秒后超时。调用结果不是 2xx 时,每个命令都会以 1 退出,因此可以在脚本中使用。

运行

你需要 Python 3 和一个 Phaseo API 密钥。
1

创建 .env.local

脚本会从你运行它的文件夹读取 .env.local。示例中没有 .env.example,所以请自己创建该文件:
.env.local
shell 中已经设置的变量优先于该文件。没有设置 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。
最后修改于 2026年11月5日