Свързване и 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 / ПОМОЩ

Ако нещо не работи