Pokee Enterprise API 是一套 REST API。它在每个客户专属、可持久的沙箱里运行长任务 AI 智能体。你创建会话、发送消息，再以 Server-Sent Events（SSE）流读取智能体的回答。会话可以保存文件、自定义技能、你自己的工具，以及跨会话延续的记忆。开通方式是向 Pokee 申请演示，不是自助注册。
下文说明会话和流如何工作、第一次调用怎么发、Pokee Isaac 的价格和限额。文中数字都来自 Pokee 文档，阅读日期是 2026 年 10 月 28 日。原文后半还给出了来源产品 CLI 的安装和测试命令。Apifox 是否提供同名 CLI，待核实，因此不照搬。
什么是 Pokee Enterprise API？
Pokee Enterprise API（Pokee 称之为 Enterprise Responses API）用来运行耗时数分钟、而不是数秒的智能体工作流。每个租户有独立工作区、稳定的 bearer token，以及自己的子域名 https://your-tenant.enterprise.pokee.ai。工作区里的每个会话，都是跑在自己沙箱里的一个智能体进程。
一次聊天调用回答一条提示后就忘记上下文。Pokee 会话会保留对话、文件和忙碌状态，智能体因此可以跨多轮检索、写文件和调用工具。如果你读过「Claude 托管智能体」那篇说明，形态会很熟悉：提供方托管智能体循环和沙箱，你用 HTTP 驱动它。
它面向需要托管智能体、租户隔离和企业网络控制的团队。Pokee 列出的可选能力包括 IP 允许列表、mTLS、AWS PrivateLink 和区域固定，需另行申请。
核心概念：会话、文件、技能和记忆
这套 API 有四块积木。
| 概念 | 端点 | 你得到什么 |
|---|---|---|
| 会话 | POST /v1/sessions |
每个会话一个智能体进程，自带历史、文件范围和模型 |
| 文件 | /v1/sessions/{id}/files/{path} |
上传、下载、列出和删除工作区文件（单次上传约 100 MB） |
| 技能 | POST /v1/skills/{name} |
安装根目录带 SKILL.md 的 zip 包；对新会话生效 |
| 记忆 | .pokee/*.md、.memory/MEMORY.md |
写入系统提示的租户说明，以及跨会话记忆 |
有几条会话细节值得先知道：
- 持久化。 默认
persistent为false，会话会在最后一次响应 5 分钟后自行销毁。设为true后，会保留到ttl结束（默认 14,400 秒，即 4 小时），或直到你删除它。 - 模型锁定。 创建时传入的
model会用于该会话的每一轮。 - 文件范围。 用
file_access传入read和write路径列表，限制智能体能看到的内容。HTTP 文件 API 对范围外路径返回403。 - 一次只跑一轮。 一轮还在进行时再发第二条消息，会返回
409 Conflict。
如何发出第一次 Pokee API 调用
Pokee 会在带外给你两个值：租户 URL，以及形如 pk_<tenant>_<token> 的密钥。第一次调用分三步。
- 检查网关是否可用（不需要鉴权）。
- 创建会话并保存它的
id。 - 发送消息并读取 SSE 流。
export POKEE_API="https://your-tenant.enterprise.pokee.ai"
export POKEE_KEY="pk_<tenant>_<token>"
curl "$POKEE_API/health"
SID=$(curl -s -X POST "$POKEE_API/v1/sessions" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: application/json" \
-d '{"persistent": true}' | jq -r '.id')
curl -N -i -X POST "$POKEE_API/v1/sessions/$SID/messages" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "Summarize the files in my workspace in three bullets."}'
-i 会打印响应头。请保存 X-Response-Id（msg_ 加 24 位十六进制字符）：恢复或取消这一轮时要用到它。
每个事件占三行：id:、event: 和 data:。你会先看到 message.created，接着是 text.delta 分片（还可能有 thinking.* 或 tool_use.* 事件）。流以 message.completed、message.cancelled 或 message.error 结束。如果还不熟悉 SSE，可以看 MDN 的 Server-Sent Events 说明。如何读取这些分片，也可以参考「测试通过 SSE 流式返回的 LLM API」。
工具调用：两种接口
Pokee 给智能体两种调用你函数的方式，都使用 OpenAI 风格的函数定义。
无状态 /v1/responses |
会话工具 | |
|---|---|---|
| 智能体循环 | 没有，一次推理往返 | 带技能和文件的完整智能体会话 |
| 状态 | 每次调用都由你发送完整历史 | 服务器保存对话 |
| 调用如何出现 | output[] 里的一个 function_call 项 |
流中途的 tool_call.requested SSE 事件 |
| 如何继续 | 带上 function_call_output 再发一次调用 |
POST /v1/sessions/{id}/tool_results |
如果你要把 Pokee 接到为 OpenAI Responses API 写的代码后面，选无状态这条路由，因为线上报文形状一致。它每次请求最多接受 128 个工具，工具名最长 64 个字符，描述最长 16 KiB。它也接受 reasoning.effort（minimal 是默认值，关闭扩展思考；low、medium 和 high 会打开）。输出默认 4,096 token，上限 32,000。
会话工具适合智能体在同一轮里推理、运行技能，并偶尔调用你的系统。在创建会话时注册它们。
恢复、取消和幂等键
长轮次会以短调用不会出现的方式中断。按 Pokee 的更新日志，它在 2026 年 5 月 4 日加了三项处理。
- 恢复。 客户端在流中途断开时，智能体继续运行。用
Last-Event-ID请求头重新连接GET /v1/sessions/{id}/responses/{rid}/events，服务器会从下一个事件重放。已关闭的轮次保留 120 秒，恢复不会再次计费 token。 - 取消。
POST /v1/sessions/{id}/responses/{rid}/cancel返回202，流以message.cancelled结束。被取消轮次的部分用量不计费。会话和文件仍然保留。 - 幂等键。 在发送消息的 POST 上带
Idempotency-Key: <uuid>。用同一键和同一请求体重试时，返回原来的响应 ID，而不会再开一轮。键保留 24 小时；同一键配不同请求体返回422。
无状态的 /v1/responses 在 stream 为 true 时也支持这三项。
Pokee Isaac 模型与价格
Pokee 在模型与价格页公布了两档 Isaac。价格按每百万 token 计。
| 模型 | 输入 | 输出 | 缓存读取 |
|---|---|---|---|
pokee-isaac-high-reasoning |
$3 | $15 | $0.30 |
pokee-isaac |
$0.30 | $5 | $0.10 |
省略 model 时，新租户默认使用 pokee-isaac-high-reasoning。Kimi、GPT-5.5 和 Gemini 后端可按租户合同开通。文档没有列出免费档或最低合同额，这些条款需要问 Pokee。
另外还有 Direct Isaac API，于 2026 年 8 月 7 日加入：一条兼容 OpenAI 的 POST /v1/chat/completions，没有智能体循环，也没有工具。它按租户开通，只接受 pokee-isaac，并把长请求（20 万、200 万 token 及以上）自动路由到更大的上下文池。GET /v1/usage 显示你的额度余额。
文档里有一条安全说明：租户 bearer 就是直接的 API 密钥。把它放在你的服务器上，或放在你自己的代理后面，不要放进浏览器、移动端或桌面代码。
限额和错误码
以下默认值来自限额与错误页。Pokee 表示这些都可以另行申请提高。
| 限额 | 默认值 |
|---|---|
| 并发会话 | 10 |
| 单轮超时 | 90 分钟 |
| 会话 TTL | 4 小时 |
| 每小时 / 每天轮次 | 300 / 5,000 |
| 每小时 / 每天 token | 2000 万 / 2 亿 |
| 最大上传 | 每次调用约 100 MB |
| 最大工作区 | 100 GB |
最常处理的错误码：401（密钥错误或缺失）、402（额度用尽，仅硬额度模式）、403（路径超出会话范围）、409（会话正忙）、422（幂等键被复用但请求体不同）、429（用量超限）和 500（退避后重试）。错误体形如 {"error": "<name>", "message": "<detail>"}。
用编码智能体核对这套 API
会话 API 有不少契约需要钉死：创建返回 201、ID 以 sess_ 开头、忙碌时返回 409、删除返回 204、取消返回 202。编码智能体可以在你继续工作时装写并运行这些检查。
原文给出了来源产品 CLI 的安装、登录、导入 OpenAPI 和运行测试用例的命令，并提到其免费方案最多 4 名用户。Apifox 是否提供同名 CLI 及这些命令，待核实，因此不照搬。密钥仍应从环境变量读取，不要写进文件。SSE 流本身更适合在支持事件流展示的接口客户端里观察。
Sharkly 适合放在哪里
当 Pokee 智能体或其他编码智能体开始跑长达 90 分钟的任务时，总得有人决定谁做什么，并检查结果。日志里的会话 ID 不是工作队列。Sharkly 是一块任务板，AI 智能体和人在上面分工：你把任务派给智能体或同事，跟踪状态，并在结果发出前审核。它可以免费开始，所以你可以先把一个长任务放到板上，看审核流程是否适合团队，再考虑扩大。
常见问题
Pokee Enterprise API 有免费档吗？ 文档没有描述。开通从演示申请开始，Pokee 在带外提供租户 URL 和密钥。价格按上面的 Isaac 档位、按 token 计费。
Pokee API 兼容 OpenAI 吗？ 部分兼容。无状态的 /v1/responses 在函数调用上与 OpenAI Responses 的报文形状一致，Direct Isaac 接受 Chat Completions 的请求形状。会话端点是 Pokee 自己的。
Pokee 智能体一轮能跑多久？ 默认单轮超时 90 分钟，默认会话 TTL 4 小时。两者都可以另行申请提高。
客户端在流中途断开会怎样？ 智能体继续工作。在该轮关闭后 120 秒内，带上 Last-Event-ID 连到恢复端点，就能拿到剩余事件，且不会再次计费。
它和其他托管智能体 API 比怎么样？ 它接近 OpenAI Agents API 这类托管智能体产品。可以接着看「OpenAI 智能体方案对比」，沙箱一侧可以看「CubeSandbox 为 AI 智能体做了什么」。
开发必备：API 全流程管理神器 Apifox
介绍完上文的内容，我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档、调试、设计、测试、Mock、自动化测试于一体的工具，Apifox 是目前提升研发效率的首选。
如果你正在开发项目，不妨试试其极其友好的界面设计，它完全兼容 Postman 和 Swagger 数据格式，导入数据非常方便，，即使是新手也能很快上手，点击这里即可注册使用。
值得一提的是，除了个人和常规团队使用，针对有高安全合规要求、或需要在内网环境协作的企业，Apifox 还提供了深度定制的私有化部署方案。
获取专属报价与部署方案
详细的私有化部署系统架构与安全白皮书
针对您公司规模的专属报价单
免费的 1v1 专属产品演示 (Demo) 机会
