CLI- & SDK-Anleitung

Übersicht

Clore.ai bietet eine REST-API die vollständigen programmgesteuerten Zugriff auf den GPU-Marktplatz ermöglicht — Auflisten von Servern, Erstellen von Bestellungen, Überwachen von Deployments und Stornieren von Vermietungen.

Hinweis: Es gibt derzeit kein offizielles CLI-Binary. Alle Automatisierungen erfolgen direkt über die REST-API mit Tools wie curl, Python oder Node.js.

Basis-URL: https://api.clore.ai/v1

Antwortformat: JSON. Jede Antwort enthält ein code Feld, das den Status angibt.


Authentifizierung

Generieren Sie Ihren API-Schlüssel aus dem Clore.ai Dashboardarrow-up-right:

  1. Melden Sie sich bei Ihrem Konto an

  2. Navigieren Sie zu API Abschnitt in den Einstellungen

  3. Generieren und kopieren Sie Ihren API-Schlüssel

Header-Format:

auth: IHRE_API_KEY

⚠️ Wichtig: Der auth-Header ist auth, nicht Authorization: Bearer. Die Verwendung des falschen Formats gibt den Code 3 (Ungültiges API-Token) zurück.

Beispiel:

curl -H 'auth: IHRE_API_KEY' 'https://api.clore.ai/v1/marketplace'

Schnellstart

Marktplatz-Server auflisten

Durchsuchen Sie alle verfügbaren GPU-Server:

Antwort:


Ihre Bestellungen abrufen

Abgeschlossene/abgelaufene Bestellungen einbeziehen:


Eine Bestellung erstellen (On-Demand)

Antwort:


Einen Spot-Order erstellen

Spot-Bestellungen sind günstiger, können aber überboten werden. Sie legen Ihren Preis pro Tag fest:


Bestellstatus prüfen

Aktive Bestellungen enthalten pub_cluster (Hostnamen) und tcp_ports für SSH-Zugriff:

SSH auf Ihren gemieteten Server:


Eine Bestellung stornieren

Optional können Sie ein Problem mit dem Server melden:


Python SDK

Ein leichter Wrapper, der die requests Bibliothek verwendet. Installieren Sie sie mit:

CloreClient-Klasse

Vollständiges funktionierendes Beispiel


Node.js-Beispiel

Verwendung der nativen fetch API (Node.js 18+):


Gängige Workflows

Günstigste RTX 4090 finden und mieten


Meine Bestellungen überwachen


Automatisch mieten, wenn der Preis unter X fällt


WebSocket

Die Clore.ai REST-API bietet derzeit keinen WebSocket-Endpunkt. Für Echtzeitüberwachung verwenden Sie Polling mit einem angemessenen Intervall (siehe Ratenbegrenzungen unten).


Ratenbegrenzungen

Endpunkt
Limit

Die meisten Endpunkte

1 Anfrage/Sekunde

create_order

1 Anfrage/5 Sekunden

set_spot_price (Preissenkung)

Einmal pro 600 Sekunden

Antwort bei Erreichen des Ratenlimits (Code 5):

Best Practices:

  • Fügen Sie hinzu time.sleep(1) zwischen aufeinanderfolgenden API-Aufrufen

  • Für create_order, warten Sie mindestens 5 Sekunden zwischen Anfragen

  • Verwenden Sie Polling-Intervalle von 60+ Sekunden für Überwachungs-Schleifen

  • Cachen Sie Marktplatzdaten lokal, wenn Sie sie häufig abfragen müssen

Python-Helfer:


Fehlerbehandlung

Jede API-Antwort enthält ein code Feld. Ein Wert von 0 bedeutet Erfolg.

Fehlercodes

Code
Bedeutung
Aktion

0

Erfolg

1

Datenbankfehler

Nach einer Verzögerung erneut versuchen

2

Ungültige Eingabedaten

Überprüfen Sie Ihren Anfragekörper/Parameter

3

Ungültiges API-Token

Überprüfen Sie Ihren API-Schlüssel im Dashboard

4

Ungültiger Endpunkt

Überprüfen Sie die Endpunkt-URL

5

Ratenlimit überschritten (1 req/sec)

Fügen Sie Verzögerungen zwischen Anfragen hinzu

6

Anwendungsfehler (siehe Fehler Feld)

Lesen Sie das Fehler Feld für Details

Code 6 Unterfehler

Fehler Wert

Bedeutung

exceeded_max_step

Spot-Preisreduzierung zu groß; überprüfen Sie max_step Feld

can_lower_every_600_seconds

Muss warten, bevor der Spot-Preis erneut gesenkt werden kann; überprüfen Sie time_to_lowering

Python Fehlerbeispiel zur Fehlerbehandlung

JavaScript Fehlerbeispiel zur Fehlerbehandlung


Verfügbare Docker-Images

Clore.ai stellt vorgefertigte Images bereit, die für GPU-Workloads optimiert sind:

Image
Beschreibung

cloreai/ubuntu20.04-jupyter

Ubuntu 20.04 + JupyterLab

cloreai/ubuntu22.04-jupyter

Ubuntu 22.04 + JupyterLab

Sie können auch jedes öffentliche Docker Hub-Image verwenden. Für GPU-Zugriff verwenden Sie CUDA-fähige Images, z. B.:


Portweiterleitung

Geben Sie beim Erstellen einer Bestellung Ports an, die expose werden sollen:

  • "tcp" — Direkte TCP-Portweiterleitung (für SSH, benutzerdefinierte Server)

  • "http" — HTTPS-Proxy (für Jupyter, Web-UIs). Es ist nur ein HTTP-Port pro http_port Feld erlaubt.

Nach Erstellung der Bestellung erscheinen Verbindungsdetails in my_orders:

Verbinden über SSH:

Zugriff auf Jupyter über den Browser: https://n1.c1.clorecloud.net (verwendet das http_port)

Zuletzt aktualisiert

War das hilfreich?