_spot` gesendeter Wert wird ignoriert. Die `usd_pricing` Ziele sind serverweite $/Tag-Werte, validiert gegen den USD-Bereich (0.1–1,000); Werte außerhalb des Bereichs werden auf die nächstgelegene Grenze begrenzt.
**Ausgabe**
| Feld | Typ | Beschreibung |
| ------ | ----- | ------------ |
| `code` | `int` | Statuscode |
**Beispiel**
Lassen Sie uns einen Sendenachweis für eine Transaktion aus dem aktuellen Wallet erstellen.
**Eingabe:**
```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
"name": "Jan Vykydal",
"availability":true,
"mrl":96,
"enabled-bitcoin":true,
"bitcoin_on_demand":0.0001,
"bitcoin_spot":0.00000113
}' 'https://api.clore.ai/v1/set_server_settings'
```
**Ausgabe:**
```
{
"code": 0
}
```
#### 8. `set_spot_price`
**Über**
Legen Sie den Preis pro Tag für Ihr Spot-Marktplatzangebot fest
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| ------------- | -------------- | ------------ | ---------------------------- |
| `auth` | `Zeichenfolge` | Ja | API-Token |
| `Content-Typ` | `Zeichenfolge` | Ja | Muss sein `application/json` |
**Body**
| Feld | Typ | Erforderlich | Beschreibung |
| --------------- | ---------------- | ------------ | ----------------------------- |
| `order_id` | `int` | Ja | Eindeutige Angebots-ID |
| `desired_price` | `Gleitkommazahl` | Ja | Ihr angebotener Preis pro Tag |
> **Ein Preis unterhalb der aktuellen Spot-Untergrenze des Servers** wird mit dem aktuellen Minimum abgelehnt:
>
> ```
> { "error": "amount_too_low", "min_price": 0.0000012, "code": 6 }
> ```
**Beispiel**
Versuchen wir, den Spot-Marktplatzpreis zu aktualisieren
**Eingabe 1 (Der Schritt nach unten war zu groß):**
```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
"order_id":39,
"desired_price":0.00000200
}' 'https://api.clore.ai/v1/set_spot_price'
```
**Mögliche Ausgabe 1 (Der Schritt nach unten war zu groß):**\
Sie können den Spot-Marktplatz-Angebotspreis um maximal 0.00000100 ₿ senken
| Feld | Typ | Beschreibung |
| ---------- | ---------------- | ----------------------------------------------------------------------- |
| `code` | `int` | Statuscode |
| `Fehler` | `Zeichenfolge` | Feld für Fehlerbeschreibung |
| `max_step` | `Gleitkommazahl` | Niedrigster möglicher Wert, auf den Sie den Preis derzeit senken können |
```
{
"error":"exceeded_max_step",
"max_step":0.0000032,
"code":6
}
```
**Eingabe 2 (Gültiger Preisschritt nach unten):**
```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
"order_id":39,
"desired_price":0.00000320
}' 'https://api.clore.ai/v1/set_spot_price'
```
**Mögliche Ausgabe 2 (Gültiger Preisschritt nach unten):**
```
{
"code": 0
}
```
**Eingabe 3 (Preis nach dem Senden von Eingabe 2 noch weiter senken):**
```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
"order_id":39,
"desired_price":0.00000220
}' 'https://api.clore.ai/v1/set_spot_price
```
**Mögliche Ausgabe 3 (Preis nach dem Senden von Eingabe 2 noch weiter senken):**\
Sie können den Spot-Preis nur einmal alle 600 Sekunden senken
| Feld | Typ | Beschreibung |
| ------------------ | ---------------- | -------------------------------------------------------------------------- |
| `code` | `int` | Statuscode |
| `Fehler` | `Zeichenfolge` | Feld für Fehlerbeschreibung |
| `time_to_lowering` | `Gleitkommazahl` | Verbleibende Zeit (Sek.) bis zur nächsten Möglichkeit, den Preis zu senken |
```
{
"error":"can_lower_every_600_seconds",
"time_to_lowering":513,
"code":6
}
```
#### 9. `cancel_order`
**Über**
Einen aktiven Auftrag oder ein Spot-Angebot stornieren
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| ------------- | -------------- | ------------ | ---------------------------- |
| `auth` | `Zeichenfolge` | Ja | API-Token |
| `Content-Typ` | `Zeichenfolge` | Ja | Muss sein `application/json` |
**Body**
| Feld | Typ | Erforderlich | Beschreibung |
| --------- | -------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `int` | Ja | Eindeutige Auftrags-/Angebots-ID |
| `Problem` | `Zeichenfolge` | Nein | Wenn Sie mit dem Server Probleme festgestellt haben, können Sie sie dem [clore.ai](http://clore.ai/) Team melden, maximal 2048 Zeichen |
**Ausgabe**
| Feld | Typ | Beschreibung |
| ------ | ----- | ------------ |
| `code` | `int` | Statuscode |
**Beispiel**
Auftrag/Angebot stornieren
**Eingabe:**\
In diesem Beispiel melden wir Probleme mit GPU #1, wenn Sie keine Probleme haben, fügen Sie das Feld issue nicht hinzu.\nSie können jede beliebige Nachricht in das Textfeld schreiben, und wir werden sie untersuchen
```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
"id":39,
"issue":"GPU #1 war überhitzt und wurde gedrosselt"
}' 'https://api.clore.ai/v1/cancel_order'
```
**Ausgabe:**
```
{
"code": 0
}
```
#### 10. `create_order`
**Über**
Mit diesem Endpunkt können Sie ein Spot-Angebot oder einen On-Demand-Auftrag erstellen
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| ------------- | -------------- | ------------ | ---------------------------- |
| `auth` | `Zeichenfolge` | Ja | API-Token |
| `Content-Typ` | `Zeichenfolge` | Ja | Muss sein `application/json` |
**Body**
| Feld | Typ | Erforderlich | Beschreibung |
| -------------------- | ---------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `currency` | `Zeichenfolge` | Ja | Währungsname |
| `image` | `Zeichenfolge` | Ja | Gültiges Image von Docker Hub |
| `renting_server` | `int` | Ja | ID des Servers, den Sie mieten möchten |
| `Typ` | `Zeichenfolge` | Ja | `On-Demand` ODER `Spot` |
| `spotprice` | `Gleitkommazahl` | Hängt ab von | Angebotener Preis pro Tag auf dem Spot-Marktplatz, erforderlich beim Erstellen einer Spot-Bestellung |
| `ports` | `Objekt` | Nein | Portweiterleitungs-Konfiguration, maximal 5 Einträge |
| `env` | `Objekt` | Nein | Umgebungsvariablen, insgesamt auf 12288 Zeichen begrenzt, wenn in Zeichenkettenform dargestellt.\nVariablenname - maximal 128 Zeichen, darf nicht enthalten -
Variablenwert - maximal 1536 Zeichen\nEs werden nur die ersten 30 gültigen Variablen beibehalten; zusätzliche werden stillschweigend verworfen
|
| `jupyter_token` | `Zeichenfolge` | Nein | Jupyter-Token für Images mit Jupyter-Notebooks, maximal 32 Zeichen \* |
| `ssh_key` | `Zeichenfolge` | Nein | SSH-Schlüssel für Images mit SSH, maximal 3072 Zeichen \* |
| `ssh_password` | `Zeichenfolge` | Nein | SSH-Passwort für Images mit SSH, maximal 32 Zeichen \* |
| `command` | `Zeichenfolge` | Nein | Der Befehl wird nach der Auftragserstellung auf dem Server ausgeführt |
| `required_price` | `Gleitkommazahl` | Nein | Geben Sie den Preis an, zu dem Sie den Auftrag starten möchten; wenn der Maschinenbesitzer den Preis ändert, wird der Auftrag nicht gestartet (nur On-Demand) |
| `gpu_count` | `int` | Nein | Anzahl der GPUs zum Mieten auf Servern, die [Teilmiete](/clore.ai/clore.ai-eng-de/fur-mieter/partial-gpu-rental.md). Weglassen, um das gesamte Rig zu mieten. Nur On-Demand, nur homogene Rigs |
| `gpu_indices` | `[]int` | Nein | 0-basierte GPU-Slot-Indizes zum Mieten; die Länge muss gleich sein `gpu_count`. Nehmen Sie freie Slots aus `partial_gpu_rental.free_indices`. Weglassen, damit das Backend freie GPUs automatisch auswählt |
| `autossh_entrypoint` | `bool` | Nein | Verwenden Sie den clore.ai-Entrypoint, der automatisch einen SSH-Server und ein benutzerdefiniertes `/root/onstart.sh` Skript |
\* In Felder, die mit Stern markiert sind, können Sie nur Zeichen aus dieser Regex-Gruppe eingeben `/^[a-zA-Z0-9\\s-=.@+/]+$/`
**Ausgabe**
| Feld | Typ | Beschreibung |
| ------ | ----- | ------------ |
| `code` | `int` | Statuscode |
> **Spot-Gebote unterhalb der Untergrenze des Servers** werden mit dem aktuellen Minimum abgelehnt, sodass Sie sofort erneut versuchen können:
>
> ```
> { "error": "too_low_price", "min_price": 0.0000012, "code": 6 }
> ```
>
> Die Untergrenze wird etwa alle 10 Minuten aus den aktuellen Münzpreisen neu berechnet, sodass ein aus dem Marktplatz-Eintrag abgelesener Preis leicht veraltet sein kann — verwenden Sie immer den zurückgegebenen `min_price` für den erneuten Versuch.
**Beispiel**
**Eingabe 1 (Spot-Angebot erstellen):**
```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
"currency":"bitcoin",
"image":"cloreai/ubuntu20.04-jupyter",
"renting_server":6,
"type":"spot",
"spotprice":0.000001,
"ports":{
"22":"tcp",
"8888":"http"
},
"env":{
"VARIABLE_NAME":"VARIABLE_VALUE",
},
"jupyter_token":"hoZluOjbCOQ5D5yH7R",
"ssh_password":"Hpcj08ZaOpCbTmn1Eu",
"command":"#!/bin/sh\napt update -y && apt install htop"
}' 'https://api.clore.ai/v1/create_order'
```
**Ausgabe 1 (Spot-Angebot erstellen):**
```
{
"code":0
}
```
**Eingabe 2 (On-Demand-Auftrag erstellen):**
```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
"currency":"bitcoin",
"image":"cloreai/ubuntu20.04-jupyter",
"renting_server":6,
"type":"on-demand",
"ports":{
"22":"tcp",
"8888":"http"
},
"env":{
"VARIABLE_NAME":"VARIABLE_VALUE",
},
"jupyter_token":"hoZluOjbCOQ5D5yH7R",
"ssh_password":"Hpcj08ZaOpCbTmn1Eu",
"command":"#!/bin/sh\napt update -y && apt install htop"
}' 'https://api.clore.ai/v1/create_order'
```
**Ausgabe 2 (On-Demand-Auftrag erstellen):**
```
{
"code":0
}
```
#### 11. `renter_fees`
**Über**
Erhalten Sie die aktuelle Gebührenkonfiguration: Basis-Mietergebühren, Einstellungen zur PoH-Gebührenreduzierung, Auftragserstellungsgebühren und Ihr PoH-Guthaben
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| ------ | -------------- | ------------ | ------------ |
| `auth` | `Zeichenfolge` | Ja | API-Token |
**Ausgabe**
| Feld | Typ | Beschreibung |
| ---------------------------------- | ---------------- | ------------------------------------------------------------ |
| `code` | `int` | Statuscode |
| `renter_fees.on_demand` | `Objekt` | Basisgebühr (%) pro Währung für On-Demand-Aufträge |
| `renter_fees.spot` | `Objekt` | Basisgebühr (%) pro Währung für Spot-Aufträge |
| `poh_config.max_reduction_percent` | `int` | Maximale Reduzierung der Basisgebühr durch PoH (%) |
| `poh_config.max_poh_amount` | `int` | PoH-Guthaben, bei dem die maximale Reduzierung erreicht wird |
| `creation_fees.on_demand` | `Objekt` | Auftragserstellungsgebühr pro Währung |
| `creation_fees.spot` | `Objekt` | Gebühr für die Erstellung von Spot-Aufträgen pro Währung |
| `poh_balance` | `Gleitkommazahl` | Ihr PoH-CLORE-Guthaben |
**Eingabe:**
```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/renter_fees'
```
**Ausgabe:**
```
{
"renter_fees": {
"on_demand": {
"base": { "bitcoin": 5, "CLORE-Blockchain": 5, "USD-Blockchain": 5 }
},
"spot": {
"base": { "bitcoin": 1.25, "CLORE-Blockchain": 1.25, "USD-Blockchain": 1.25 }
}
},
"poh_config": { "max_reduction_percent": 50, "max_poh_amount": 2000000 },
"creation_fees": {
"on_demand": { "bitcoin": 3e-7, "CLORE-Blockchain": 0.5, "USD-Blockchain": 0.1 },
"spot": { "bitcoin": 1e-7, "CLORE-Blockchain": 0.05, "USD-Blockchain": 0.005 }
},
"poh_balance": 5000,
"code": 0
}
```
#### 12. `cancel_orders`
**Über**
Mehrere Aufträge gleichzeitig stornieren (bis zu 256 pro Anfrage)
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| ------------- | -------------- | ------------ | ---------------------------- |
| `auth` | `Zeichenfolge` | Ja | API-Token |
| `Content-Typ` | `Zeichenfolge` | Ja | Muss sein `application/json` |
**Body**
| Feld | Typ | Erforderlich | Beschreibung |
| ----------- | ------- | ------------ | ----------------------------------------- |
| `order_ids` | `[]int` | Ja | Zu stornierende Auftrags-IDs, maximal 256 |
**Ausgabe**
| Feld | Typ | Beschreibung |
| ------------------ | ------- | ------------------------------------------------ |
| `code` | `int` | Statuscode |
| `failed_to_cancel` | `[]int` | Auftrags-IDs, die nicht storniert werden konnten |
**Eingabe:**
```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
"order_ids": [38, 39]
}' 'https://api.clore.ai/v1/cancel_orders'
```
**Ausgabe:**
```
{
"failed_to_cancel": [],
"code": 0
}
```
#### 13. `poh_balance`
**Über**
Erhalten Sie Ihr Proof-of-Holding-Guthaben: Positionen, Summen und Angebotsbeträge auf dem PoH-Marktplatz
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| ------ | -------------- | ------------ | ------------ |
| `auth` | `Zeichenfolge` | Ja | API-Token |
**Ausgabe**
| Feld | Typ | Beschreibung |
| --------------------------------------------- | ---------------- | ------------------------------------------------ |
| `code` | `int` | Statuscode |
| `Positionen` | `[]object` | Ihre PoH-Positionen mit einzelnen Guthaben |
| `balance.total` | `Gleitkommazahl` | Gesamt-PoH-Guthaben über alle Positionen |
| `balance.free_amount` | `Gleitkommazahl` | PoH-Guthaben, das nicht an Angebote gebunden ist |
| `balance.reward_amount` | `Gleitkommazahl` | Für Belohnungen berechtigtes Guthaben |
| `balance.offers.rented_amount` | `Gleitkommazahl` | An andere Nutzer vermietete Menge |
| `balance.offers.rented_on_marketplace_amount` | `Gleitkommazahl` | Auf dem PoH-Marktplatz gelistete Menge |
| `balance.offers.leased_amount` | `Gleitkommazahl` | Von anderen Nutzern geleaste Menge |
**Eingabe:**
```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/poh_balance'
```
**Ausgabe:**
```
{
"items": [ { "balance": 5000 } ],
"balance": {
"total": 5000,
"free_amount": 4000,
"reward_amount": 5000,
"offers": {
"rented_amount": 0,
"rented_on_marketplace_amount": 1000,
"rented_finished_amount": 0,
"leased_amount": 0
}
},
"code": 0
}
```
#### 14. `server-config.json`
**Über**
Statische API-Konfigurationsdaten abrufen. Keine Authentifizierung erforderlich
**Eingabe:**
```
curl -XGET 'https://api.clore.ai/v1/server-config.json'
```
#### 15. `get_relay`
**Über**
TCP-Weiterleitungs-Relay-Knoten für Ihr erkanntes Land abrufen. Keine Authentifizierung erforderlich
**Ausgabe**
| Feld | Typ | Beschreibung |
| --------- | -------------- | ----------------------- |
| `code` | `int` | Statuscode |
| `country` | `Zeichenfolge` | Erkannter Ländercode |
| `nodes` | `Objekt` | Verfügbare Relay-Knoten |
**Eingabe:**
```
curl -XGET 'https://api.clore.ai/v1/get_relay'
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.clore.ai/clore.ai/clore.ai-eng-de/fur-hosts/api.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.