Sandbox Runner · Developer Preview

把一次执行接进你的 Agent。

用 sandbox_key 调用 Sandbox HTTP API。模型、额度与结算仍统一经过 ZMZAI Relay，临时环境默认禁网并受资源限制。

01 · Quick Start

提交任务，订阅事件。

每次创建运行都需要唯一的 Idempotency-Key（16-128 字符），便于网络重试时避免重复执行；同一 key 重复提交相同内容会返回原运行。

curl https://z.zmzai.cloud/api/v1/runs \
  -H "Authorization: Bearer zsk_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"task":"计算 1+1 并输出结果","model":"你的模型 ID"}'

02 · Direct Exec

跳过规划，直接执行代码。

已经知道要跑什么代码时，用 POST /api/v1/exec 省去 LLM 规划。可选 inputFiles 携带输入文件，产出的新文件可通过 GET /api/v1/runs/:runId/artifacts/:path 下载。

curl https://z.zmzai.cloud/api/v1/exec \
  -H "Authorization: Bearer zsk_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"language":"javascript","code":"console.log(6 * 7)","timeoutMs":10000}'

03 · Events

通过 SSE 读取输出。

调用 GET /api/v1/runs/:runId/events，使用同一 Authorization。事件会区分 stdout、stderr、状态和产物；多轮规划任务会追加 sandbox.step 事件。

04 · Boundaries

key 只访问 Sandbox。

zsk_ 不能直接调用 Relay 模型接口。外网默认禁止，连接器和 webfetch 将由受控工具单独提供。

05 · Billing

额度仍归 Relay 管理。

模型调用和扣费统一经过 m.zmzai.cloud。余额不足时，请前往 Relay 提额后重试。