GPU Rental 6 Min. Lesezeit

API-Referenz

Verwalten Sie Ihre GPU-Instanzen programmatisch. Erfahren Sie, wie Sie sich authentifizieren, Instanzen erstellen, den Status prüfen und mehr über die GPUnex-API.

Ihren API-Schlüssel erhalten

Die GPUnex-API ermöglicht es Ihnen, GPU-Instanzen zu verwalten, Guthaben zu prüfen und Ihre Workflows zu automatisieren, ohne das Web-Dashboard zu verwenden. Bevor Sie API-Anfragen stellen können, müssen Sie einen API-Schlüssel generieren.

Melden Sie sich bei Ihrem GPUnex-Konto an und navigieren Sie zu Ihrer Profilseite oder dem Dashboard-Einstellungsbereich.
Öffnen Sie den Bereich API-Schlüssel. Suchen Sie den Tab oder die Karte API-Schlüssel in Ihren Kontoeinstellungen.
Klicken Sie auf “Neuen API-Schlüssel erstellen”. Sie werden aufgefordert, dem Schlüssel einen beschreibenden Namen zu geben. Wählen Sie einen aussagekräftigen Namen, der den Verwendungszweck des Schlüssels identifiziert — zum Beispiel “Produktionsserver”, “CI/CD-Pipeline” oder “Lokale Entwicklung”. So lassen sich mehrere Schlüssel später leichter verwalten.
Kopieren Sie Ihren API-Schlüssel sofort. Sobald der Schlüssel generiert wurde, wird er genau einmal angezeigt. Kopieren Sie ihn und bewahren Sie ihn an einem sicheren Ort auf, z. B. in einem Passwort-Manager oder einem verschlüsselten Secrets-Vault. Sie können den vollständigen Schlüssel nach diesem Schritt nicht mehr einsehen.
Verstehen Sie Schlüssel-Berechtigung und Widerruf. Jeder API-Schlüssel ist Ihrem Konto zugeordnet und erbt Ihre Kontoberechtigungen. Sie können mehrere Schlüssel für verschiedene Anwendungen oder Umgebungen erstellen. Wenn ein Schlüssel kompromittiert wird oder nicht mehr benötigt wird, können Sie ihn jederzeit im Bereich API-Schlüssel widerrufen. Der Widerruf erfolgt sofort und dauerhaft — alle Anfragen mit diesem Schlüssel werden abgelehnt.

Authentifizierung

Alle Anfragen an die GPUnex-API müssen einen Authorization-Header mit Ihrem API-Schlüssel im Bearer-Token-Schema enthalten.

Header-Format:

Authorization: Bearer YOUR_API_KEY

Terminal

$

Wenn der API-Schlüssel fehlt, ungültig oder widerrufen ist, gibt die API eine 401 Unauthorized-Antwort zurück:

{
  "error": "unauthorized",
  "message": "Invalid or missing API key. Please check your Authorization header."
}

Stellen Sie sicher, dass Ihr Schlüssel in jeder Anfrage enthalten ist. Die API unterstützt keine sitzungsbasierte oder cookie-basierte Authentifizierung.

Kern-Endpunkte

Die GPUnex-API ist nach RESTful-Ressourcen organisiert. Alle Endpunkte verwenden die Basis-URL https://api.gpunex.com/v1. Nachfolgend finden Sie eine Übersicht der verfügbaren Kern-Endpunkte.

Methode	Endpunkt	Beschreibung
GET	`/v1/instances`	Listet alle Ihre aktiven und kürzlichen Instanzen auf. Gibt ein Array von Instanzobjekten mit aktuellem Status, GPU-Modell und Konfigurationsdetails zurück.
POST	`/v1/instances`	Erstellt eine neue GPU-Instanz. Erfordert einen JSON-Body mit GPU-Modell, Framework und Region. Die Kosten werden von Ihrem USDC-Guthaben abgezogen.
GET	`/v1/instances/:id`	Ruft detaillierte Informationen zu einer bestimmten Instanz anhand ihrer eindeutigen ID ab. Enthält SSH-Verbindungsdetails, Laufzeitmetriken und Abrechnungsinformationen.
DELETE	`/v1/instances/:id`	Beendet eine laufende Instanz. Die Instanz wird gestoppt und es fallen keine weiteren Kosten an. Nicht gespeicherte Daten auf der Instanz gehen verloren.
GET	`/v1/gpu-models`	Listet alle aktuell auf dem Marktplatz verfügbaren GPU-Modelle auf. Enthält Preise, VRAM, Verfügbarkeit nach Region und unterstützte Frameworks.
GET	`/v1/balance`	Prüft Ihr aktuelles USDC-Wallet-Guthaben und eine aktuelle Transaktionsübersicht.

Alle Antworten werden im JSON-Format zurückgegeben. Erfolgreiche Anfragen geben einen 200 OK-Statuscode für GET-Anfragen und einen 201 Created-Statuscode für POST-Anfragen zurück, die Ressourcen erstellen.

Beispiel: Instanz erstellen

Um eine neue GPU-Instanz zu erstellen, senden Sie eine POST-Anfrage an /v1/instances mit einem JSON-Body, der Ihre gewünschte Konfiguration enthält.

Anfrage:

Terminal

$

Parameter des Anfrage-Body:

Parameter	Typ	Erforderlich	Beschreibung
`gpu_model`	string	Ja	Die GPU-Modell-Kennung. Verwenden Sie `/v1/gpu-models`, um verfügbare Optionen anzuzeigen (z. B. `H100_80GB`, `A100_80GB`, `L40S_48GB`, `L4_24GB`).
`framework`	string	Ja	Das vorinstallierte Framework und die Version (z. B. `pytorch-2.3`, `tensorflow-2.16`, `jax-0.4`).
`region`	string	Ja	Die Rechenzentrumsregion für die Instanz (z. B. `us-east-1`, `eu-west-1`, `ap-southeast-1`).

Beispielantwort (201 Created):

{
  "id": "inst_7f3a9b2c4d1e",
  "status": "provisioning",
  "gpu_model": "A100_80GB",
  "framework": "pytorch-2.3",
  "region": "us-east-1",
  "ssh_command": null,
  "hourly_rate": "1.89",
  "currency": "USDC",
  "created_at": "2026-02-15T14:32:07Z"
}

Die Instanz hat zunächst den Status provisioning. Sobald die GPU zugewiesen und die Umgebung bereit ist, wechselt der Status zu running und das Feld ssh_command wird mit Ihrer Verbindungszeichenkette befüllt. Die Bereitstellung dauert in der Regel zwischen 30 Sekunden und 2 Minuten, abhängig von der Verfügbarkeit.

Beispiel: Instanzstatus prüfen

Nachdem Sie eine Instanz erstellt haben, können Sie ihren aktuellen Status jederzeit über den Instanz-Endpunkt mit ihrer ID abfragen.

Anfrage:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.gpunex.com/v1/instances/inst_7f3a9b2c4d1e

Beispielantwort (200 OK):

{
  "id": "inst_7f3a9b2c4d1e",
  "status": "running",
  "gpu_model": "A100_80GB",
  "framework": "pytorch-2.3",
  "region": "us-east-1",
  "ssh_command": "ssh [email protected] -p 2222",
  "ip_address": "203.0.113.42",
  "hourly_rate": "1.89",
  "currency": "USDC",
  "uptime_seconds": 3847,
  "total_cost": "2.02",
  "created_at": "2026-02-15T14:32:07Z",
  "started_at": "2026-02-15T14:33:15Z"
}

Statuswerte:

Status	Bedeutung
`provisioning`	Die Instanz wird eingerichtet. GPU-Ressourcen werden zugewiesen und die Framework-Umgebung wird vorbereitet.
`running`	Die Instanz ist aktiv und einsatzbereit. SSH-Zugriff ist verfügbar.
`stopping`	Die Instanz wird gerade heruntergefahren.
`terminated`	Die Instanz wurde gestoppt und verursacht keine weiteren Kosten.
`error`	Während der Bereitstellung oder Laufzeit ist ein Fehler aufgetreten. Wenden Sie sich an den Support, wenn dies anhält.

Ratenlimits und Best Practices

Ratenlimits

Die GPUnex-API setzt Ratenlimits durch, um eine faire Nutzung und Plattformstabilität zu gewährleisten. Die aktuellen Limits sind:

Allgemeine Endpunkte: 120 Anfragen pro Minute pro API-Schlüssel.
Instanzerstellung: 10 Anfragen pro Minute pro API-Schlüssel.
Guthaben- und Nur-Lese-Endpunkte: 300 Anfragen pro Minute pro API-Schlüssel.

Wenn Sie das Ratenlimit überschreiten, gibt die API eine 429 Too Many Requests-Antwort mit einem Retry-After-Header zurück, der angibt, wie viele Sekunden Sie warten sollten, bevor Sie es erneut versuchen.

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Please retry after 12 seconds.",
  "retry_after": 12
}

Best Practices

Befolgen Sie diese Richtlinien, um Ihre Integration sicher und zuverlässig zu halten.

Geben Sie API-Schlüssel niemals in clientseitigem Code preis. Betten Sie Ihren API-Schlüssel nicht in JavaScript ein, das im Browser läuft, in Mobile-App-Quellcode oder in öffentlich zugängliche Repositories. API-Schlüssel sollten nur in serverseitigen Anwendungen verwendet werden, wo sie nicht von Endbenutzern eingesehen werden können.

Wichtig

Geben Sie Ihren API-Schlüssel niemals in clientseitigem Code, Browser-JavaScript oder öffentlichen Repositories preis. API-Schlüssel sollten nur in serverseitigen Anwendungen verwendet werden.

Verwenden Sie Umgebungsvariablen. Speichern Sie Ihren API-Schlüssel in einer Umgebungsvariablen, anstatt ihn in Ihren Quelldateien fest zu codieren. Zum Beispiel:
```
export GPUNEX_API_KEY="your_api_key_here"
```
Referenzieren Sie ihn dann in Ihrem Code:
```
curl -H "Authorization: Bearer $GPUNEX_API_KEY" https://api.gpunex.com/v1/instances
```
Rotieren Sie Schlüssel regelmäßig. Als bewährte Sicherheitspraxis sollten Sie alle 90 Tage einen neuen API-Schlüssel generieren und den alten widerrufen. Dies begrenzt die Auswirkungen, falls ein Schlüssel versehentlich offengelegt wird.
Verwenden Sie separate Schlüssel für separate Umgebungen. Erstellen Sie unterschiedliche API-Schlüssel für Entwicklung, Staging und Produktion. So wird durch den Widerruf eines Schlüssels keine andere Umgebung beeinträchtigt.

Tipp

Verwenden Sie separate API-Schlüssel für Entwicklung, Staging und Produktion. So wird durch den Widerruf eines Schlüssels keine andere Umgebung beeinträchtigt.

Behandeln Sie Fehler ordnungsgemäß. Prüfen Sie in Ihrer Anwendung immer die HTTP-Statuscodes. Implementieren Sie eine Wiederholungslogik mit exponentiellem Backoff für 429- und 5xx-Antworten. Wiederholen Sie keine 4xx-Fehler außer 429 — diese weisen auf ein Problem mit der Anfrage selbst hin.
Überwachen Sie Ihre Nutzung. Behalten Sie Ihr API-Aufrufvolumen und Ihre Instanzausgaben im Blick. Verwenden Sie den /v1/balance-Endpunkt, um Ihr USDC-Guthaben programmatisch zu überwachen und Benachrichtigungen einzurichten, wenn es unter einen Schwellenwert fällt.