დაკავშირება და 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 'Paste your API key: '; 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":"Reply: working"}]}'
unset RATE_CLOUD_API_KEY

Windows: PowerShell

$env:RATE_CLOUD_API_KEY = Read-Host 'Paste your API key'
$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 = 'Reply: working' }) } | 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-compatible 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-compatible პროვაიდერი. თუ რედაქტორი საკუთარ 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 / დახმარება

თუ რამე არ მუშაობს