For the complete documentation index, see llms.txt. This page is also available as Markdown.

CLI- & SDK-Leitfaden

Übersicht

Clore.ai bietet eine REST-API die den vollständigen programmgesteuerten Zugriff auf den GPU-Marktplatz ermöglicht — Server auflisten, Bestellungen erstellen, Bereitstellungen überwachen und Mieten kündigen.

Hinweis: Derzeit gibt es kein offizielles CLI-Binary. Die gesamte Automatisierung erfolgt 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

Erstellen Sie Ihren API-Schlüssel über das Clore.ai-Dashboard:

  1. Melden Sie sich bei Ihrem Konto an

  2. Navigieren Sie zu API Abschnitt in den Einstellungen

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

Header-Format:

auth: YOUR_API_KEY

⚠️ Wichtig: Der auth-Header lautet auth, nicht Authorization: Bearer. Bei Verwendung des falschen Formats wird der Code zurückgegeben 3 (Ungültiges API-Token).

Beispiel:

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

Schnellstart

Marketplace-Server auflisten

Alle verfügbaren GPU-Server durchsuchen:

Antwort:


Ihre Bestellungen abrufen

Abgeschlossene/abgelaufene Bestellungen einschließen:


Eine Bestellung erstellen (On-Demand)

Antwort:


Eine Spot-Bestellung 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:

Per SSH auf Ihren gemieteten Server zugreifen:


Eine Bestellung stornieren

Optional ein Problem mit dem Server melden:


Python-SDK

Ein leichtgewichtiger Wrapper, der die requests Bibliothek verwendet. Installieren Sie ihn mit:

CloreClient-Klasse

Vollständiges funktionierendes Beispiel


Node.js-Beispiel

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


Häufige Arbeitsabläufe

Die günstigste RTX 4090 finden und mieten


Meine Aufträge überwachen


Automatisch mieten, wenn der Preis unter X fällt


WebSocket

Die Clore.ai REST-API stellt derzeit keinen WebSocket-Endpunkt bereit. Für die Echtzeitüberwachung verwende Polling mit einem vernünftigen Intervall (siehe Rate-Limits unten).


Rate-Limits

Endpunkt
Limit

Die meisten Endpunkte

1 Anfrage/Sekunde

create_order

1 Anfrage/5 Sekunden

set_spot_price (Preisreduzierung)

Einmal pro 600 Sekunden

Antwort bei Rate-Limit (Code 5):

Bewährte Praktiken:

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

  • Für create_order, warte mindestens 5 Sekunden zwischen Anfragen

  • Verwende für Überwachungsschleifen Polling-Intervalle von 60+ Sekunden

  • Cache die Marktplatzdaten lokal, wenn du sie häufig abfragen musst

Python-Hilfsfunktion:


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

Prüfe deinen Request-Body/deine Parameter

3

Ungültiges API-Token

Überprüfe deinen API-Schlüssel im Dashboard

4

Ungültiger Endpunkt

Prüfe die Endpunkt-URL

5

Rate-Limit überschritten (1 Anfrage/Sek.)

Füge Verzögerungen zwischen Anfragen hinzu

6

Anwendungsfehler (siehe Fehler Feld)

Lies das Fehler Feld für Details

Unterfehler von Code 6

Fehler Wert

Bedeutung

exceeded_max_step

Die Spot-Preisreduzierung ist zu groß; prüfe max_step Feld

can_lower_every_600_seconds

Du musst warten, bevor du den Spot-Preis erneut senkst; prüfe time_to_lowering

Python-Beispiel zur Fehlerbehandlung

JavaScript-Beispiel zur Fehlerbehandlung


Verfügbare Docker-Images

Clore.ai bietet vorgefertigte Images, optimiert für GPU-Workloads:

Image
Beschreibung

cloreai/ubuntu20.04-jupyter

Ubuntu 20.04 + JupyterLab

cloreai/ubuntu22.04-jupyter

Ubuntu 22.04 + JupyterLab

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


Portweiterleitung

Beim Erstellen eines Auftrags gib die freizugebenden Ports an:

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

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

Nach der Auftragserstellung erscheinen die Verbindungsdetails in my_orders:

Verbinde dich via SSH:

Greife per Browser auf Jupyter zu: https://n1.c1.clorecloud.net verwendet das http_port)

Zuletzt aktualisiert

War das hilfreich?