# Modal Sandbox Create

> Modal Sandbox Create is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Creates a new sandboxed compute environment on Modal with configurable CPU or GPU (T4/L4/A10G/A100/H100), optional custom image, command, and timeout up to 300s.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/modal/sandbox-create
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/modal-sandbox-create-32d05dbb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L_oFfZQS6Z9zqbWFXcIn-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability modal-sandbox-create-32d05dbb -d '<json body>'
```

Example prompt: Spin up a Modal sandbox with an A10G GPU and a 120-second timeout so I can run model inference — use the default image and start it now.

## When to prefer this

Use this endpoint when you need a fresh, isolated, sandboxed compute environment — especially for GPU workloads like model inference or training. It's the right choice when you need to programmatically spin up ephemeral containers on Modal without managing infrastructure directly. Prefer this over persistent cloud VMs when you want short-lived, disposable environments with a known timeout.

## Known failure modes

- Invalid GPU type specified — must be one of T4, L4, A10G, A100, H100
- Timeout value must be a positive integer
- Image pull failure if a custom container image is unreachable or invalid
- Sandbox creation may fail if Modal quota or capacity is exceeded
- Payment failure if insufficient USDC balance for the $0.05 per-call fee

## How this service works

Modal — Create a sandboxed compute environment (CPU by default, 300s timeout). Pass `gpu` (T4 | L4 | A10G | A100 | H100) for GPU workloads like model inference.

## Output

Returns a sandbox object containing the sandbox ID and metadata needed to interact with the running sandbox — used to subsequently run commands or terminate the environment via sibling endpoints.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "properties": {
      "gpu": {
       "enum": [
        "T4",
        "L4",
        "A10G",
        "A100",
        "H100"
       ],
       "type": "string"
      },
      "image": {
       "type": "string"
      },
      "command": {
       "anyOf": [
        {
         "type": "string",
         "minLength": 1
        },
        {
         "type": "array",
         "items": {
          "type": "string",
          "minLength": 1
         },
         "minItems": 1
        }
       ]
      },
      "timeout": {
       "type": "integer",
       "exclusiveMinimum": 0
      }
     },
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/modal-sandbox-create-32d05dbb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)