Schnellstart

Noch nicht bereit, Code zu schreiben? Probieren Sie das Playground aus — testen Sie jedes Modell direkt in Ihrem Browser, ohne API-Schlüssel.

1. Ein Konto erstellen

Registrieren Sie sich bei runbase.net mit Google oder E-Mail. Keine Kreditkarte erforderlich — neue Konten erhalten kostenloses Guthaben zum Start.

2. Einen API-Schlüssel erhalten

Gehen Sie zu Settings → API Keys und erstellen Sie einen neuen Schlüssel. Bewahren Sie ihn an einem sicheren Ort auf — er beginnt mit sk- und wird nicht noch einmal angezeigt.

export RUNBASE_API_KEY="sk-your-key-here"

3. Einen Run erstellen

Senden Sie eine POST an /api/v1/runs mit einer Modell-ID und Eingabeparametern:

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": {
      "prompt": "A cozy bookshop interior with warm lighting, watercolor style",
      "aspect_ratio": "1:1"
    }
  }'

Antwort:

{
  "id": "run_2abc...",
  "model": "google/nano-banana-2",
  "status": "pending",
  "costUsd": 40000
}

Der costUsd ist in Mikro-USD (1 USD = 1.000.000). Ein Cost von 40.000 bedeutet 0,04 $.

4. Auf das Ergebnis pollen

Verwenden Sie die Run-ID, um den Status zu prüfen:

curl -s https://runbase.net/api/v1/runs/run_2abc... \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Wenn status "succeeded" ist, enthält das Feld output das Ergebnis:

{
  "id": "run_2abc...",
  "status": "succeeded",
  "model": "google/nano-banana-2",
  "costUsd": 40000,
  "output": {
    "urls": [
      "https://runbase.net/files/generated/abc123.png"
    ]
  },
  "createdAt": "2026-06-01T12:00:00.000Z",
  "completedAt": "2026-06-01T12:00:04.200Z"
}

Wenn ein Run fehlschlägt, wird status "failed" sein und die Kosten werden automatisch auf Ihr Guthaben zurückerstattet.

5. Das Bild herunterladen

Die URLs in der Ausgabe sind direkte Links zu den generierten Bildern oder Videos. Sie werden über ein globales CDN ausgeliefert und sind sofort verfügbar.

Wie geht es weiter

• Core Concepts — verstehen Sie den Run-Lebenszyklus, das asynchrone Modell und die Kostenmechanik
• Authentication — richten Sie IP-Whitelisting und Ausgabenlimits für die Produktion ein
• Models — erkunden Sie alle verfügbaren Modelle und testen Sie sie im Playground
• Billing — laden Sie Ihr Guthaben auf und verwalten Sie es