Connexion et API
sans deviner

01 / DÉBUT

Démarrage rapide

1. Inscrivez-vous ou connectez-vous sur Rate Cloud. Confirmez votre e-mail. Pour un accès d'essai gratuit de trois heures, liez votre compte Telegram dans le tableau de bord ; après la fin de la période d'essai, un abonnement au modèle choisi est requis.
2. Ouvrez Paramètres → Clés API et créez une clé. Copiez le secret immédiatement : après la fermeture de la fenêtre, il n'est plus affiché.
3. Ouvrez Connexion dans le tableau de bord, sélectionnez le programme et le système d'exploitation. L'onglet « Automatique » affiche une commande prête avec votre clé, si l'installation automatique est prise en charge.
4. Collez la commande dans Terminal ou PowerShell, attendez le message de réussite de l'installation, redémarrez le programme et sélectionnez Rate Cloud. Si vous préférez la configuration manuelle, ouvrez l'onglet « Manuellement » sur la même page.
5. Envoyez un court message de test. La liste des modèles dans le programme contient les cinq entrées ; la requête au modèle s'exécutera avec un abonnement actif ou un accès d'essai et une clé avec les droits appropriés.

L'installation automatique modifie uniquement la configuration du programme choisi et conserve une copie de sauvegarde du fichier existant. Les chats ne sont pas supprimés. La commande de désactivation se trouve à côté de la commande de connexion dans le tableau de bord.

02 / ACCÈS

Comment créer une clé API

1. Dans le tableau de bord, cliquez sur « Paramètres », faites défiler jusqu'au bloc « Clés API » et cliquez sur « + Créer une clé ».
2. Donnez à la clé un nom explicite, par exemple « Codex sur portable ». Le nom est pour vous uniquement.
3. Dans « Accès aux modèles », sélectionnez « Tous les modèles actifs » si vous souhaitez utiliser automatiquement les futurs abonnements. L'option « Modèles sélectionnés uniquement » limite la clé aux modèles listés ; l'achat d'un autre abonnement ne lève pas cette restriction à lui seul.
4. Choisissez l'accès IP : « N'importe quelle IP » pour un ordinateur portable ordinaire ou une liste d'adresses autorisées pour un serveur permanent. Indiquez la durée de validité. Si vous utilisez Codex ou Claude Code, cochez la case « Support Codex / Claude Code ».
5. Cliquez sur « Créer une clé » et copiez le secret affiché. Conservez-le comme un mot de passe. Si vous perdez le secret, créez une nouvelle clé. N'insérez pas la clé dans un dépôt public ou une demande d'assistance.

La clé gère l'accès, l'abonnement donne le droit d'exécuter des requêtes vers un modèle spécifique. La liste des cinq modèles peut s'afficher même sans abonnement ; cela permet de ne pas reconfigurer le client après l'achat. Pour Codex et Claude Code, il faut une clé avec la compatibilité activée. Ouvrir les clés API →

03 / CATALOGUE

Les cinq modèles

Dans le champ model Pour l'API, transmettez l'ID exactement comme dans le tableau. L'ID s'écrit en latin, en minuscules, avec des points et des tirets exactement comme dans le tableau. N'ajoutez pas de préfixe à l'ID ratecloud/ dans l'API directe : il est nécessaire uniquement pour la sélection du fournisseur dans certains programmes.

Noms exacts pour Codex et Claude Code

Toutes les options sont listées ici sans abréviations. Dans Codex, indiquez la ligne souhaitée dans model, dans Claude Code — dans ANTHROPIC_MODEL.

L'abonnement à chaque modèle se souscrit séparément sur la page des tarifs. Vérifiez l'accès d'essai et la disponibilité du modèle dans le tableau de bord. Si vous êtes abonné à plusieurs modèles, la commande automatique sélectionne par défaut le modèle avec l'abonnement actif le plus ancien. Dans les clients Codex, les ID ont la forme ratecloud/glm-5.3, et dans Claude Code — ocx-claude-ratecloud--glm-5.3; de la même manière, substituez l'un des quatre autres ID.

04 / DÉVELOPPEURS

HTTP API et première requête

Requêtes vers /v1 transmettent l'en-tête Authorization: Bearer VOTRE_CLÉ_API. Vérifiez d'abord le catalogue, puis envoyez une requête simple. Ces exemples utilisent GLM 5.3 ; remplacez l'ID par l'un des cinq modèles avec un accès actif.

macOS / Linux: Terminal

printf 'Вставьте Clé API: '; read -r -s RATE_CLOUD_API_KEY; echo
curl -fsS https://llm.rate-cloud.com/v1/models \
  -H "Authorization: Bearer $RATE_CLOUD_API_KEY"
curl -fsS https://llm.rate-cloud.com/v1/chat/completions \
  -H "Authorization: Bearer $RATE_CLOUD_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"Ответь: работает"}]}'
unset RATE_CLOUD_API_KEY

Windows: PowerShell

$env:RATE_CLOUD_API_KEY = Read-Host 'Collez votre clé API'
$headers = @{ Authorization = "Bearer $env:RATE_CLOUD_API_KEY" }
Invoke-RestMethod 'https://llm.rate-cloud.com/v1/models' -Headers $headers
$body = @{ model = 'glm-5.3'; messages = @(@{ role = 'user'; content = 'Ответь: работает' }) } | ConvertTo-Json -Depth 5
Invoke-RestMethod 'https://llm.rate-cloud.com/v1/chat/completions' -Method Post -Headers $headers -ContentType 'application/json' -Body $body
Remove-Item Env:RATE_CLOUD_API_KEY

Pour un SDK compatible OpenAI, indiquez le Base URL https://llm.rate-cloud.com/v1, votre clé et l'un des ID du tableau. Pour une requête Responses directe, utilisez la même clé et /v1/responses.

05 / PROGRAMMES

Codex CLI, application et VS Code

Le chemin simple : dans dans l'espace client sélectionnez « Codex », votre OS et « Automatique ». La commande utilise la clé avec le « Support Codex / Claude Code » activé. Après l'installation, ouvrez la liste des modèles et sélectionnez Rate Cloud. L'extension VS Code Codex utilise les paramètres Codex.

Configuration manuelle

1. Installez Codex selon les instructions d'OpenAI. Fermez Codex et VS Code.
2. Ouvrez ~/.codex/config.toml sur macOS/Linux ou %USERPROFILE%\.codex\config.toml sous Windows. Si le fichier existe, enregistrez une copie. Sinon, créez un fichier texte avec ce nom.
3. Ajoutez les paramètres globaux au début du fichier, avant les sections entre crochets. Ajoutez la section du fournisseur à la fin. Conservez les autres paramètres.

model = "ratecloud/glm-5.3"
model_provider = "ratecloud"

[model_providers.ratecloud]
name = "Rate Cloud"
base_url = "https://llm.rate-cloud.com/codex/v1"
wire_api = "responses"
env_key = "RATE_CLOUD_API_KEY"

Dans le terminal à partir duquel vous lancez Codex, définissez RATE_CLOUD_API_KEY par votre secret : sur macOS/Linux — export RATE_CLOUD_API_KEY='VOTRE_CLÉ_API', dans PowerShell — $env:RATE_CLOUD_API_KEY='VOTRE_CLÉ_API'. Ensuite, dans la même fenêtre, lancez codex. Lors du lancement de VS Code depuis le terminal, utilisez code ., pour que l'extension reçoive la même variable. Pour les autres modèles, remplacez la partie après ratecloud/ par l'ID souhaité du tableau.

Pour un exemple manuel précis adapté au système d'exploitation choisi, utilisez l'onglet « Manuellement » dans le tableau de bord. Vérifiez le format du fournisseur avec la documentation Codex.

06 / PROGRAMMES

Claude Code

Pour Claude Code, il faut une clé avec la compatibilité Codex / Claude Code activée et un accès valide au modèle choisi. Dans dans l'espace client sélectionnez Claude Code et votre OS : la commande automatique configurera la détection des cinq modèles. Le nom du modèle dans ce client a le préfixe ocx-claude-ratecloud--.

Lancement manuel sans modification des fichiers

Installez Claude Code, ouvrez Terminal ou PowerShell et définissez trois variables avant la commande claude. Remplacez uniquement VOTRE_CLÉ_API et, si vous le souhaitez, le suffixe du modèle.

macOS / Linux

export ANTHROPIC_BASE_URL='https://llm.rate-cloud.com/claude'
export ANTHROPIC_AUTH_TOKEN='VOTRE_CLÉ_API'
export ANTHROPIC_MODEL='ocx-claude-ratecloud--glm-5.3'
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL='https://llm.rate-cloud.com/claude'
$env:ANTHROPIC_AUTH_TOKEN='VOTRE_CLÉ_API'
$env:ANTHROPIC_MODEL='ocx-claude-ratecloud--glm-5.3'
claude

Ces variables sont actives dans le terminal actuel. L'installation automatique enregistre les paramètres dans ~/.claude/settings.json ou %USERPROFILE%\.claude\settings.json, sans affecter l'historique des chats. Plus d'informations sur les variables et les paramètres — dans la documentation Claude Code.

07 / PROGRAMMES

OpenCode

La commande automatique dans le tableau de bord ajoute le fournisseur Rate Cloud et les cinq modèles dans la configuration d'OpenCode. Elle prend en compte le format de la version installée d'OpenCode. Sur Windows, la configuration se trouve dans %USERPROFILE%\.config\opencode\opencode.json; sur macOS/Linux — dans ~/.config/opencode/opencode.json.

Exemple manuel pour OpenCode v1

Faites une copie du fichier existant, ouvrez-le dans un éditeur de texte et ajoutez le fournisseur dans l'objet provider. Pour un nouveau fichier, l'exemple complet ci-dessous convient. Remplacez VOTRE_CLÉ_API par le secret, enregistrez le fichier, redémarrez OpenCode et ouvrez /models.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "ratecloud/glm-5.3",
  "provider": {
    "ratecloud": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Rate Cloud",
      "options": {
        "baseURL": "https://llm.rate-cloud.com/v1",
        "apiKey": "VOTRE_CLÉ_API"
      },
      "models": {
        "glm-5.3": {"name": "GLM 5.3"},
        "glm-5.3-flash": {"name": "GLM 5.3 Flash"},
        "deepseek-v4.1-flash": {"name": "DeepSeek V4.1 Flash"},
        "deepseek-v4-pro": {"name": "DeepSeek V4 Pro"},
        "qwen-3.8-max": {"name": "Qwen 3.8 Max"}
      }
    }
  }
}

OpenCode v2 utilise un format différent providers. Ne collez pas l'exemple v1 dans la configuration v2 : un exemple prêt des deux versions se trouve dans l'onglet « Manuel » du tableau de bord. Documentation officielle OpenCode.

08 / PROGRAMMES

OpenClaw, Continue, Hermes et autres

Pour OpenClaw, Continue et Hermes, dans dans l'espace client des commandes automatiques sont disponibles pour Windows, macOS et Linux, ainsi que des exemples manuels avec les chemins de fichiers et des boutons de copie. Sélectionnez le programme et l'OS avant de copier la commande.

OpenClaw manuellement

1. Fermez OpenClaw. Ouvrez le fichier indiqué ci-dessus openclaw.json et enregistrez une copie.
2. Ajoutez le fournisseur ratecloud в models.providers, sans supprimer les autres entrées. Dans agents.defaults.model.primary indiquez le ratecloud/ID.
3. Remplacez VOTRE_CLÉ_API, enregistrez le fichier et redémarrez OpenClaw. Ci-dessous un exemple minimal pour un nouveau fichier ; pour un fichier existant, transférez uniquement les champs Rate Cloud.

{
  "models": {"providers": {"ratecloud": {
    "baseUrl": "https://llm.rate-cloud.com/v1",
    "apiKey": "VOTRE_CLÉ_API",
    "api": "openai-completions",
    "models": [
      {"id":"glm-5.3","name":"GLM 5.3"},
      {"id":"glm-5.3-flash","name":"GLM 5.3 Flash"},
      {"id":"deepseek-v4.1-flash","name":"DeepSeek V4.1 Flash"},
      {"id":"deepseek-v4-pro","name":"DeepSeek V4 Pro"},
      {"id":"qwen-3.8-max","name":"Qwen 3.8 Max"}
    ]
  }}},
  "agents": {"defaults": {"model": {"primary": "ratecloud/glm-5.3"}}}
}

Continue pour VS Code manuellement

1. Installez l'extension Continue, fermez VS Code et enregistrez une copie ~/.continue/config.yaml (Windows: %USERPROFILE%\.continue\config.yaml).
2. Dans le tableau models: ajoutez une entrée pour chaque modèle. Pour un nouveau fichier, utilisez l'exemple ci-dessous ; dans un fichier existant, conservez ses autres entrées et ajoutez quatre blocs supplémentaires sur le même modèle, en changeant name и model selon le tableau.
3. Remplacez VOTRE_CLÉ_API, enregistrez le fichier et redémarrez VS Code. Dans le menu des modèles Continue, sélectionnez « Rate Cloud · GLM 5.3 ».

name: Rate Cloud
version: 1.0.0
schema: v1
models:
  - name: Rate Cloud · GLM 5.3
    provider: openai
    model: glm-5.3
    apiBase: https://llm.rate-cloud.com/v1
    apiKey: VOTRE_CLÉ_API
    useResponsesApi: false
    roles: [chat, edit, apply]

Pour les cinq modèles sans répéter le bloc manuellement, utilisez la commande automatique du tableau de bord : elle ajoutera le catalogue complet.

Hermes manuellement

1. Fermez Hermes, ouvrez ~/.hermes/config.yaml (Windows: %USERPROFILE%\.hermes\config.yaml) et conservez une copie.
2. Ajoutez le fournisseur et le modèle selon l'exemple ci-dessous. Si le fichier contient déjà d'autres paramètres, fusionnez les entrées sans remplacer tout le fichier.
3. Dans le fichier voisin .env ajoutez la ligne RATE_CLOUD_API_KEY="VOTRE_CLÉ_API". Enregistrez les deux fichiers et redémarrez Hermes.

model:
  provider: ratecloud
  default: glm-5.3
  base_url: https://llm.rate-cloud.com/v1
  api_mode: chat_completions
providers:
  ratecloud:
    api: https://llm.rate-cloud.com/v1
    api_key: ${RATE_CLOUD_API_KEY}
    models: [glm-5.3, glm-5.3-flash, deepseek-v4.1-flash, deepseek-v4-pro, qwen-3.8-max]

Zed, JetBrains AI Assistant et autres éditeurs

1. Dans les paramètres de l'éditeur, trouvez AI, Models ou Providers et ajoutez votre propre fournisseur compatible OpenAI. Si l'éditeur ne propose pas son propre Base URL, ce schéma de connexion ne lui convient pas.
2. Indiquez le nom Rate Cloud, Base URL https://llm.rate-cloud.com/v1 et le secret de la clé API. N'ajoutez pas /chat/completions dans le champ Base URL.
3. Ajoutez le modèle avec l'ID exact du tableau ci-dessus et sélectionnez-le pour le chat. Répétez pour les quatre autres si l'éditeur ne charge pas la liste via /models. Pour Zed et JetBrains, ouvrez l'onglet étape par étape « Manuellement » dans le tableau de bord — les noms des champs diffèrent.

Pour Zed, JetBrains AI Assistant et les extensions VS Code, le tableau de bord affiche les étapes manuelles avec les champs propres au client choisi. La commande automatique n'est proposée que lorsque l'installateur peut modifier la configuration en toute sécurité. Cursor ne fournit pas de méthode confirmée pour définir un Base URL compatible arbitraire pour ce schéma ; ne saisissez pas la clé dans une méthode de connexion non vérifiée.

09 / GESTION

Comment désactiver Rate Cloud

1. Ouvrez Connexion dans le tableau de bord et sélectionnez le même programme et OS que lors de l'installation.
2. Copiez la commande « Désinstaller » et exécutez-la dans Terminal ou PowerShell. L'installateur vérifiera si le fichier a été modifié après l'installation, puis restaurera les paramètres précédents à partir de sa copie de sauvegarde. Les chats et les projets restent en place.
3. Redémarrez le programme. Si vous avez modifié manuellement la configuration après l'installation et que la restauration refuse de l'écraser, enregistrez une nouvelle copie du fichier et supprimez uniquement les paramètres ratecloud manuellement.
4. Si la clé n'est plus nécessaire, désactivez-la ou supprimez-la séparément dans les paramètres des clés API. La suppression du fournisseur du programme ne révoque pas la clé en soi.

10 / AIDE

Si quelque chose ne fonctionne pas