_spot` envoyée pour celle-ci est ignorée. Les `usd_pricing` cibles sont des montants $/jour pour l’ensemble du serveur, validés par rapport à la plage USD (0.1–1,000) ; les valeurs hors plage sont ramenées à la borne la plus proche.
**Sortie**
| Champ | Type | Description |
| ------ | -------- | ----------- |
| `code` | `entier` | Code d'Ă©tat |
**Exemple**
Créons une preuve d’envoi pour une transaction envoyée depuis le portefeuille actuel.
**Entrée :**
```
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'
```
**Sortie :**
```
{
"code": 0
}
```
#### 8. `set_spot_price`
**Ă€ propos**
Définir le prix par jour sur votre offre SPOT du marché
**En-tĂŞtes**
| Champ | Type | Obligatoire | Description |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth` | `chaîne` | Oui | jeton API |
| `Type de contenu` | `chaîne` | Oui | Doit être `application/json` |
**Corps**
| Champ | Type | Obligatoire | Description |
| --------------- | ---------- | ----------- | ----------------------------- |
| `order_id` | `entier` | Oui | Identifiant unique de l’offre |
| `desired_price` | `flottant` | Oui | Votre prix proposé par jour |
> **Un prix inférieur au plancher spot actuel du serveur** est rejeté avec le minimum actuel inclus :
>
> ```
> { "error": "amount_too_low", "min_price": 0.0000012, "code": 6 }
> ```
**Exemple**
Essayons de mettre à jour le prix du marché spot
**Entrée 1 (la baisse était trop importante) :**
```
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'
```
**Sortie possible 1 (la baisse Ă©tait trop importante) :**\
Vous pouvez baisser le prix de l’offre spot d’au maximum 0.00000100 ₿
| Champ | Type | Description |
| ---------- | ---------- | ---------------------------------------------------------------------------------- |
| `code` | `entier` | Code d'Ă©tat |
| `erreur` | `chaîne` | Champ de description de l’erreur |
| `max_step` | `flottant` | Valeur minimale possible jusqu’à laquelle vous pouvez actuellement baisser le prix |
```
{
"error":"exceeded_max_step",
"max_step":0.0000032,
"code":6
}
```
**Entrée 2 (baisse de prix valide) :**
```
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'
```
**Sortie possible 2 (baisse de prix valide) :**
```
{
"code": 0
}
```
**Entrée 3 (baissez encore plus le prix après l’envoi de l’entrée 2) :**
```
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
```
**Sortie possible 3 (baissez encore plus le prix après l’envoi de l’entrée 2) :**\
Vous pouvez baisser le prix spot une fois toutes les 600 secondes
| Champ | Type | Description |
| ------------------ | ---------- | ---------------------------------------------------------------------- |
| `code` | `entier` | Code d'Ă©tat |
| `erreur` | `chaîne` | Champ de description de l’erreur |
| `time_to_lowering` | `flottant` | Temps restant (en s) avant la prochaine possibilité de baisser le prix |
```
{
"error":"can_lower_every_600_seconds",
"time_to_lowering":513,
"code":6
}
```
#### 9. `cancel_order`
**Ă€ propos**
Annuler une commande active ou une offre spot
**En-tĂŞtes**
| Champ | Type | Obligatoire | Description |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth` | `chaîne` | Oui | jeton API |
| `Type de contenu` | `chaîne` | Oui | Doit être `application/json` |
**Corps**
| Champ | Type | Obligatoire | Description |
| ------- | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `entier` | Oui | Identifiant unique de commande/offre |
| `issue` | `chaîne` | Non | Si vous avez rencontré des problèmes avec le serveur, vous pouvez les signaler à [clore.ai](http://clore.ai/) l’équipe, 2048 caractères maximum |
**Sortie**
| Champ | Type | Description |
| ------ | -------- | ----------- |
| `code` | `entier` | Code d'Ă©tat |
**Exemple**
Annuler la commande/l’offre
**Entrée :**\
Dans cet exemple, nous signalons des problèmes avec le GPU #1 ; si vous n’avez aucun problème, n’incluez pas le champ issue.\nVous pouvez écrire n’importe quel message dans le champ text et nous l’examinerons
```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
"id":39,
"issue":"Le GPU #1 surchauffait et bridait ses performances"
}' 'https://api.clore.ai/v1/cancel_order'
```
**Sortie :**
```
{
"code": 0
}
```
#### 10. `create_order`
**Ă€ propos**
Vous pouvez créer une offre spot ou une commande à la demande avec ce point de terminaison
**En-tĂŞtes**
| Champ | Type | Obligatoire | Description |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth` | `chaîne` | Oui | jeton API |
| `Type de contenu` | `chaîne` | Oui | Doit être `application/json` |
**Corps**
| Champ | Type | Obligatoire | Description |
| -------------------- | ---------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `currency` | `chaîne` | Oui | Nom de la devise |
| `image` | `chaîne` | Oui | Image valide depuis Docker Hub |
| `renting_server` | `entier` | Oui | ID du serveur que vous souhaitez louer |
| `type` | `chaîne` | Oui | `à la demande` OU `spot` |
| `spotprice` | `flottant` | Dépend | Prix proposé par jour sur le marché spot, requis lors de la création d’une commande spot |
| `ports` | `objet` | Non | Configuration de redirection de ports, 5 enregistrements maximum |
| `env` | `objet` | Non | Variables d’environnement, limitées à 12288 caractères au total une fois sérialisées.\nNom de la variable - 128 symboles maximum, ne doit pas contenir -
Valeur de la variable - 1536 symboles maximum\nSeules les 30 premières variables valides sont conservées ; les suivantes sont ignorées silencieusement
|
| `jupyter_token` | `chaîne` | Non | Jeton Jupyter pour les images contenant des notebooks Jupyter, 32 caractères maximum \* |
| `ssh_key` | `chaîne` | Non | Clé SSH pour les images avec SSH, 3072 caractères maximum \* |
| `ssh_password` | `chaîne` | Non | Mot de passe SSH pour les images avec SSH, 32 caractères maximum \* |
| `command` | `chaîne` | Non | La commande sera exécutée sur le serveur après la création de la commande |
| `required_price` | `flottant` | Non | Indiquez le prix auquel vous souhaitez lancer la commande ; si le propriétaire de la machine modifie le prix, la commande ne démarrera pas (à la demande uniquement) |
| `gpu_count` | `entier` | Non | Nombre de GPU à louer sur les serveurs qui prennent en charge [la location partielle](/clore.ai/clore.ai-eng-fr/pour-les-locataires/partial-gpu-rental.md). Omettez ce champ pour louer l’intégralité du rig. Uniquement à la demande, uniquement pour les rigs homogènes |
| `gpu_indices` | `[]int` | Non | Indices des emplacements GPU Ă louer, Ă partir de 0 ; la longueur doit ĂŞtre Ă©gale Ă `gpu_count`. Prenez les emplacements libres depuis `partial_gpu_rental.free_indices`. Omettez pour laisser le backend choisir automatiquement les GPU libres |
| `autossh_entrypoint` | `booléen` | Non | Utilisez le point d’entrée clore.ai, qui déploie automatiquement le serveur SSH et un script personnalisé `/root/onstart.sh` script |
\* Pour les champs marqués d’une étoile, vous ne pouvez saisir que des caractères issus de ce groupe regexp `/^[a-zA-Z0-9\s-=.@+/]+$/`
**Sortie**
| Champ | Type | Description |
| ------ | -------- | ----------- |
| `code` | `entier` | Code d'Ă©tat |
> **Les offres spot inférieures au plancher du serveur** sont rejetées avec le minimum actuel inclus, vous pouvez donc réessayer immédiatement :
>
> ```
> { "error": "too_low_price", "min_price": 0.0000012, "code": 6 }
> ```
>
> Le plancher est recalculé à partir des taux des monnaies en temps réel environ toutes les 10 minutes, donc un prix lu dans l’annonce de la place de marché peut être légèrement obsolète — utilisez toujours le `min_price` renvoyé pour la nouvelle tentative.
**Exemple**
**Entrée 1 (créer une offre spot) :**
```
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'
```
**Sortie 1 (créer une offre spot) :**
```
{
"code":0
}
```
**Entrée 2 (créer une commande à la demande) :**
```
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'
```
**Sortie 2 (créer une commande à la demande) :**
```
{
"code":0
}
```
#### 11. `renter_fees`
**Ă€ propos**
Obtenez la configuration actuelle des frais : frais de base du locataire, paramètres de réduction des frais PoH, frais de création de commande et votre solde PoH
**En-tĂŞtes**
| Champ | Type | Obligatoire | Description |
| ------ | -------- | ----------- | ----------- |
| `auth` | `chaîne` | Oui | jeton API |
**Sortie**
| Champ | Type | Description |
| ---------------------------------- | ---------- | ------------------------------------------------------------ |
| `code` | `entier` | Code d'Ă©tat |
| `renter_fees.on_demand` | `objet` | Frais de base (%) par devise pour les commandes Ă la demande |
| `renter_fees.spot` | `objet` | Frais de base (%) par devise pour les commandes spot |
| `poh_config.max_reduction_percent` | `entier` | RĂ©duction maximale des frais de base via PoH (%) |
| `poh_config.max_poh_amount` | `entier` | Solde PoH à partir duquel la réduction maximale est atteinte |
| `creation_fees.on_demand` | `objet` | Frais de création de commande par devise |
| `creation_fees.spot` | `objet` | Frais de création de commande spot par devise |
| `poh_balance` | `flottant` | Votre solde PoH en CLORE |
**Entrée :**
```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/renter_fees'
```
**Sortie :**
```
{
"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`
**Ă€ propos**
Annuler plusieurs commandes à la fois (jusqu’à 256 par requête)
**En-tĂŞtes**
| Champ | Type | Obligatoire | Description |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth` | `chaîne` | Oui | jeton API |
| `Type de contenu` | `chaîne` | Oui | Doit être `application/json` |
**Corps**
| Champ | Type | Obligatoire | Description |
| ----------- | ------- | ----------- | -------------------------------------- |
| `order_ids` | `[]int` | Oui | IDs de commande Ă annuler, 256 maximum |
**Sortie**
| Champ | Type | Description |
| ------------------ | -------- | --------------------------------------------- |
| `code` | `entier` | Code d'Ă©tat |
| `failed_to_cancel` | `[]int` | IDs de commande qui n’ont pas pu être annulés |
**Entrée :**
```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
"order_ids": [38, 39]
}' 'https://api.clore.ai/v1/cancel_orders'
```
**Sortie :**
```
{
"failed_to_cancel": [],
"code": 0
}
```
#### 13. `poh_balance`
**Ă€ propos**
Obtenez votre solde Proof of Holding : éléments, totaux et montants des offres du marché PoH
**En-tĂŞtes**
| Champ | Type | Obligatoire | Description |
| ------ | -------- | ----------- | ----------- |
| `auth` | `chaîne` | Oui | jeton API |
**Sortie**
| Champ | Type | Description |
| --------------------------------------------- | ---------- | -------------------------------------------- |
| `code` | `entier` | Code d'Ă©tat |
| `items` | `[]objets` | Vos éléments PoH avec des soldes individuels |
| `balance.total` | `flottant` | Solde PoH total sur tous les éléments |
| `balance.free_amount` | `flottant` | Solde PoH non engagé dans des offres |
| `balance.reward_amount` | `flottant` | Solde éligible aux récompenses |
| `balance.offers.rented_amount` | `flottant` | Montant loué à d’autres utilisateurs |
| `balance.offers.rented_on_marketplace_amount` | `flottant` | Montant répertorié sur le marché PoH |
| `balance.offers.leased_amount` | `flottant` | Montant loué à d'autres utilisateurs |
**Entrée :**
```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/poh_balance'
```
**Sortie :**
```
{
"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`
**Ă€ propos**
Obtenez les données de configuration statique de l'API. Aucune authentification requise
**Entrée :**
```
curl -XGET 'https://api.clore.ai/v1/server-config.json'
```
#### 15. `get_relay`
**Ă€ propos**
Obtenez les nœuds relais de transfert TCP pour votre pays détecté. Aucune authentification requise
**Sortie**
| Champ | Type | Description |
| ------- | -------- | ------------------------ |
| `code` | `entier` | Code d'Ă©tat |
| `pays` | `chaîne` | Code du pays détecté |
| `nœuds` | `objet` | Nœuds relais disponibles |
**Entrée :**
```
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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.clore.ai/clore.ai/clore.ai-eng-fr/pour-les-hotes/api.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
