面向 Synth 托管基础设施的 Python SDK 与 CLI，提供容器、隧道、容器池的编程式管理，并支持托管 AI 研究工作流。
Synth AI（包名 synth-ai，当前版本 0.10.0）是 Synth 平台的官方 Python SDK，通过 SynthClient 统一入口提供三大基础设施管理模块：containers（托管容器记录与元数据管理）、tunnels（受管隧道记录与租赁管理）、pools（容器池、任务、rollouts、artifacts、usage 与 events）。SDK 底层为 Rust 实现（仓库 Rust 占 89.5%），Python 层为上层封装，要求 Python >= 3.11，使用 MIT 许可证。
平台同时提供 Managed Research 功能：用户将代码仓库和研究目标交给 Synth 托管的 AI Worker 执行，平台负责工作空间编排与持久化产出物管理（消息、任务、日志、checkpoints、artifacts、usage、PRs、最终报告），支持 MCP 优先接口（可从 Codex、Claude Code、Cursor 等客户端启动）和 Python SDK 脚本化工作流。典型用例包括 Eval Harness Improvement、Benchmark Improvement、Repo Review and PR、Checkpoint Branching 等。
SDK 通过 SYNTH_API_KEY 环境变量或构造函数参数认证，默认连接 https://api.usesynth.ai 后端，支持自定义 base_url。安装后同时提供 synth-ai CLI 入口。可选 synth-ai[providers] 额外依赖可集成 anthropic、groq、google-genai 等 LLM Provider。早期版本中的 prompt optimization、inference、graphs、verifiers 等模块已归档，不再属于受支持的 SDK 表面。
安装与快速开始
uv add synth-ai
export SYNTH_API_KEY="sk_..."
from synth_ai import SynthClient
client = SynthClient()
print(client.containers.list())
print(client.tunnels.list())
print(client.pools.list())
认证模型
| 密钥类型 | 用途 | 配置方式 |
|---|---|---|
| Synth API Key | 后端认证（SDK 调用） | SYNTH_API_KEY 环境变量或 SynthClient(api_key=...) |
| Environment API Key | 容器认证（后端/隧道到本地容器） | ENVIRONMENT_API_KEY 环境变量 |
| SynthTunnel Worker Token | 隧道中继认证 | tunnel.worker_token 配置 |
待确认信息
- 平台定价与免费额度未从公开材料确认
- Managed Research 公开可用状态（GA/Beta/限制访问）未明确标注
synth_ai_rs（Rust 绑定）具体为 Python 绑定底层还是后端服务代码未完全确认- 早期 Prompt Optimization 能力是否通过 Managed Research 间接提供未确认
- CLI 具体子命令列表未覆盖