基于三个对象构建。 槽位、账号、提交。
0bull 的 API 和 MCP 服务器暴露的是同一套核心发布模型：手机是槽位（slot），关联的社交账号是账号（account），媒体任务是提交（submission）。账号和提交支持 TikTok、Instagram 和 YouTube。为向后兼容，平台（platform）默认为 TikTok。
槽位
所分配手机的 UUID。
账号
平台账号，可选择绑定到某台手机；只有在其手机上处于活跃状态的账号才能发布。
提交
一个带有可轮询状态的视频任务。
账号 ID 是 UUID。手机工具使用 list-phones-tool 返回的槽位 UUID，而不是面向人的标签。提交必须指向其手机上处于活跃状态的账号。大多数平台操作和涉及手机的工作流操作都会排队并立即返回。phone-control-tool、phone-snapshot-tool 和 phone-ocr-tool 则同步返回。对于排队的账号和提交工作，请轮询账号或提交资源。
三种接口。 按任务选择合适的那一种。
当你的应用需要稳定的 HTTP 契约时使用 REST。当 AI 客户端需要发现工具并通过基于浏览器的 OAuth 执行操作时使用 MCP。当需要有人检查真实屏幕时，使用仪表盘或浏览器控制。
完成认证并提交。 然后观察并审核。
首先对你客户端所使用的界面进行身份验证。REST 客户端在“设置”下创建 API 令牌，复制一次，然后将其作为 Bearer 令牌发送。MCP 客户端添加 HTTP 服务器 URL，并通过 OAuth 在浏览器中授权。这两种身份模型都不会授予对他人账号或手机授权的访问权限。
从那里开始，列出你可以访问的账号或手机。通过 UUID 选择账号，或通过槽位 UUID 选择手机。只能为活跃账号排队提交。然后轮询返回的资源，而不是把已接受的请求当作已发布的结果。
- 对客户端进行身份验证。
- 查找账号或已分配的手机。
- 排队提交，需要时通过签名上传 URL 上传媒体文件，并使用对应的手机工具；对于排队中的工作，请轮询该提交。
- 轮询状态，并在平台需要关注时引入人工介入。
curl https://0bull.net/api/v1/accounts \
-H "Authorization: Bearer $OBULL_TOKEN" \
-H "Accept: application/json"{
"mcpServers": {
"0bull": {
"type": "http",
"url": "https://0bull.net/mcp"
}
}
}手机是约定的一部分。 围绕它来设计。
- 限定访问权限
- 每个 API 令牌和 MCP 授权都限定在创建它的账号范围内。MCP 调用只能看到调用者的账号，并访问调用者已获授权的手机。
- 支持人工审核
- 提交可能会以需要人工检查手机的方式失败。文档中的状态模型会让这些状态保持可见，你的工作流可以在此暂停并交接给操作员。
- 速率限制已有文档说明
- REST 和 MCP 允许每分钟 60 次请求。轮询是预期行为，但在手机完成工作期间，请在状态调用之间留出间隔。
MCP 工具参考
真正可用的工具集。 按工作类型分组。
MCP 服务器暴露在 0bull Phone Farm 服务器中注册的工具。使用完整参考了解参数和响应结构；本页保持整体结构清晰易读。
账号
创建并检查你的自动化所使用的发布账号。
list-accounts-tool列出 TikTok、Instagram 和 YouTube 上的账号。
get-account-tool获取任意平台上的单个发布账号。
create-account-tool关联一个已在手机上登录的发布账号。
delete-account-tool从手机农场中移除账号，但不删除其在平台上的账号。
提交与上传
让媒体经过发布工作流并观测其结果。
list-submissions-tool列出受支持平台上的近期提交。
get-submission-tool获取单个提交并轮询其状态。
create-upload-url-tool为直接上传视频创建一个短期有效的签名 URL。
create-submission-tool为某个账号排队来自公开 URL 或已上传媒体的视频。
cancel-submission-tool取消排队中或进行中的提交。
delete-submission-tool删除已完成的提交及其存储的视频。
手机
直接检查并操作所分配的手机槽位。
list-phones-tool列出你可以查看的手机槽位及其会话状态。
list-phone-runs-tool列出一台手机的运行记录，最新的排在前面。
get-phone-run-tool通过运行 ID 获取一条手机运行记录。
phone-command-tool运行设备命令，例如剪贴板、URL、电源和连接操作。
phone-control-tool发送直接点击、滑动、快捷键和文本输入操作。
phone-snapshot-tool截取手机屏幕的 JPEG 快照。
phone-ocr-tool使用 OCR 读取手机屏幕上的文字。
run-macro-tool运行命名工作流或原始的手机步骤序列。
run-phone-agent-tool让手机上的 GUI 智能体异步执行一项范围明确的任务。
计费与租赁
查看租赁信息，并在流程中包含人工审批的情况下请求更改手机数量。
get-billing-tool查看手机租赁、续费日期和待处理订单。
start-rental-tool为首次手机订单返回 Stripe Checkout 链接。
request-phones-tool请求更改租用手机的数量。
get-billing-request-tool查看手机数量变更请求的状态。
了解边界。 在开始构建之前。
文档所述的产品模型是真实手机工作流。0bull 在实体手机上排队执行操作，而不是将其呈现为直接的平台发布 API。REST 和 MCP 界面是这些设备工作流的 0bull 控制界面。
REST 是用于账号和提交的 Bearer 令牌 HTTP API。MCP 是面向 MCP 客户端、经 OAuth 认证的服务器，其工具界面更广，还涵盖上传、计费和直接手机操作。
账号使用 UUID 并标明各自所属的平台。手机工具使用 list-phones-tool 返回的槽位 UUID。面向人的槽位标签不是传给手机工具的标识符。
提交已为手机排队。轮询提交资源并读取其状态。请求被接受并不等同于视频已发布。
可以。浏览器界面就是供操作员动手处理屏幕操作、审核，以及其他需要 VA 或团队成员亲眼看到手机的场景所用的路径。
API 参考涵盖 Bearer 身份验证、分页、响应码和验证错误。MCP 连接和概览页面涵盖 OAuth、作用域、异步工作和速率限制。