elizaOS Cloud

elizaOS Cloud

elizaOS Cloud is a platform for building, deploying, and scaling intelligent AI agents. This skill provides access to the complete elizaOS Cloud API for managing agents, generating content, and building AI-powered applications.

Quick Start

Set your API key as an environment variable:

export ELIZACLOUD_API_KEY="your_api_key_here"

Use the included bash client for common operations:

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

API Configuration

Core Endpoints

Chat Completions (OpenAI-Compatible)

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
  }'

Features: Streaming, function calling, structured outputs

Agent Management

List Agents

GET /api/my-agents/characters

Create Agent

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

Get Agent

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

Delete Agent

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

Image Generation

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

Models: FLUX Pro, FLUX Dev, Stable Diffusion

Video Generation

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

Models: MiniMax, Runway

Voice Cloning (ElevenLabs)

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

Knowledge Base

Upload Document

POST /api/v1/knowledge/upload

Query Knowledge

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

Containers

Deploy Container

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

A2A Protocol (Agent-to-Agent)

Discover Agents

GET /api/v1/discovery

Send Task

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 Keys

Create API Key

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

Available Permissions: chat, embeddings, images, video, voice, knowledge, agents, apps

Error Handling

All errors follow this format:

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

Common Error Codes:

Rate Limits

| Endpoint | Rate Limit | |------------------|-------------| | Chat completions | 60 req/min | | Embeddings | 100 req/min | | Image generation | 20 req/min | | Video generation | 5 req/min |

Example Workflows

Deploy a Customer Support Agent

# 1. Create agent
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. Chat with agent
curl https://elizacloud.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $ELIZACLOUD_API_KEY" \
  -d '{"model": "agent-id", "messages": [{"role": "user", "content": "Help me"}]}'

Generate Marketing Assets

# 1. Generate image
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. Generate video
curl -X POST https://elizacloud.ai/api/v1/video/generate \
  -H "Authorization: Bearer $ELIZACLOUD_API_KEY" \
  -d '{"prompt": "Product demo animation", "duration": 10}'

Build Agent Network with A2A

# 1. Discover available agents
curl https://elizacloud.ai/api/v1/discovery \
  -H "Authorization: Bearer $ELIZACLOUD_API_KEY"
2. Delegate task to specialist agent
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"}]}}}'

Onboarding

Sign Up

Get API Key

# After signing up, create a key at Dashboard → API Keys
Or via API (once authenticated):
POST /api/v1/api-keys
{
  "name": "My OpenClaw Agent",
  "permissions": ["chat", "agents", "images", "video", "voice", "knowledge"]
}

Install CLI (Optional)

bun add -g @elizaos/cli
elizaos login

Payments & Credits

Check Balance

GET /api/v1/credits/balance

Purchase Credits (Stripe)

POST /api/v1/credits/checkout
{ "amount": 5000 }
Returns a Stripe checkout URL — redirect to complete payment

x402 Crypto Payment (USDC)

# Include x402 payment header with any API request
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"}]}'

Auto Top-Up

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

Credit Transactions

GET /api/credits/transactions?limit=50

Usage Summary

GET /api/v1/credits/summary
Returns: org balance, agent budgets, app earnings, redeemable earnings

Wallet & Crypto RPCs

Create Crypto Payment

POST /api/crypto/payments

Check Payment Status

GET /api/crypto/status

Authentication Methods

Set your API key as an environment variable:

export ELIZACLOUD_API_KEY="your_api_key_here"

Use the included bash client for common operations:

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