让 AI agent 使用 ZipFlow

你不需要新应用就能从 agent 使用 ZipFlow。ZipFlow 是一个模型 API 服务，任何能发 HTTP 请求并读取文本文件的 AI agent 都能用它。最简单的办法是把一段提示词复制进 你已有的 agent。

把这段提示词复制给你的 agent

把下面这一行粘贴到你的 AI agent（Claude、Codex、ChatGPT、Cursor 或任意编程助手）：

Read https://zipflow.xyz/skill.txt and follow the instructions to use ZipFlow

你的 agent 会去抓取那个文件——一份写给 agent 的机器可读 skill——并按它设置正确的 base URL、列出当前模型与价格、检查平台状态，并在没有钱包时发起付款。

这一行也出现在 ZipFlow 首页 以及平台 llms.txt / llms-full.txt 机器可读站点摘要中，agent 可以自行发现它。

skill 文件告诉 agent 什么

https://zipflow.xyz/skill.txt 这个 skill 是用 agent 方式使用 ZipFlow 的枢纽。它带有版本号（frontmatter 中的 version 字段和 X-Skill-Version 响应头），并每次请求都重新渲染，因此重新抓取总会拿到当前定义。

它涵盖：

• 按协议设置 base URL —— OpenAI 兼容（https://api.zipflow.xyz/v1）、 Anthropic 兼容（https://api.zipflow.xyz）、Rerank 与 Realtime。
• 列出支持的端点 —— POST /v1/chat/completions、POST /v1/responses、 POST /v1/embeddings、POST /v1/messages、POST /v1/rerank 和 POST /v1/realtime/sessions。
• 当前模型与价格 —— 通过 GET /v1/models 和 /en/pricing。
• 平台状态 —— 通过 https://status.zipflow.xyz/status.json。
• agent 自助付款 —— 当 agent 没有钱包或余额时，可遵循 x402 agent skill 自注册身份、铸造 短时 JWT 凭证与 LLM token，并发起一笔由人结算的付款。

直接调用

如果你更想自己驱动而不是让 agent 读 skill，agent 需要一个 API key 和一个 base URL。 把 OpenAI 兼容客户端指向 https://api.zipflow.xyz/v1：

export OPENAI_BASE_URL="https://api.zipflow.xyz/v1"
export OPENAI_API_KEY="<your-zipflow-api-key>"

请求格式见 API 参考，可用模型见 模型列表。

保持最新

• 回答前重新抓取 https://zipflow.xyz/skill.txt，并与任何缓存副本比较 frontmatter 中的 version。
• X-Skill-Version 头与版本号一致，因此 agent 无需解析正文即可检测过期副本。
• 产品变更记录在主站 changelog： https://zipflow.xyz/en/changelog。