Free Tier
- - No signup or payment required to start.
- Run
npx agentscale register to get an API key. - Free deploys expire after 1 hour.
- Limited to 1 service.
Paid Tier
- - Add credits to remove the 1-hour expiry and deploy permanently.
- Use
npx agentscale account to check your tier and credit balance. - When you need to add credits, use the
agentspend pay command or the AgentSpend skill.
Commands
Register
CODEBLOCK0
Generates an API key and saves it to ~/.agentscale/config.json.
Deploy
CODEBLOCK1
Run this from your project directory. Packages the current directory and deploys it.
Options:
- -
--name <name> — Service name (auto-generated if omitted)
List
CODEBLOCK2
Lists your services and their status.
Account
CODEBLOCK3
Shows your account tier (free/paid) and credit balance.
To add credits, use the agentspend pay command:
CODEBLOCK4
Or pay directly with an x402 wallet by calling POST /add-credits with your x-api-key header and amount_cents in the body.
Project Requirements
- - Deploy APIs and web services. Supports Node.js, Python, Go, and more.
- Your project needs a standard structure to be auto-detected:
-
Node.js: a
package.json with a start script.
-
Python: a
requirements.txt.
-
Go: a
go.mod.
- - Custom domains, build commands, and start commands are not yet supported.
Environment Variables
- -
AGENTSCALE_API_URL — Overrides the default API base URL. Warning: this redirects all API calls, including those carrying your API key, to the specified URL.
System Requirements
- -
tar must be available on PATH (used to package projects for deploy).
Limits
- - Upload: 100 MB compressed, 500 MB decompressed.
免费套餐
- - 无需注册或付费即可开始使用。
- 运行 npx agentscale register 获取 API 密钥。
- 免费部署服务在一小时后过期。
- 仅限 1 个服务。
付费套餐
- - 添加积分即可解除 1 小时过期限制，实现永久部署。
- 使用 npx agentscale account 查看您的套餐等级和积分余额。
- 需要添加积分时，请使用 agentspend pay 命令或 AgentSpend 技能。
命令
注册
bash
npx agentscale register
生成 API 密钥并保存至 ~/.agentscale/config.json。
部署
bash
npx agentscale deploy
在项目目录中运行此命令。将打包当前目录并进行部署。
选项：
- - --name <名称> — 服务名称（省略时自动生成）
列表
bash
npx agentscale list
列出您的服务及其状态。
账户
bash
npx agentscale account
显示您的账户套餐等级（免费/付费）和积分余额。
如需添加积分，请使用 agentspend pay 命令：
bash
agentspend pay https://api.agentscale.co/add-credits \
--header x-api-key:<您的API密钥> \
--body {amount_cents: 500}
或通过调用 POST /add-credits 并附带 x-api-key 请求头和请求体中的 amount_cents，直接使用 x402 钱包支付。
项目要求
- - 部署 API 和 Web 服务。支持 Node.js、Python、Go 等。
- 项目需具备标准结构以便自动识别：
-
Node.js： 包含启动脚本的 package.json 文件。
-
Python： 包含 requirements.txt 文件。
-
Go： 包含 go.mod 文件。
环境变量
- - AGENTSCALEAPIURL — 覆盖默认 API 基础 URL。警告： 此操作将重定向所有 API 调用（包括携带 API 密钥的调用）至指定 URL。
系统要求
- - 系统 PATH 中必须包含 tar 命令（用于打包项目进行部署）。
限制
- - 上传限制：压缩后 100 MB，解压后 500 MB。
