Pi

Pi 是 earendil-works/pi 提供的编程代理。Pi 通过自定义 OpenAI 兼容提供商连接 TokenFlux。调用费用从 TokenFlux 余额扣除。

本指南使用 Pi 1.0.4 和 gpt-6-luna 验证了流式回复。

开始前复制标题链接

1. 准备已安装的 Pi。配置详情请参阅官方Pi 模型指南和models.json 参考。
2. 在网页版的 API 密钥 页面创建并复制密钥。完整密钥只显示一次。
3. 在 账单 页面确认余额充足。
4. 在 模型与价格 页面复制模型 ID，并检查模型支持的协议。

在 models.json 中添加 TokenFlux复制标题链接

在 Bash 或 Zsh 中设置密钥：

export TOKENFLUX_API_KEY="YOUR_TOKENFLUX_KEY"

创建或更新 ~/.pi/agent/models.json：

{
  "providers": {
    "tokenflux": {
      "baseUrl": "https://tokenflux.ai/v1",
      "api": "openai-completions",
      "apiKey": "${TOKENFLUX_API_KEY}",
      "models": [{ "id": "YOUR_MODEL_ID", "name": "YOUR_MODEL_ID" }]
    }
  }
}

将 YOUR_TOKENFLUX_KEY 替换为刚复制的密钥。请勿将密钥提交到 Git。

Pi 会从环境变量展开 ${TOKENFLUX_API_KEY}。JSON 文件中保留此引用，无需写入密钥。openai-completions 使用 /v1/chat/completions。如果文件已存在，请将提供商合并到已有 providers 对象中。

选择模型复制标题链接

将 models.json 中的两处 YOUR_MODEL_ID 替换为支持 Chat Completions 和工具调用的目录模型。运行 pi --provider tokenflux --model YOUR_MODEL_ID，或在 /model 中重新加载配置并选择模型。

验证连接复制标题链接

在临时目录中运行以下命令。如果客户端要求确认文件访问，请核对路径后批准。

printf 'TOKENFLUX_GUIDE_OK\n' > marker.txt
pi --provider tokenflux --model YOUR_MODEL_ID --tools read \
  -p "Read marker.txt and return its contents"

回复应包含 TOKENFLUX_GUIDE_OK。在 使用记录 页面确认模型和密钥，并查看 token 数量与费用。测试完成后删除 marker.txt。

故障排查复制标题链接

模型没有出现。 检查 JSON 语法、providers.tokenflux.models 列表和密钥环境变量。如果设置了 PI_CODING_AGENT_DIR，请将 models.json 放入该目录。

更新环境变量后仍认证失败。 已保存的 auth.json 凭据优先于 models.json。使用 /logout 移除旧的 TokenFlux 凭据后重试。

工具调用失败。 选择支持工具调用的模型。此配置的 api 应保持为 openai-completions。

返回 401、429 或模型错误。 检查密钥是否启用、模型 ID 是否完整，以及余额和限流状态。请勿自动改用其他模型。

API 参考复制标题链接

请参阅 Chat Completions、模型列表 和 API 概览。