# 获取你的令牌
$ curl -X POST \
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com/api/v1/terminal/execute \
-H "Authorization: Bearer $TOKEN" \
-d '{"command":"echo Hello from Hoody!"}'
> { "command_id": "42", "status": "running" }
# 运行第一条命令
$ curl \
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com/api/v1/terminal/result/42 \
-H "Authorization: Bearer $TOKEN"
> { "status": "completed", "output": "Hello from Hoody!", "exit_code": 0 }
# 分享 URL——任何人都可以连接
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com
URL 就是接口
每个终端都有一个可预测的地址。从左到右读一遍，就知道自己在跟哪个服务、哪个实例、哪个容器打交道。
https://abc123-def456-terminal-1.node-us-1.containers.hoody.comabc123Project
你的项目 ID。
def456Container
容器 ID。
terminalService
哪个 Kit 服务 —— terminal、files、display……
1Instance
可运行多个：terminal-1、terminal-2、terminal-3。
node-us-1Server
运行容器的节点。
URL 就是接口。没有端口，没有配置，没有网络搭建。
每条命令都是一次 API 调用
执行是异步的。发出一条命令，拿回一个 ID，再读取结果 —— 或通过 WebSocket 实时流式获取。
POST 一条命令。立刻拿到 command_id 和 status: running。
轮询 result 端点，拿到合并后的输出和退出码。
打开一个 WebSocket，实时获取终端画面帧。
全部内置
每个功能都开箱即用，零配置。Terminal 随每个 Hoody 容器即用即发。
浏览器里的完整终端
在任意设备上打开这个 URL —— 手机、平板、笔记本。整个 Web UI 都通过查询参数配置：shell、字号、只读模式、标题和侧边栏。
?shell=zsh?fontSize=16?readonly=true?title=Prod?panel=/docsShell 选择
bash、zsh、fish、tmux、sh——通过 URL 参数切换 Shell。预装且随时可用。
Automation API
发送按键、粘贴文本、等待画面稳定 —— 通过 HTTP 驱动交互式程序。
终端截图
通过 API 将终端状态捕获为 PNG、JPEG 或 GIF。可配置颜色和字体大小，便于文档记录。
实时会话状态
只要会话存活，工作目录、shell 和历史都会保留，并在重连后依然保持。
SSH 连接任意服务器
以远程 SSH 连接的方式打开会话 —— host、user 和 key 都作为参数传入。
19 个端点，完全控制
四个域：命令执行、会话管理、通过 WebSocket 实时流式传输和系统监控。
命令执行
5 endpointscurl -X POST .../terminal/execute -d '{"command":"npm test"}'
会话管理
6 endpointscurl .../terminal/sessions → [{ "terminal_id": "1", "shell": "bash" }]
实时流式传输
4 endpointsWS .../terminal/ws — real-time terminal frames
系统与元数据
7 endpointscurl .../system/resources → { "cpu": 45.2, "memory": { ... } }
为真实工作流而生
Terminal 覆盖开发者和自动化场景的全部范围。每个使用场景映射到具体的 API 端点。
- 01
远程开发
GET /terminal/ws从任何有浏览器的设备 SSH 进入容器。完整的 shell 访问，持久化会话保留状态。
- 02
AI 代理编排
POST /terminal/execute代理通过 HTTP API 执行 shell 命令。构建、测试、部署——Terminal API 为 AI 代理提供完整的系统访问权限。
- 03
团队调试
GET /terminal/sessions与团队共享终端 URL 进行多人调试。所有人看到相同输出，可以输入，各有唯一光标颜色。
- 04
GUI 应用
?display=N从终端启动任意图形应用。Firefox、VS Code、GIMP——terminal-N 自动映射到 display-N。
- 05
CI/CD 集成
GET /terminal/result/{id}通过 HTTP 运行构建步骤、执行测试、部署产物。将 Terminal 集成到任意 CI 流水线中。
- 06
实时监控
GET /system/resources通过 API 获取实时 CPU、内存、磁盘和网络统计数据。列出运行中的进程，发送信号，检查系统信息。