Перайсці да дакументацыі
Rate Cloud
Адкрыць кабінет

RATE CLOUD / ДАКУМЕНТАЦЫЯ

Падключэнне і 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: ён патрэбны толькі для выбару правайдэра ўнутры некаторых праграм.

НазваID для HTTP APIВыбар у кліентах
GLM 5.3glm-5.3Rate Cloud / GLM 5.3
GLM 5.3 Flashglm-5.3-flashRate Cloud / GLM 5.3 Flash
DeepSeek V4.1 Flashdeepseek-v4.1-flashRate Cloud / DeepSeek V4.1 Flash
DeepSeek V4 Prodeepseek-v4-proRate Cloud / DeepSeek V4 Pro
Qwen 3.8 Maxqwen-3.8-maxRate Cloud / Qwen 3.8 Max

Дакладныя імёны для Codex і Claude Code

Тут пералічаны ўсе варыянты без скарачэнняў. У Codex укажыце патрэбны радак у model, у Claude Code — у ANTHROPIC_MODEL.

МадэльCodexClaude Code
GLM 5.3ratecloud/glm-5.3ocx-claude-ratecloud--glm-5.3
GLM 5.3 Flashratecloud/glm-5.3-flashocx-claude-ratecloud--glm-5.3-flash
DeepSeek V4.1 Flashratecloud/deepseek-v4.1-flashocx-claude-ratecloud--deepseek-v4.1-flash
DeepSeek V4 Proratecloud/deepseek-v4-proocx-claude-ratecloud--deepseek-v4-pro
Qwen 3.8 Maxratecloud/qwen-3.8-maxocx-claude-ratecloud--qwen-3.8-max

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

04 / РАСПРАЦОЎШЧЫКАМ

HTTP API і першы запыт

OpenAI-сумяшчальны Base URLhttps://llm.rate-cloud.com/v1
Каталог мадэлейGET https://llm.rate-cloud.com/v1/models
ЧатPOST https://llm.rate-cloud.com/v1/chat/completions
ResponsesPOST https://llm.rate-cloud.com/v1/responses
Codex Base URLhttps://llm.rate-cloud.com/codex/v1
Claude Code Base URLhttps://llm.rate-cloud.com/claude

Запыты да /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, а таксама ручныя прыклады са шляхамі файлаў і кнопкамі капіравання. Выберыце праграму і АС да капіравання каманды.

ПраграмаКуды дадаецца Rate CloudШто абраць пасля ўстаноўкі
OpenClaw~/.openclaw/openclaw.json, Windows: %USERPROFILE%\.openclaw\openclaw.jsonratecloud/glm-5.3 або іншая мадэль з каталога
Continue для VS Code~/.continue/config.yaml, Windows: %USERPROFILE%\.continue\config.yamlМадэль з назвай «Rate Cloud · …»
Hermes~/.hermes/config.yaml і суседні .envПравайдэр ratecloud і патрэбны ID
Іншы OpenAI-сумяшчальны кліентНалады ўласнага правайдара ў праграмеBase URL https://llm.rate-cloud.com/v1, ключ і ID мадэлі

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 / ДАПАМОГА

Калі нешта не працуе

Праграма бачыць пяць мадэляў, але запыт адхілены

Спіс мадэляў паказвае ўвесь каталог. Праверце актыўную падпіску або пробны даступ да абранай мадэлі, налады даступу ключа і яго тэрмін дзеяння. У кабінэце ёсць праверка падключэння з жывым запытам.

Codex або Claude Code паведамляе пра адмову

Праверце сцяжок «Падтрымка Codex / Claude Code» у ключа і адпаведны адрас: /codex/v1 для Codex, /claude для Claude Code. Звычайны ключ без такога дазволу не падыходзіць.

Ключ не бачны цалкам

Поўны сакрэт паказваецца пры стварэнні. Стварыце новы ключ і захавайце яго; маска існага ключа не дазваляе аднавіць сакрэт.

Каманда не запускаецца

На Windows выкарыстоўвайце PowerShell, на macOS/Linux — Terminal. Для аўтаматычнай устаноўкі патрэбны Python 3 і даступ да сайта. У Windows пры ўстаноўцы Python адзначце «Add python.exe to PATH», затым адкрыйце новы PowerShell. Не запускайце каманду Windows у cmd.exe.

Патрэбна дапамога з канкрэтнай праграмай

На старонцы падключэння выберыце праграму і АС: там знаходзяцца дакладныя каманды, шляхі і ручныя палі. Пры звароце ў падтрымку задайце назву праграмы, АС і тэкст памылкі, але не дасылайце сакрэт ключа.