Підключення та API
без здогадок

01 / ПОЧАТОК

Швидкий старт

1. Зареєструйтеся або увійдіть у Rate Cloud. Підтвердьте пошту. Для безкоштовного тригодинного пробного доступу прив'яжіть Telegram у кабінеті; після завершення пробного періоду потрібна підписка на вибрану модель.
2. Відкрийте Налаштування → API-ключі і створіть ключ. Скопіюйте секрет одразу: після закриття вікна він більше не показується.
3. Відкрийте Підключення в кабінеті, виберіть програму та операційну систему. Вкладка «Автоматично» показує готову команду з вашим ключем, якщо автоматичне встановлення підтримується.
4. Вставте команду в Terminal або PowerShell, дочекайтеся повідомлення про успішне встановлення, перезапустіть програму та виберіть Rate Cloud. Якщо віддаєте перевагу ручному налаштуванню, на тій самій сторінці відкрийте вкладку «Вручну».
5. Надішліть коротке тестове повідомлення. Список моделей у програмі містить усі п'ять позицій; запит до моделі виконається за активної підписки або пробного доступу та відповідного доступу ключа.

Автоматичне встановлення змінює лише конфігурацію вибраної програми та зберігає резервну копію наявного файлу. Чати не видаляються. Команда відключення знаходиться поруч із командою підключення в кабінеті.

02 / ДОСТУП

Як випустити API-ключ

1. У кабінеті натисніть «Налаштування», прокрутіть до блоку «API-ключі» та натисніть «+ Створити ключ».
2. Дайте ключу зрозуміле ім'я, наприклад «Codex на ноутбуці». Ім'я потрібне лише вам.
3. У «Доступі до моделей» виберіть «Усі активні моделі», якщо хочете автоматично використовувати майбутні підписки. Варіант «Тільки вибрані моделі» обмежує ключ переліченими моделями; придбання іншої підписки саме по собі це обмеження не зніме.
4. Виберіть IP-доступ: «Будь-який IP» для звичайного ноутбука або список дозволених адрес для постійного сервера. Вкажіть термін дії. Якщо використовуєте Codex або Claude Code, увімкніть прапорець «Підтримка Codex / Claude Code».
5. Натисніть «Створити ключ» і скопіюйте показаний секрет. Зберігайте його як пароль. Якщо втратабо секрет, випустіть новий ключ. Не вставляйте ключ у публічний репозиторій або звернення до підтримки.

Ключ керує доступом, підписка — правом виконувати запити до конкретної моделі. Список усіх п'яти моделей може відображатися навіть без підписки; це дозволяє не переналаштовувати клієнт після придбання. Для Codex і Claude Code потрібен ключ з увімкненою сумісністю. Відкрити API-ключі →

03 / КАТАЛОГ

Усі п'ять моделей

У поле model API передавайте ID точно як у таблиці. ID пишеться латиницею, малими літерами, з крапками й дефісами точно як у таблиці. Не додавайте до ID префікс ratecloud/ у прямому API: він потрібен лише для вибору провайдера всередині деяких програм.

Точні імена для Codex і Claude Code

Тут перелічено всі варіанти без скорочень. У Codex вкажіть потрібний рядок у model, у Claude Code — у ANTHROPIC_MODEL.

Підписку на кожну модель оформлюють окремо на сторінці цін. Пробний доступ і доступність моделі перевіряйте в кабінеті. Якщо ви підписані на кілька моделей, автоматична команда вибирає за замовчуванням модель із найстарішою активною підпискою. У клієнтах Codex ID мають вигляд ratecloud/glm-5.3, а в Claude Code — ocx-claude-ratecloud--glm-5.3; таким самим чином підставте будь-який з решти чотирьох ID.

04 / РОЗРОБНИКАМ

HTTP API і перший запит

Запити до /v1 передають заголовок Authorization: Bearer ВАШ_API_КЛЮЧ. Спочатку перевірте каталог, потім надішліть простий запит. У цих прикладах використовується GLM 5.3; замініть ID на одну з п'яти моделей із чинним доступом.

macOS / Linux: Terminal

printf 'Вставьте 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 'Вставте 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

Для OpenAI-сумісного SDK вкажіть Base URL https://llm.rate-cloud.com/v1, ваш ключ і один з ID таблиці. Для прямого Responses-запиту використовуйте той самий ключ і /v1/responses.

05 / ПРОГРАМИ

Codex CLI, програма та VS Code

Простий шлях: у кабінеті виберіть «Codex», свою ОС і «Автоматично». Команда використовує ключ із увімкненою «Підтримкою Codex / Claude Code». Після встановлення відкрийте список моделей і виберіть Rate Cloud. Розширення VS Code Codex використовує налаштування Codex.

Ручне налаштування

1. Встановіть Codex за інструкцією OpenAI. Закрийте Codex і VS Code.
2. Відкрийте ~/.codex/config.toml на macOS/Linux або %USERPROFILE%\.codex\config.toml у Windows. Якщо файл існує, збережіть копію. Якщо ні — створіть текстовий файл із такою назвою.
3. Додайте глобальні параметри на початок файлу, перед розділами в квадратних дужках. Додайте секцію провайдера в кінець. Збережіть решту налаштувань.

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"

У терміналі, з якого запускаєте Codex, задайте RATE_CLOUD_API_KEY своїм секретом: на macOS/Linux — export RATE_CLOUD_API_KEY='ВАШ_API_КЛЮЧ', у PowerShell — $env:RATE_CLOUD_API_KEY='ВАШ_API_КЛЮЧ'. Потім у тому ж вікні запустіть codex. Під час запуску VS Code з термінала використовуйте code ., щоб розширення отримало ту саму змінну. Для решти моделей замініть частину після ratecloud/ на потрібний ID з таблиці.

Для точного ручного прикладу під вибрану ОС використовуйте вкладку «Вручну» у кабінеті. Формат провайдера звіряйте з документацією Codex.

06 / ПРОГРАМИ

Claude Code

Для Claude Code потрібен ключ з увімкненою сумісністю Codex / Claude Code і дійсний доступ до вибраної моделі. У кабінеті виберіть Claude Code і свою ОС: автоматична команда налаштує виявлення всіх п'яти моделей. Ім'я моделі в цьому клієнті має префікс ocx-claude-ratecloud--.

Ручний запуск без зміни файлів

Встановіть Claude Code, відкрийте Terminal або PowerShell і задайте три змінні до команди claude. Замініть лише ВАШ_API_КЛЮЧ і, за бажанням, суфікс моделі.

macOS / Linux

export ANTHROPIC_BASE_URL='https://llm.rate-cloud.com/claude'
export ANTHROPIC_AUTH_TOKEN='ВАШ_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='ВАШ_API_КЛЮЧ'
$env:ANTHROPIC_MODEL='ocx-claude-ratecloud--glm-5.3'
claude

Ці змінні діють у поточному терміналі. Автоматичне встановлення зберігає налаштування в ~/.claude/settings.json або %USERPROFILE%\.claude\settings.json, не торкаючись історії чатів. Докладніше про змінні та налаштування — у документації Claude Code.

07 / ПРОГРАМИ

OpenCode

Автоматична команда в кабінеті додає провайдера Rate Cloud і всі п'ять моделей до конфігурації OpenCode. Вона враховує формат встановленої версії OpenCode. На Windows конфігурація лежить у %USERPROFILE%\.config\opencode\opencode.json; на macOS/Linux — у ~/.config/opencode/opencode.json.

Ручний приклад для OpenCode v1

Створіть копію наявного файлу, відкрийте його в текстовому редакторі та додайте провайдера в об'єкт provider. Для нового файлу підійде повний приклад нижче. Замініть ВАШ_API_КЛЮЧ на секрет, збережіть файл, перезапустіть OpenCode і відкрийте /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": "ВАШ_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 використовує інший формат providers. Не вставляйте приклад v1 у конфігурацію v2: готовий приклад обох версій є у вкладці «Вручну» кабінету. Офіційна документація OpenCode.

08 / ПРОГРАМИ

OpenClaw, Continue, Hermes та інші

Для OpenClaw, Continue і Hermes у кабінеті є автоматичні команди для Windows, macOS і Linux, а також ручні приклади зі шляхами файлів і кнопками копіювання. Виберіть програму та ОС до копіювання команди.

OpenClaw вручну

1. Закрийте OpenClaw. Відкрийте вказаний вище openclaw.json і збережіть копію.
2. Додайте провайдера ratecloud в models.providers, не видаляючи інші записи. У agents.defaults.model.primary укажіть потрібний ratecloud/ID.
3. Замініть ВАШ_API_КЛЮЧ, збережіть файл і перезапустіть OpenClaw. Нижче мінімальний приклад для нового файлу; для наявного перенесіть лише поля Rate Cloud.

{
  "models": {"providers": {"ratecloud": {
    "baseUrl": "https://llm.rate-cloud.com/v1",
    "apiKey": "ВАШ_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 для VS Code вручну

1. Встановіть розширення Continue, закрийте VS Code і збережіть копію ~/.continue/config.yaml (Windows: %USERPROFILE%\.continue\config.yaml).
2. У масив models: додайте запис для кожної моделі. Для нового файлу використовуйте приклад нижче; у наявному збережіть його інші записи та додайте ще чотири блоки за тим самим зразком, змінюючи name и model за таблицею.
3. Замініть ВАШ_API_КЛЮЧ, збережіть файл і перезапустіть VS Code. У меню моделей Continue виберіть «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: ВАШ_API_КЛЮЧ
    useResponsesApi: false
    roles: [chat, edit, apply]

Для всіх п'яти моделей без ручного повторення блоку використовуйте автоматичну команду кабінету: вона додасть повний каталог.

Hermes вручну

1. Закрийте Hermes, відкрийте ~/.hermes/config.yaml (Windows: %USERPROFILE%\.hermes\config.yaml) і збережіть копію.
2. Додайте провайдера та модель за прикладом нижче. Якщо файл уже містить інші налаштування, об'єднайте записи, не замінюючи весь файл.
3. У сусідній файл .env додайте рядок RATE_CLOUD_API_KEY="ВАШ_API_КЛЮЧ". Збережіть обидва файли та перезапустіть 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 та інші редактори

1. У налаштуваннях редактора знайдіть AI, Models або Providers і додайте власний OpenAI-сумісний провайдер. Якщо редактор не пропонує свій Base URL, ця схема підключення йому не підходить.
2. Укажіть ім'я Rate Cloud, Base URL https://llm.rate-cloud.com/v1 і секрет API-ключа. Не додавайте /chat/completions у полі Base URL.
3. Додайте модель із точним ID з таблиці вище та виберіть її для чату. Повторіть для решти чотирьох, якщо редактор не завантажує список через /models. Для Zed і JetBrains відкрийте покрокову вкладку «Вручну» в кабінеті — назви полів відрізняються.

Для Zed, JetBrains AI Assistant і розширень VS Code у кабінеті показано ручні кроки з полями саме вибраного клієнта. Автоматична команда пропонується лише там, де установник може безпечно змінити конфігурацію. Cursor не надає підтвердженого способу задати довільний сумісний Base URL для цієї схеми; не вводьте ключ у неперевірений спосіб підключення.

09 / КЕРУВАННЯ

Як відключити Rate Cloud

1. Відкрийте Підключення в кабінеті і виберіть ту саму програму й ОС, що й під час встановлення.
2. Скопіюйте команду «Вимкнути» і виконайте її в Terminal або PowerShell. Інсталятор перевірить, чи не змінювався файл після встановлення, потім відновить попередні налаштування зі своєї резервної копії. Чати та проєкти залишаються на місці.
3. Перезапустіть програму. Якщо ви вручну змінювали конфігурацію після встановлення і відновлення відмовляється перезаписати її, збережіть нову копію файлу та приберіть лише налаштування ratecloud вручну.
4. Якщо ключ більше не потрібен, окремо відключіть або видаліть його в налаштуваннях API-ключів. Видалення провайдера з програми саме по собі не відкликає ключ.

10 / ДОПОМОГА

Якщо щось не працює