Der schnellste Weg: die eai CLI
Die eai CLI ist Open Source (Apache-2.0) und spricht mit derselben REST-API, die weiter unten beschrieben ist. Installieren Sie sie mit dem Installationsskript:
curl -fsSL https://raw.githubusercontent.com/cierrateam/eai-cli/main/install.sh | sh
Oder mit Homebrew:
brew install cierrateam/tap/eai
Erstellen Sie ein Konto und melden Sie sich an. Für das Free Tier brauchen Sie keine Kreditkarte.
eai hive signup
eai hive login
Starten Sie Ihre erste Sandbox. Alles nach -- ist der Befehl, der in der Sandbox läuft, in einer eigenen isolierten virtuellen Maschine. Dieser gibt 42 aus.
eai hive run python:3.12-slim -- python -c "print(6*7)"
Listen Sie Ihre Sandboxes auf und löschen Sie eine anhand ihrer ID:
eai hive list
eai hive delete <id>
Kostenpflichtige Tarife
Sie brauchen mehr als das Free Tier? Pro ist ein monatliches Abo ab 120 EUR im Monat (netto zzgl. USt.) mit Nutzungsguthaben inklusive, bis zu 20 gleichzeitigen Sandboxes, bis zu 8 vCPU / 16 GB RAM und bis zu 24 Stunden Laufzeit pro Sandbox. Pay as you go nutzt Prepaid-Guthaben ab 10 EUR, abgerechnet pro Minute. Der Online-Checkout ist noch nicht freigeschaltet: Schreiben Sie uns, wir stellen Ihr Konto um, Ihr CLI-Login bleibt gleich.
CLI auf GitHubOpen Source, Apache-2.0
Oder per REST API
Lieber reines HTTP? Die folgenden Schritte erledigen dasselbe mit curl. Sie funktionieren ebenso mit jedem anderen HTTP-Client.
Registrieren und E-Mail bestätigen
Erstellen Sie ein Konto im HIVE Portal. Wir senden Ihnen eine Bestätigungs-E-Mail. Klicken Sie auf den Link darin, um Ihr Konto zu aktivieren. Für das Free Tier brauchen Sie keine Kreditkarte.
API-Schlüssel erstellen
Melden Sie sich im Portal an und erstellen Sie einen API-Schlüssel für Ihr Team. Der Schlüssel wird nur einmal angezeigt. HIVE speichert ausschließlich einen Hashwert davon. Kopieren Sie ihn deshalb sofort in Ihren Passwortmanager oder Secret Store. Wenn Sie ihn verlieren, erstellen Sie einen neuen Schlüssel und löschen Sie den alten.
Exportieren Sie den Schlüssel in Ihrer Shell, damit die folgenden Beispiele unverändert funktionieren:
export HIVE_API_KEY="paste-your-key-here"
export API="https://hive-api.hive.eai.onl"
Jede Anfrage überträgt den Schlüssel im Header Authorization: Bearer $HIVE_API_KEY.
Sandbox erstellen
Eine POST-Anfrage startet eine Sandbox aus einem OCI-Image. Jede Sandbox läuft in ihrer eigenen isolierten virtuellen Maschine. Dieses Beispiel führt einen einzelnen Python-Befehl aus und beendet sich danach ("restart": "never").
curl -s -X POST "$API/sandbox" \
-H "Authorization: Bearer $HIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "python:3.12-slim",
"command": ["python", "-c", "print(6*7)"],
"restart": "never",
"ttl": 600,
"cpu_milli": 1000,
"memory_mi": 1024
}'
Die Antwort enthält die Sandbox-ID, die öffentliche URL und den Ablaufzeitpunkt:
{
"sandbox_id": "k3v9x2ab",
"url": "https://k3v9x2ab.hive.eai.onl",
"expires_at": "2026-11-17T10:10:00+00:00",
"restart": "never",
"internet": "full"
}
Merken Sie sich die ID für die nächsten Schritte:
export SANDBOX_ID="k3v9x2ab" # use the sandbox_id from your response
Status abfragen
Die Sandbox startet in Sekunden. Fragen Sie den Status ab, bis status Ihnen sagt, was Sie wissen müssen:
curl -s "$API/sandbox/$SANDBOX_ID" \
-H "Authorization: Bearer $HIVE_API_KEY"
| Feld | Bedeutung |
|---|---|
status | Übergeordneter Zustand, zum Beispiel pending, running, succeeded oder failed |
ready | true, sobald der Container läuft. Nützlich für Dienste, die einen Port freigeben |
exit_code | Exit-Code Ihres Befehls, sobald er beendet ist (0 bedeutet Erfolg) |
expires_at | Zeitpunkt, zu dem die Sandbox automatisch entfernt wird |
Alle Sandboxes Ihres Teams listen Sie mit GET /sandboxes auf.
Logs lesen
Standardausgabe und Standardfehlerausgabe Ihres Befehls stehen als Logs bereit:
curl -s "$API/sandbox/$SANDBOX_ID/logs" \
-H "Authorization: Bearer $HIVE_API_KEY"
# {"logs": "42\n"}
Verlängern oder löschen
Eine Sandbox wird automatisch entfernt, sobald ihre TTL abläuft. Wenn Sie sie länger brauchen, verlängern Sie sie. Der neue Ablaufzeitpunkt ist die aktuelle Zeit plus die angegebene TTL in Sekunden:
curl -s -X POST "$API/sandbox/$SANDBOX_ID/extend" \
-H "Authorization: Bearer $HIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ttl": 600}'
Wenn Sie fertig sind, löschen Sie die Sandbox, damit sie nicht mehr zu Ihren gleichzeitigen Sandboxes zählt:
curl -s -X DELETE "$API/sandbox/$SANDBOX_ID" \
-H "Authorization: Bearer $HIVE_API_KEY"
Optionen der Anfrage
Felder des JSON-Bodys für POST /sandbox. Nur image ist erforderlich.
| Feld | Typ | Beschreibung |
|---|---|---|
image | String | Ein beliebiges OCI-Image, zum Beispiel python:3.12-slim oder Ihr eigenes Docker-Image |
command | Liste von Strings | Befehl, der statt des Standardbefehls des Images ausgeführt wird |
restart | String | "never" für einmalige Jobs, die bis zu ihrem Ende laufen, "always" für Dienste, die dauerhaft laufen sollen |
ttl | Integer | Lebensdauer in Sekunden. Im Free Tier höchstens 3600 (1 Stunde) |
cpu_milli | Integer | CPU in Millicores. 1000 entspricht einer vCPU |
memory_mi | Integer | Arbeitsspeicher in MiB |
port | Integer | Port Ihres Dienstes in der Sandbox. Er wird unter der Sandbox-URL https://<id>.hive.eai.onl bereitgestellt |
env | Objekt | Umgebungsvariablen als Schlüssel und Werte vom Typ String |
internet | String | "full", "none" oder "whitelist". Bei "whitelist" übergeben Sie die erlaubten IP-Bereiche als Liste von CIDRs in egress_cidrs |
Beispiel: ein kleiner Webserver, der zehn Minuten lang unter seiner Sandbox-URL erreichbar ist.
curl -s -X POST "$API/sandbox" \
-H "Authorization: Bearer $HIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "python:3.12-slim",
"command": ["python", "-m", "http.server", "8000"],
"port": 8000,
"restart": "always",
"ttl": 600,
"internet": "none"
}'
Grenzen des Free Tier
| Grenze | Free Tier |
|---|---|
| Sandbox-Stunden | 20 Stunden pro Monat |
| Gleichzeitige Sandboxes | Bis zu 2 |
| CPU pro Sandbox | Bis zu 2 vCPU (cpu_milli ≤ 2000) |
| Arbeitsspeicher pro Sandbox | Bis zu 2 GB RAM (memory_mi ≤ 2048) |
| Laufzeit pro Sandbox | Bis zu 1 Stunde pro Lauf |
| Ausgehende E-Mails | Die Ports 25, 465 und 587 sind gesperrt, um Missbrauch zu verhindern |
| Kreditkarte | Nicht erforderlich |
Das Free Tier rechnet die Laufzeit Ihrer Sandboxes auf Ihre monatlichen Stunden an. Sie brauchen mehr? Pro gibt es ab 120 EUR im Monat mit höheren Limits, Pay as you go ab 10 EUR Prepaid-Guthaben.
Fehlercodes
Fehler werden als JSON mit einer Meldung im Feld detail zurückgegeben, die beschreibt, was schiefgelaufen ist.
| HTTP-Status | Bedeutung | Was zu tun ist |
|---|---|---|
401 | Ungültiger oder fehlender API-Schlüssel | Prüfen Sie den Header Authorization und den Schlüssel |
402 | Grenze des Free Tier: Monatsstunden aufgebraucht oder mehr CPU, Arbeitsspeicher oder Laufzeit angefordert, als der Tarif erlaubt | Reduzieren Sie die Anfrage, warten Sie auf den nächsten Monat oder fragen Sie uns nach kostenpflichtigen Tarifen |
403 | Konto gesperrt | Wenden Sie sich an info@cierra.ai |
422 | Validierungsfehler im Body der Anfrage | Korrigieren Sie den Body. Die Meldung nennt das betroffene Feld |
429 | Zu viele gleichzeitige Sandboxes | Löschen Sie eine laufende Sandbox oder warten Sie, bis eine abläuft |
503 | no_capacity: derzeit keine freie Kapazität | Versuchen Sie es in Kürze erneut, am besten mit kurzem Backoff |