elizaOS Cloud

elizaOS Cloud 是一个用于构建、部署和扩展智能 AI 代理的平台。本能力提供对完整 elizaOS Cloud API 的访问权限，支持代理管理、内容生成以及 AI 驱动应用的开发。

快速入门

将您的 API 密钥设为环境变量：

export ELIZACLOUD_API_KEY="your_api_key_here"

使用内置的 bash 客户端执行常见操作：

./scripts/elizacloud-client.sh status
./scripts/elizacloud-client.sh agents list
./scripts/elizacloud-client.sh chat agent-id "Hello!"

API 配置

• 基础 URL: https://elizacloud.ai/api/v1
• 认证方式:
  • Authorization: Bearer $ELIZACLOUD_API_KEY
  • X-API-Key: $ELIZACLOUD_API_KEY
• Content-Type: application/json

核心端点

聊天补全（兼容 OpenAI）

curl https://elizacloud.ai/api/v1/chat/completions 
  -H "Authorization: Bearer $ELIZACLOUD_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "model": "your-agent-id",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

功能特性：流式响应、函数调用、结构化输出

代理管理

列出代理

GET /api/my-agents/characters

创建代理

POST /api/v1/app/agents
{
  "name": "My Assistant",
  "bio": "A helpful AI assistant"
}

获取代理详情

GET /api/my-agents/characters/{id}

删除代理

DELETE /api/my-agents/characters/{id}

图像生成

POST /api/v1/images/generate
{
  "prompt": "A futuristic city at sunset",
  "model": "flux-pro",
  "width": 1024,
  "height": 1024
}

支持模型：FLUX Pro、FLUX Dev、Stable Diffusion

视频生成

POST /api/v1/video/generate
{
  "prompt": "A peaceful lake with mountains in the background",
  "duration": 5,
  "model": "minimax-01"
}

支持模型：MiniMax、Runway

语音克隆（ElevenLabs）

POST /api/v1/voice/clone
{
  "text": "Hello, this is a test of voice cloning",
  "voice_id": "21m00Tcm4TlvDq8ikWAM",
  "model": "eleven_turbo_v2"
}

知识库

上传文档

POST /api/v1/knowledge/upload

查询知识库

POST /api/v1/knowledge/query
{
  "query": "How do I deploy an agent?",
  "limit": 5
}

容器

部署容器

POST /api/v1/containers
{
  "name": "my-app",
  "image": "nginx:latest",
  "ports": [{"containerPort": 80}]
}

A2A 协议（Agent-to-Agent）

发现代理

GET /api/v1/discovery

发送任务

POST /api/a2a
{
  "jsonrpc": "2.0",
  "method": "tasks/send",
  "params": {
    "id": "task_123",
    "message": {
      "role": "user",
      "parts": [{"type": "text", "text": "Analyze this data"}]
    }
  },
  "id": 1
}

API 密钥

创建 API 密钥

POST /api/v1/api-keys
{
  "name": "Production Key",
  "permissions": ["chat", "agents", "images"]
}

可用权限：chat、embeddings、images、video、voice、knowledge、agents、apps

错误处理

所有错误均遵循以下格式：

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The request body is invalid",
    "details": "Field 'model' is required"
  }
}

常见错误码：

• UNAUTHORIZED（401）：认证信息无效或缺失
• FORBIDDEN（403）：权限不足
• NOT_FOUND（404）：资源未找到
• RATE_LIMITED（429）：请求频率超限
• INSUFFICIENT_CREDITS（402）：余额不足

速率限制

示例工作流

部署客户支持代理

# 1. 创建代理
curl -X POST https://elizacloud.ai/api/v1/app/agents 
  -H "Authorization: Bearer $ELIZACLOUD_API_KEY" 
  -d '{"name": "Support Bot", "bio": "Customer support specialist"}'

# 2. 与代理对话
curl https://elizacloud.ai/api/v1/chat/completions 
  -H "Authorization: Bearer $ELIZACLOUD_API_KEY" 
  -d '{"model": "agent-id", "messages": [{"role": "user", "content": "Help me"}]}'

生成营销素材

# 1. 生成图像
curl -X POST https://elizacloud.ai/api/v1/images/generate 
  -H "Authorization: Bearer $ELIZACLOUD_API_KEY" 
  -d '{"prompt": "Modern tech startup logo", "model": "flux-pro"}'

# 2. 生成视频
curl -X POST https://elizacloud.ai/api/v1/video/generate 
  -H "Authorization: Bearer $ELIZACLOUD_API_KEY" 
  -d '{"prompt": "Product demo animation", "duration": 10}'

使用 A2A 构建代理网络

# 1. 发现可用代理
curl https://elizacloud.ai/api/v1/discovery 
  -H "Authorization: Bearer $ELIZACLOUD_API_KEY"

# 2. 将任务委派给专业代理
curl -X POST https://elizacloud.ai/api/a2a 
  -H "Authorization: Bearer $ELIZACLOUD_API_KEY" 
  -d '{"jsonrpc": "2.0", "method": "tasks/send", "params": {"message": {"role": "user", "parts": [{"type": "text", "text": "Analyze financial data"}]}}}'

入门指南

注册账号

前往 elizacloud.ai/login 注册（需使用 Privy 认证，浏览器环境必需）。新账户将获赠 1,000 免费积分 —— 足以测试聊天、图像生成等功能。

获取 API 密钥

# 注册后，可在控制台 → API 密钥 页面创建密钥
# 或通过 API 创建（完成身份验证后）：
POST /api/v1/api-keys
{
  "name": "My OpenClaw Agent",
  "permissions": ["chat", "agents", "images", "video", "voice", "knowledge"]
}

安装 CLI（可选）

bun add -g @elizaos/cli
elizaos login

支付与积分

查询余额

GET /api/v1/credits/balance

购买积分（Stripe）

POST /api/v1/credits/checkout
{ "amount": 5000 }
# 返回 Stripe 结账页面 URL —— 重定向至该地址完成支付

x402 加密货币支付（USDC）

按请求付费，无需预先购买积分：

# 在任意 API 请求中包含 x402 支付头
curl -X POST "https://elizacloud.ai/api/v1/chat/completions" 
  -H "X-PAYMENT: " 
  -H "Content-Type: application/json" 
  -d '{"model": "agent-id", "messages": [{"role": "user", "content": "Hello"}]}'

自动充值

PUT /api/v1/billing/settings
{
  "autoTopUp": true,
  "threshold": 100,
  "amount": 1000
}

积分交易记录

GET /api/credits/transactions?limit=50

用量汇总

GET /api/v1/credits/summary
# 返回：组织余额、代理预算、应用收益、可兑换收益

钱包与加密 RPC 接口

创建加密支付

POST /api/crypto/payments

查询支付状态

GET /api/crypto/status

认证方式

其他资源

• 完整 API 文档：详见 references/api-reference.md 获取全部端点细节
• 控制台：https://elizacloud.ai/dashboard，提供可视化管理界面
• OpenAPI 规范：https://elizacloud.ai/api/openapi.json
• SDK：提供 TypeScript 和 Python 客户端
• 社区：Discord 社区地址 https://discord.gg/elizaos

环境变量

• ELIZACLOUD_API_KEY：您的 elizaOS Cloud API 密钥（必需）
• ELIZACLOUD_BASE_URL：API 基础 URL（默认值：https://elizacloud.ai/api/v1）

安全须知

• 切勿将 API 密钥提交至版本控制系统
• 请为开发与生产环境分别配置独立密钥
• 定期轮换密钥
• 权限范围应严格限制在最小必要范围内
• 请通过控制台持续监控用量，及时识别异常行为