# SpAItial API (Echo) (slim)

> SpAItial's developer API and hosted MCP server for its Echo world models, which turn a text prompt, image or 360-degree panorama into an explorable 3D Gaussian-splat world with mesh and floor-plan exports. Echo-3 capture reconstruction is enterprise-only.

- Full: https://www.anchorterminal.com/tools/spaitial.md (~7,650 tokens) · this version ~2,030 tokens · JSON https://www.anchorterminal.com/tools/spaitial.json · canonical https://www.anchorterminal.com/tools/spaitial
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-10-28 · pricing https://www.anchorterminal.com/tools/spaitial#pricing · reviews https://www.anchorterminal.com/tools/spaitial#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**C · 56.7/100 · rank #731 of 1221 · #1 in 3D worlds · not agent-ready · confidence medium**


Assessment: Self-serve keys, 800 free credits a month (about five Echo-2 worlds), a public OpenAPI file, idempotency keys and signed webhooks make the async world flow easy to automate. Echo-3, released on 27 October, isn't on the self-serve API, commercial use needs the $99.99 Pro plan, and inputs and outputs may be used for training.

## Facts

- Kind: HTTP API · vendor: SpAItial · category: 3D worlds · legal entity: SpAItial Ltd · provenance 81/100
- Endpoint: `https://api.spaitial.ai/v1` (HTTP, Streamable HTTP)
- Auth: API key · pricing: Freemium · x402: no · licence: Proprietary hosted service under SpAItial's Terms of Service (last updated 27 October 2026, English law). The agent skill (spaitial-dev/spaitial-api-skill) and the Claude plugin (spaitial-ai/spaitial-ai-plugin) are MIT-licensed; the models and the MCP server are closed
- Probe metrics: not measured yet (probes haven't run)
- Surface listed: The SpAItial Developer API at api.spaitial.ai/v1 and the hosted MCP server at mcp.spaitial.ai/mcp (15 tools, each mapped to an API call), read from the API docs, llms-full.txt, the OpenAPI file, the MCP server card, the agent skill and Claude plugin repositories, the terms, privacy, security and subprocessor pages and the Echo-3 release post on 28 October 2026. No account was created and no API or MCP call was made
- Self-serve models: echo-2 (Echo 2, 160 credits, about 8 to 9 minutes) and echo-hq (Echo 2 HQ, 800 credits, about 60 minutes), enabled on every developer account. Extra models appear in GET /v1/models only when granted
- Echo-3: Released 27 October 2026 in the SpAItial iOS app (Android 'coming soon'). Metric-scale reconstruction from a phone capture. On the API it is Enterprise-only, sold through the partnerships form. App pricing is 300 credits a minute of scan, 900 minimum; Standard includes 25 capture minutes a month, Pro 50, Free none
- Inputs: Text prompt (up to 2,000 characters), image by HTTPS URL, base64 or uploaded file_id (JPEG, PNG, WebP or GIF, 25 MB), equirectangular 360-degree panorama (is_pano), or an edited panorama (panorama_id). Panorama edits take a prompt and up to 3 reference images
- Outputs: Gaussian splat as SPZ (default), SOG or PLY, plus panorama, thumbnail and a hosted viewer URL. Exports of a full mesh and a simplified collision mesh (PLY), a top-down floor-plan PNG (not a measured plan) and a zip bundle. SPZ positions are in the RDF (y-down) frame
- Typical job time: Async. Echo-2 about 8 to 9 minutes (522 seconds estimated), Echo HQ about 60 minutes, per GET /v1/models and the docs. Webhook on completion, failure, cancellation and export events, or polling
- Free tier: Free plan, 800 credits a month that don't roll over, enough for about five Echo-2 worlds or one Echo HQ world. One app page calls it a one-time 800-credit starter balance, and the plans table lists API access under Standard, while the API docs say API access is public for all users
- Commercial use: Free and Standard outputs are for personal, non-commercial or evaluation use only, and buying credits doesn't change that. Pro (paid, or during its free trial on a temporary basis) and Enterprise allow commercial use
- Rate limits: Per key, 60 requests a minute in general, 10 world creations a minute and 120 downloads a minute, with X-RateLimit headers and Retry-After on 429. The LLM Skills page lists different buckets (300 a minute for status, 120 for everything else). Concurrent generations per account are capped (429 WORLD_USER_LIMIT) with no published number
- Data use: The terms let SpAItial retain and use inputs and generated worlds to train its models. Uploaded files and edited panoramas expire after 24 hours. The security page says data is deleted within 30 days of a verified request
- Agent access: REST API with a public OpenAPI 3.0 file, a hosted MCP server (bring your own key), an MIT-licensed agent skill for coding assistants and a Claude plugin. No official SDK package. Keys come from a person signing up at developers.spaitial.ai
- Prices: Echo-2 world (text, image or panorama) $1.60 per transaction; Echo HQ world $8 per transaction; Echo-3 capture processing (app; API by enterprise contract) $9 per transaction; Credit $0.01 per credit; Standard plan $49.99 per month (plan); Pro plan $99.99 per month (plan)

- Scores: Reliability 45, Performance pending, Schema & documentation 81, Agent ergonomics 82, Security & auth 53, Payments & pricing 40, Task success pending, Maintenance & community 48, Transparency & trust 66 · negative events -3 · total over the 7 assessed categories
- Why: Reliability, Hosted-API reading. · Schema & documentation, Public OpenAPI 3.0 file at api.spaitial.ai/v1/openapi.json with 25 operations and strict request schemas, though responses carry no schemas… · Agent ergonomics, Small JSON responses, a cheap status endpoint separate from the full result, and a 15-tool MCP server that maps one-to-one to the API (20 of… · Security & auth, Model reading of the checklist, as for the video-generation listings (credential, training, retention, operator visibility, programme). · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, Model reading. · Transparency & trust, Closed models with clear terms, updated 27 October 2026, that give the user ownership of outputs and set commercial use by plan (15).
- Sources: 27, open questions: 8, both in the full twin
- Capabilities: 3d.world-generate, 3d.export
- JSON: https://www.anchorterminal.com/api/v1/tools/spaitial.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/spaitial.svg` or a link to https://www.anchorterminal.com/tools/spaitial from a page on spaitial.ai or one of its subdomains, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.
- Support: support@spaitial.ai; https://spaitial.ai/support; https://docs.spaitial.ai/api/getting-started; more in the full twin

## Before you call it

1. Always send `model` (`echo-2` or `echo-hq`). Since a change dated 14 October, a missing model or `default` returns 400 INVALID_INPUT
2. Send an Idempotency-Key on POST /v1/worlds and POST /v1/panoramas/edit so a retry after a timeout isn't charged twice
3. Pass `webhook.url` or poll GET /v1/worlds/requests/{id}/status every 5 to 10 seconds. Echo-2 takes about 8 to 9 minutes, Echo HQ about an hour
4. Download through the /splat, /panorama or export download_url endpoints just before use; each redirect is a signed URL valid for about 5 minutes
5. Worlds made in the web app aren't visible to the API or MCP server. Create through the API if the agent must read the result back

## Connect

```bash
npx skills add spaitial-dev/spaitial-api-skill
```

```bash
curl -sX POST https://api.spaitial.ai/v1/worlds \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "echo-2",
    "input": {
      "type": "text",
      "prompt": "A sunlit Tuscan villa courtyard at golden hour"
    }
  }'
```

```bash
claude mcp add --transport http spaitial https://mcp.spaitial.ai/mcp --header "X-Spaitial-Api-Key: spt_live_YOUR_KEY"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/spaitial

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| World Labs World API (Marble) | D | 50.1 | 3d.world-generate, 3d.export | https://www.anchorterminal.com/tools/world-labs.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)