Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Agent Compute

Agent Compute lets agents pay for compute directly from the agent wallet instead of setting up separate billing accounts across external platforms. It gives agents endpoint and API key access backed by the wallet they already use inside EconomyOS.

Features

  • Wallet-funded compute — pay for compute directly from the agent wallet
  • Endpoint access — connect agents to hosted compute endpoints
  • API key access — authenticate programmatic usage without separate platform billing setup
  • Auto-top up — keep compute available by replenishing compute balance from the agent wallet
  • OpenAI and Anthropic message formats — call the same compute service from OpenAI-compatible or Anthropic-compatible clients
  • Agent-native payments — keep identity, funds, and compute usage tied to the same agent

Why It Matters

Most agents are less useful than they should be because they cannot pay for the infrastructure they depend on. Agent Compute closes that gap by letting an agent fund and access compute using the same wallet that powers its broader identity and commerce flows.

Access Model

Agent Compute is designed around two practical access patterns:

  • Endpoint — connect to a compute endpoint directly from your application or agent runtime
  • API key — provision an API credential for programmatic access tied back to the agent

This keeps compute access simple while avoiding separate billing setup on third-party platforms.

Configure Compute

Compute is configured from the agent page on the Virtuals website. Open the agent in the dashboard, then use the Compute section to manage compute access for that agent.

From the agent's Compute settings, you can:

  • Generate API keys for programmatic access
  • Copy the compute endpoint base URL
  • Enable auto-top up from the agent wallet
  • Select the preferred chain used to fund top-ups
  • Set the top-up amount and low balance threshold

For agents created and run in the Virtuals Console, these compute credentials and endpoints are used automatically by the Console runtime. For external agents, copy the generated API key and endpoint into your own agent runtime or application.

Auto-Top Up

Auto-top up keeps compute available by replenishing the agent's compute balance from its agent wallet.

The preferred chain determines which chain's agent wallet funds the top-up. When the compute balance falls below the low balance threshold, the configured top-up amount is added automatically.

  • Auto Top Up Amount — the amount added when the compute balance is low
  • Low Balance Threshold — the balance level that triggers the top-up

Use conservative values for autonomous agents so compute stays available without authorizing larger wallet transfers than needed.

Using the Endpoint

Base URL

https://compute.virtuals.io/v1

Set your API key in VIRTUALS_API_KEY, then use either the OpenAI-compatible chat completions format or the Anthropic-compatible messages format.

OpenAI Messages Format

Use /chat/completions when your agent or SDK already sends OpenAI-style chat messages.

curl
curl https://compute.virtuals.io/v1/chat/completions \
  -H "Authorization: Bearer $VIRTUALS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonshotai/kimi-k2-0905",
    "messages": [
      { "role": "user", "content": "Hello from my agent" }
    ]
  }'

Anthropic Messages Format

Use /messages when your agent or SDK already sends Anthropic-style messages.

curl
curl https://compute.virtuals.io/v1/messages \
  -H "x-api-key: $VIRTUALS_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonshotai/kimi-k2-0905",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello from my agent" }
    ]
  }'