EN Kostenlos starten

Doku

Quickstart

Von der Registrierung zur ersten VM-Sandbox. Starten Sie mit der quelloffenen eai CLI oder rufen Sie die REST-API direkt auf. Die Basis-URL der API lautet https://hive-api.hive.eai.onl.

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:

install
curl -fsSL https://raw.githubusercontent.com/cierrateam/eai-cli/main/install.sh | sh

Oder mit Homebrew:

Homebrew
brew install cierrateam/tap/eai

Erstellen Sie ein Konto und melden Sie sich an. Für das Free Tier brauchen Sie keine Kreditkarte.

Konto
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.

run
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:

Auflisten und löschen
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.

Pro anfragen Preise ansehen

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.

Zur Registrierung

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:

shell
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").

POST /sandbox
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:

Antwort (Beispiel, gekürzt)
{
  "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:

shell
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:

GET /sandbox/{id}
curl -s "$API/sandbox/$SANDBOX_ID" \
  -H "Authorization: Bearer $HIVE_API_KEY"
FeldBedeutung
statusÜbergeordneter Zustand, zum Beispiel pending, running, succeeded oder failed
readytrue, sobald der Container läuft. Nützlich für Dienste, die einen Port freigeben
exit_codeExit-Code Ihres Befehls, sobald er beendet ist (0 bedeutet Erfolg)
expires_atZeitpunkt, 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:

GET /sandbox/{id}/logs
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:

POST /sandbox/{id}/extend
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:

DELETE /sandbox/{id}
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.

FeldTypBeschreibung
imageStringEin beliebiges OCI-Image, zum Beispiel python:3.12-slim oder Ihr eigenes Docker-Image
commandListe von StringsBefehl, der statt des Standardbefehls des Images ausgeführt wird
restartString"never" für einmalige Jobs, die bis zu ihrem Ende laufen, "always" für Dienste, die dauerhaft laufen sollen
ttlIntegerLebensdauer in Sekunden. Im Free Tier höchstens 3600 (1 Stunde)
cpu_milliIntegerCPU in Millicores. 1000 entspricht einer vCPU
memory_miIntegerArbeitsspeicher in MiB
portIntegerPort Ihres Dienstes in der Sandbox. Er wird unter der Sandbox-URL https://<id>.hive.eai.onl bereitgestellt
envObjektUmgebungsvariablen als Schlüssel und Werte vom Typ String
internetString"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.

POST /sandbox · Dienst mit Port
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

GrenzeFree Tier
Sandbox-Stunden20 Stunden pro Monat
Gleichzeitige SandboxesBis zu 2
CPU pro SandboxBis zu 2 vCPU (cpu_milli ≤ 2000)
Arbeitsspeicher pro SandboxBis zu 2 GB RAM (memory_mi ≤ 2048)
Laufzeit pro SandboxBis zu 1 Stunde pro Lauf
Ausgehende E-MailsDie Ports 25, 465 und 587 sind gesperrt, um Missbrauch zu verhindern
KreditkarteNicht 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.

Pro anfragen

Fehlercodes

Fehler werden als JSON mit einer Meldung im Feld detail zurückgegeben, die beschreibt, was schiefgelaufen ist.

HTTP-StatusBedeutungWas zu tun ist
401Ungültiger oder fehlender API-SchlüsselPrüfen Sie den Header Authorization und den Schlüssel
402Grenze des Free Tier: Monatsstunden aufgebraucht oder mehr CPU, Arbeitsspeicher oder Laufzeit angefordert, als der Tarif erlaubtReduzieren Sie die Anfrage, warten Sie auf den nächsten Monat oder fragen Sie uns nach kostenpflichtigen Tarifen
403Konto gesperrtWenden Sie sich an info@cierra.ai
422Validierungsfehler im Body der AnfrageKorrigieren Sie den Body. Die Meldung nennt das betroffene Feld
429Zu viele gleichzeitige SandboxesLöschen Sie eine laufende Sandbox oder warten Sie, bis eine abläuft
503no_capacity: derzeit keine freie KapazitätVersuchen Sie es in Kürze erneut, am besten mit kurzem Backoff
Die vollständige und stets aktuelle Beschreibung der API finden Sie in der OpenAPI-Referenz.