SuperAPI AI 工具集

agentbox-provision

智能体与模型

查看项目

更新于 10-15 20:10

技能介绍

用途:按需开通一台专用 AI Agent 虚拟机。每台 VM 运行 OpenClaw AI 网关,提供 HTTPS、Web 终端与 Solana 钱包,实例默认有效期 7 天并支持续期。

主要能力:通过 x402 以 5 USDC(Solana 主网)自动付费开通,指定可选实例名;轮询获取运行状态、gatewayToken、chatUrl 与 terminalUrl;使用 OpenAI 兼容的 /v1/chat/completions 接口发送对话(非流式、无状态,多轮需携带完整消息历史);通过钱包 Ed25519 签名列出自己拥有的实例;支付 5 USDC 续期 7 天,最大生命周期 90 天。

使用方式:先 npm install @x402/fetch @x402/svm @solana/kit,准备含 USDC 的 Solana 钱包文件(solana-keygen JSON,64 字节数组)。创建 provision.mjs 并用 node provision.mjs /path/to/wallet.json [name] 运行,POST https://api.agentbox.fyi/provision(名称可选,需 DNS 安全,小写字母数字加连字符,3-63 字符)。返回 201 后保存 id、name、accessToken。随后轮询:curl -s https://api.agentbox.fyi/provision/INSTANCE_ID -H "Authorization: Bearer ACCESS_TOKEN",每 15 秒一次,启动约 2-4 分钟;状态从 provisioning 到 running,期间 provisioningStep 显示 vm_created、configuring、wallet_created、openclaw_ready、services_starting 等子状态,多次返回相同状态属正常。running 后响应给出真实 gatewayToken、chatUrl 和 terminalUrl。调用对话:curl -s https://NAME.agentbox.fyi/v1/chat/completions -H "Authorization: Bearer GATEWAY_TOKEN" -H "Content-Type: application/json" -d '{"messages": [{"role": "user", "content": "Hello, what can you do?"}]}'。续期:POST https://api.agentbox.fyi/provision/INSTANCE_ID/extend,带 Bearer ACCESS_TOKEN,返回新的 expiresAt 与 accessToken。

适用场景:需要独立云端 AI Agent 运行环境、Web 终端访问与钱包身份的场景。

限制:需自备含 USDC 的 Solana 钱包;支付网络为 Solana 主网,资产 USDC(EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v);实例名不可重复(409);401 表示令牌无效,404 表示实例不存在;502 开通失败不扣费;列表接口的 timestamp 须在服务器时间 5 分钟内。其余未在资料中说明的功能暂未提供。