Sandbox-API

Sandbox-API:t ger din kod eller AI-agent en isolerad Linuxmaskin i molnet på begäran. Skapa en sandlåda, kör skalkommandon, läs och skriv filer och stoppa eller ta bort den – allt via REST med samma x-api-key och kreditsaldo som du använder för att generera bilder, video och ljud.

Inte samma sak som Sandbox-testnycklar. API-nycklar som skapas med is_test: true kallas ”sandboxnycklar” och returnerar simulerade resultat för genereringsendpoints (se API-referensen). Sandbox-API:t som beskrivs här skapar riktiga maskiner i molnet. En testnyckel kan anropa Sandbox-API:ts endpoints, men den returnerar ett simulerat resultat och skapar ingenting.

Storlekar och priser

Ange profile när du skapar en sandlåda. Du debiteras per sekund medan sandlådan körs, från dina krediter.

ProfilResurserPris
small2 vCPU, 4 GB RAM$0.036 / timme
default4 vCPU, 8 GB RAM$0.072 / timme
large8 vCPU, 16 GB RAM$0.144 / timme
  • Timpriset låses när sandlådan skapas.
  • Stoppade sandlådor är kostnadsfria. Filerna behålls medan sandlådan är stoppad.
  • Du behöver ett saldo på minst $1 för att skapa eller återuppta en sandlåda.

Snabbstart

export MUAPI_KEY="your-api-key"

# 1. Skapa en sandlåda
curl -X POST https://api.muapi.ai/api/v1/sandboxes \
  -H "x-api-key: $MUAPI_KEY" -H "Content-Type: application/json" \
  -d '{"profile": "default"}'
# -> {"id": "…", "state": "running", "profile": "default", "vcpu": 4, "memory_gb": 8, "price_per_hour": 0.072, …}

export ID="<id from the response>"

# 2. Kör ett kommando
curl -X POST https://api.muapi.ai/api/v1/sandboxes/$ID/commands \
  -H "x-api-key: $MUAPI_KEY" -H "Content-Type: application/json" \
  -d '{"command": "python3 --version", "timeout_seconds": 30}'

# 3. Skriv och läs en fil
curl -X PUT https://api.muapi.ai/api/v1/sandboxes/$ID/files \
  -H "x-api-key: $MUAPI_KEY" -H "Content-Type: application/json" \
  -d '{"path": "/home/user/hello.py", "content": "print(\"hi\")"}'

curl "https://api.muapi.ai/api/v1/sandboxes/$ID/files?path=/home/user/hello.py" \
  -H "x-api-key: $MUAPI_KEY"

# 4. Stoppa den (debiteringen pausas)
curl -X POST https://api.muapi.ai/api/v1/sandboxes/$ID/stop \
  -H "x-api-key: $MUAPI_KEY"

Python

import os, requests

BASE = "https://api.muapi.ai/api/v1/sandboxes"
H = {"x-api-key": os.environ["MUAPI_KEY"]}

sb = requests.post(BASE, headers=H, json={"profile": "small"}).json()
sid = sb["id"]

out = requests.post(f"{BASE}/{sid}/commands", headers=H,
                    json={"command": "echo hello && uname -a"}).json()
print(out)

requests.post(f"{BASE}/{sid}/stop", headers=H)

Endpoints

MetodSökvägBeskrivning
POST/api/v1/sandboxesSkapa en sandlåda. Body: {"profile": "small" | "default" | "large"}
GET/api/v1/sandboxesLista dina sandlådor
GET/api/v1/sandboxes/{id}Hämta en sandlåda
POST/api/v1/sandboxes/{id}/commandsKör ett skalkommando
GET/api/v1/sandboxes/{id}/commands/{process_id}Status och utdata för ett frikopplat kommando
PUT/api/v1/sandboxes/{id}/filesSkriv en fil
GET/api/v1/sandboxes/{id}/files?path=Läs en fil
POST/api/v1/sandboxes/{id}/stopStoppa (debiteringen pausas)
POST/api/v1/sandboxes/{id}/resumeÅteruppta en stoppad sandlåda
DELETE/api/v1/sandboxes/{id}Ta bort en sandlåda och dess filer

Kör ett kommando

POST /api/v1/sandboxes/{id}/commands

FältTypStandardvärdeAnmärkningar
commandstringobligatorisktSkalkommando, upp till 20 000 tecken
timeout_secondsinteger301 till 600
detachedbooleanfalseKör i bakgrunden; kontrollera status med det returnerade process_id
cwdstring.Arbetskatalog. Den måste redan finnas (kör till exempel mkdir -p /home/user/workspace först)

För långa jobb anger du detached: true och kontrollerar sedan status med GET /api/v1/sandboxes/{id}/commands/{process_id}.

Filer

PUT /files tar emot {"path": "...", "content": "..."} med vanlig text som innehåll (upp till 2 000 000 tecken). GET /files?path=... returnerar {"path": "...", "content": "..."}.

Livscykel och debitering

  • En ny sandlåda har status running inom ett par sekunder och Python 3 är förinstallerat.
  • Stopp är inte omedelbart. Debiteringen upphör när du begär stopp, men om du återupptar sandlådan direkt kan anropet returnera en konflikt i några sekunder. Stoppanropet väntar på att sandlådan ska arkiveras innan det returnerar, så det är säkert att stoppa och sedan återuppta den.
  • Filerna finns kvar när du stoppar och återupptar sandlådan.
  • En sandlåda stoppas automatiskt när saldot inte räcker för att täcka användningen eller efter 15 minuter utan aktivitet.
  • En stoppad sandlåda tas bort efter 14 dagar. Ladda ner allt du behöver innan dess.
  • Varje konto kan ha upp till 3 sandlådor åt gången.
  • Kommandon och filåtkomst körs som en vanlig användare i en isolerad maskin. Du ansvarar för vad du kör där.

Playground och uppgiftsbaserade endpoints

Alla åtgärder finns också i Playground och som uppgiftsbaserade endpoints: POST /api/v1/sandbox-<operation>, där <operation> är en av create, get, run-command, command-status, write-file, read-file, stop, resume, delete. De tar emot samma fält som REST-rutterna, plus sandbox_id när det är relevant, och returnerar ett request_id som du hämtar via GET /api/v1/predictions/{request_id}/result, precis som för andra Muapi-modeller. Beräkning debiteras bara för tiden sandlådan körs; själva anropen kostar $0.

Fel

Fel använder formatet {"error": {"code": "...", "message": "..."}}.

StatusKodBetydelse
400INVALID_PROFILEOkänt profile
402INSUFFICIENT_CREDITSSaldo under minimibeloppet på $1 för att skapa eller återuppta
422INVALID_INPUTEtt fält saknas eller ligger utanför tillåtet intervall (uppgiftsbaserade endpoints)
502SANDBOX_UPSTREAM_ERRORTillfälligt backendfel, försök igen

Användningsområden

  • Kodningsagenter: klona ett repo, installera paket, köra tester och åtgärda fel på en riktig maskin.
  • Kodkörning: kör genererad eller opålitlig kod utanför din egen infrastruktur.
  • Mediepipelines: kör ffmpeg eller anpassade skript på utdata från Muapis bild-, video- och ljudmodeller.
  • Värdbaserade appar med öppen källkod: kör appar i molnet med användarens egen Muapi-nyckel.

Se landningssidan för Sandbox-API:t för en översikt.