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: truekallas ”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.
| Profil | Resurser | Pris |
|---|---|---|
small | 2 vCPU, 4 GB RAM | $0.036 / timme |
default | 4 vCPU, 8 GB RAM | $0.072 / timme |
large | 8 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
| Metod | Sökväg | Beskrivning |
|---|---|---|
POST | /api/v1/sandboxes | Skapa en sandlåda. Body: {"profile": "small" | "default" | "large"} |
GET | /api/v1/sandboxes | Lista dina sandlådor |
GET | /api/v1/sandboxes/{id} | Hämta en sandlåda |
POST | /api/v1/sandboxes/{id}/commands | Kör ett skalkommando |
GET | /api/v1/sandboxes/{id}/commands/{process_id} | Status och utdata för ett frikopplat kommando |
PUT | /api/v1/sandboxes/{id}/files | Skriv en fil |
GET | /api/v1/sandboxes/{id}/files?path= | Läs en fil |
POST | /api/v1/sandboxes/{id}/stop | Stoppa (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ält | Typ | Standardvärde | Anmärkningar |
|---|---|---|---|
command | string | obligatoriskt | Skalkommando, upp till 20 000 tecken |
timeout_seconds | integer | 30 | 1 till 600 |
detached | boolean | false | Kör i bakgrunden; kontrollera status med det returnerade process_id |
cwd | string | . | 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
runninginom 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": "..."}}.
| Status | Kod | Betydelse |
|---|---|---|
| 400 | INVALID_PROFILE | Okänt profile |
| 402 | INSUFFICIENT_CREDITS | Saldo under minimibeloppet på $1 för att skapa eller återuppta |
| 422 | INVALID_INPUT | Ett fält saknas eller ligger utanför tillåtet intervall (uppgiftsbaserade endpoints) |
| 502 | SANDBOX_UPSTREAM_ERROR | Tillfä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.