Połączenie i API
bez zgadywania

01 / START

Szybki start

1. Zarejestruj się lub zaloguj się w Rate Cloud. Potwierdź adres e-mail. Aby uzyskać bezpłatny trzygodzinny dostęp próbny, powiąż Telegram w panelu; po zakończeniu okresu próbnego potrzebna jest subskrypcja na wybrany model.
2. Otwórz Ustawienia → Klucze API i utwórz klucz. Skopiuj sekret od razu: po zamknięciu okna nie jest już pokazywany.
3. Otwórz Połączenie w panelu, wybierz program i system operacyjny. Zakładka «Automatycznie» pokazuje gotowe polecenie z twoim kluczem, jeśli automatyczna instalacja jest obsługiwana.
4. Wklej polecenie w Terminal lub PowerShell, zaczekaj na komunikat o pomyślnej instalacji, uruchom program ponownie i wybierz Rate Cloud. Jeśli wolisz konfigurację ręczną, na tej samej stronie otwórz zakładkę „Ręcznie”.
5. Wyślij krótką wiadomość testową. Lista modeli w programie zawiera wszystkie pięć pozycji; zapytanie do modelu zostanie wykonane przy aktywnej subskrypcji lub dostępie próbnym i odpowiednim dostępie klucza.

Automatyczna instalacja zmienia tylko konfigurację wybranego programu i tworzy kopię zapasową istniejącego pliku. Czaty nie są usuwane. Polecenie odłączające znajduje się obok polecenia podłączającego w panelu.

02 / DOSTĘP

Jak wydać klucz API

1. W panelu kliknij „Ustawienia”, przewiń do bloku „Klucze API” i kliknij „+ Utwórz klucz”.
2. Nadaj kluczowi zrozumiałą nazwę, na przykład „Codex na laptopie”. Nazwa jest potrzebna tylko tobie.
3. W „Dostępie do modeli” wybierz „Wszystkie aktywne modele”, jeśli chcesz automatycznie korzystać z przyszłych subskrypcji. Opcja „Tylko wybrane modele” ogranicza klucz do wymienionych modeli; samo wykupienie innej subskrypcji nie znosi tego ograniczenia.
4. Wybierz dostęp IP: „Dowolny IP” dla zwykłego laptopa albo listę dozwolonych adresów dla stałego serwera. Określ okres ważności. Jeśli używasz Codex lub Claude Code, zaznacz „Obsługa Codex / Claude Code”.
5. Kliknij „Utwórz klucz” i skopiuj pokazany sekret. Przechowuj go jak hasło. Jeśli zgubiłeś sekret, wygeneruj nowy klucz. Nie wklejaj klucza do publicznego repozytorium ani do zgłoszenia do wsparcia.

Klucz zarządza dostępem, subskrypcja — prawem do wykonywania zapytań do konkretnego modelu. Lista wszystkich pięciu modeli może być wyświetlana nawet bez subskrypcji; dzięki temu po zakupie nie trzeba konfigurować klienta od nowa. Dla Codex i Claude Code potrzebny jest klucz z włączoną kompatybilnością. Otwórz klucze API →

03 / KATALOG

Wszystkie pięć modeli

W polu model W API podawaj ID dokładnie tak, jak w tabeli. ID zapisuje się alfabetem łacińskim, małymi literami, z kropkami i myślnikami dokładnie tak, jak w tabeli. Nie dodawaj do ID prefiksu ratecloud/ w bezpośrednim API: jest potrzebny tylko do wyboru dostawcy wewnątrz niektórych programów.

Dokładne nazwy dla Codex i Claude Code

Tutaj wymienione są wszystkie warianty bez skrótów. W Codex podaj potrzebny wiersz w model, w Claude Code — w ANTHROPIC_MODEL.

Subskrypcję na każdy model wykupuje się osobno na stronie cen. Dostęp próbny i dostępność modelu sprawdzaj w panelu. Jeśli masz subskrypcję na kilka modeli, automatyczne polecenie domyślnie wybiera model z najstarszą aktywną subskrypcją. W klientach Codex identyfikatory mają postać ratecloud/glm-5.3, a w Claude Code — ocx-claude-ratecloud--glm-5.3; w ten sam sposób podstaw dowolny z pozostałych czterech ID.

04 / DLA DEWELOPERÓW

HTTP API i pierwsze zapytanie

Zapytania do /v1 przekazują nagłówek Authorization: Bearer TWÓJ_KLUCZ_API. Najpierw sprawdź katalog, a następnie wyślij proste zapytanie. W tych przykładach użyto GLM 5.3; zamień ID na jeden z pięciu modeli z aktywnym dostępem.

macOS / Linux: Terminal

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

Dla SDK kompatybilnego z OpenAI podaj Base URL https://llm.rate-cloud.com/v1, swój klucz i jeden z ID z tabeli. Do bezpośredniego zapytania Responses użyj tego samego klucza i /v1/responses.

05 / PROGRAMY

Codex CLI, aplikacja i VS Code

Prosta droga: w panelu wybierz «Codex», swój system operacyjny i «Automatycznie». Polecenie używa klucza z włączoną «Obsługą Codex / Claude Code». Po instalacji otwórz listę modeli i wybierz Rate Cloud. Rozszerzenie VS Code Codex korzysta z ustawień Codex.

Ręczna konfiguracja

1. Zainstaluj Codex zgodnie z instrukcją OpenAI. Zamknij Codex i VS Code.
2. Otwórz ~/.codex/config.toml na macOS/Linux lub %USERPROFILE%\.codex\config.toml w Windows. Jeśli plik istnieje, zachowaj kopię. Jeśli nie — utwórz plik tekstowy o tej nazwie.
3. Dodaj ustawienia globalne na początku pliku, przed sekcjami w nawiasach kwadratowych. Dodaj sekcję dostawcy na końcu. Zachowaj pozostałe ustawienia.

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"

W terminalu, z którego uruchamiasz Codex, ustaw RATE_CLOUD_API_KEY swoim sekretem: na macOS/Linux — export RATE_CLOUD_API_KEY='TWÓJ_KLUCZ_API', w PowerShell — $env:RATE_CLOUD_API_KEY='TWÓJ_KLUCZ_API'. Następnie w tym samym oknie uruchom codex. Uruchamiając VS Code z terminala, użyj code ., aby rozszerzenie otrzymało tę samą zmienną. Dla pozostałych modeli zamień część po ratecloud/ na żądany ID z tabeli.

Dla dokładnego przykładu ręcznego pod wybrany system operacyjny użyj zakładki „Ręcznie” w panelu. Format dostawcy sprawdzaj z dokumentacją Codex.

06 / PROGRAMY

Claude Code

Dla Claude Code potrzebny jest klucz z włączoną kompatybilnością Codex / Claude Code oraz ważny dostęp do wybranego modelu. W panelu wybierz Claude Code i swój system operacyjny: automatyczne polecenie skonfiguruje wykrywanie wszystkich pięciu modeli. Nazwa modelu w tym kliencie ma prefiks ocx-claude-ratecloud--.

Ręczne uruchomienie bez zmiany plików

Zainstaluj Claude Code, otwórz Terminal lub PowerShell i ustaw trzy zmienne przed poleceniem claude. Zamień tylko TWÓJ_KLUCZ_API i, w razie potrzeby, sufiks modelu.

macOS / Linux

export ANTHROPIC_BASE_URL='https://llm.rate-cloud.com/claude'
export ANTHROPIC_AUTH_TOKEN='TWÓJ_KLUCZ_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='TWÓJ_KLUCZ_API'
$env:ANTHROPIC_MODEL='ocx-claude-ratecloud--glm-5.3'
claude

Te zmienne działają w bieżącym terminalu. Automatyczna instalacja zapisuje ustawienia w ~/.claude/settings.json lub %USERPROFILE%\.claude\settings.json, nie naruszając historii czatów. Więcej o zmiennych i ustawieniach — w dokumentacji Claude Code.

07 / PROGRAMY

OpenCode

Automatyczne polecenie w panelu dodaje dostawcę Rate Cloud i wszystkie pięć modeli do konfiguracji OpenCode. Uwzględnia format zainstalowanej wersji OpenCode. W Windows konfiguracja znajduje się w %USERPROFILE%\.config\opencode\opencode.json; na macOS/Linux — w ~/.config/opencode/opencode.json.

Ręczny przykład dla OpenCode v1

Utwórz kopię istniejącego pliku, otwórz go w edytorze tekstowym i dodaj dostawcę do obiektu provider. Do nowego pliku pasuje pełny przykład poniżej. Zamień TWÓJ_KLUCZ_API na sekret, zapisz plik, uruchom ponownie OpenCode i otwórz /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": "TWÓJ_KLUCZ_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 używa innego formatu providers. Nie wklejaj przykładu v1 do konfiguracji v2: gotowy przykład obu wersji znajduje się w zakładce «Ręcznie» w panelu. Oficjalna dokumentacja OpenCode.

08 / PROGRAMY

OpenClaw, Continue, Hermes i inne

Dla OpenClaw, Continue i Hermes w panelu są automatyczne polecenia dla Windows, macOS i Linux, a także ręczne przykłady ze ścieżkami plików i przyciskami kopiowania. Wybierz program i system operacyjny przed skopiowaniem polecenia.

OpenClaw ręcznie

1. Zamknij OpenClaw. Otwórz wskazany powyżej openclaw.json i zachowaj kopię.
2. Dodaj dostawcę ratecloud в models.providers, nie usuwając innych wpisów. W agents.defaults.model.primary wskaż żądany ratecloud/ID.
3. Zamień TWÓJ_KLUCZ_API, zapisz plik i uruchom ponownie OpenClaw. Poniżej minimalny przykład dla nowego pliku; dla istniejącego przenieś tylko pola Rate Cloud.

{
  "models": {"providers": {"ratecloud": {
    "baseUrl": "https://llm.rate-cloud.com/v1",
    "apiKey": "TWÓJ_KLUCZ_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 dla VS Code ręcznie

1. Zainstaluj rozszerzenie Continue, zamknij VS Code i zachowaj kopię ~/.continue/config.yaml (Windows: %USERPROFILE%\.continue\config.yaml).
2. Do tablicy models: dodaj wpis dla każdego modelu. Dla nowego pliku użyj poniższego przykładu; w istniejącym zachowaj jego pozostałe wpisy i dodaj jeszcze cztery bloki według tego samego wzoru, zmieniając name и model według tabeli.
3. Zamień TWÓJ_KLUCZ_API, zapisz plik i uruchom ponownie VS Code. W menu modeli Continue wybierz «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: TWÓJ_KLUCZ_API
    useResponsesApi: false
    roles: [chat, edit, apply]

Dla wszystkich pięciu modeli, bez ręcznego powtarzania bloku, użyj automatycznego polecenia z panelu: doda ono pełny katalog.

Hermes ręcznie

1. Zamknij Hermes, otwórz ~/.hermes/config.yaml (Windows: %USERPROFILE%\.hermes\config.yaml) i zapisz kopię.
2. Dodaj dostawcę i model według przykładu poniżej. Jeśli plik zawiera już inne ustawienia, połącz wpisy, nie zastępując całego pliku.
3. Do sąsiedniego pliku .env dodaj wiersz RATE_CLOUD_API_KEY="TWÓJ_KLUCZ_API". Zapisz oba pliki i uruchom ponownie 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 i inne edytory

1. W ustawieniach edytora znajdź AI, Models lub Providers i dodaj własnego dostawcę kompatybilnego z OpenAI. Jeśli edytor nie udostępnia własnego Base URL, ten schemat połączenia mu nie odpowiada.
2. Podaj nazwę Rate Cloud, Base URL https://llm.rate-cloud.com/v1 i sekret klucza API. Nie dodawaj /chat/completions w polu Base URL.
3. Dodaj model z dokładnym ID z tabeli powyżej i wybierz go do czatu. Powtórz dla pozostałych czterech, jeśli edytor nie pobiera listy przez /models. Dla Zed i JetBrains otwórz w panelu zakładkę krok po kroku „Ręcznie” — nazwy pól są inne.

Dla Zed, JetBrains AI Assistant i rozszerzeń VS Code panel pokazuje kroki ręczne z polami właściwymi dla wybranego klienta. Polecenie automatyczne jest oferowane tylko tam, gdzie instalator może bezpiecznie zmienić konfigurację. Cursor nie udostępnia potwierdzonego sposobu ustawienia dowolnego kompatybilnego Base URL dla tego schematu; nie wprowadzaj klucza w niesprawdzony sposób połączenia.

09 / ZARZĄDZANIE

Jak odłączyć Rate Cloud

1. Otwórz Połączenie w panelu i wybierz ten sam program i system operacyjny co przy instalacji.
2. Skopiuj polecenie «Wyłącz» i wykonaj je w Terminalu lub PowerShell. Instalator sprawdzi, czy plik nie zmienił się po instalacji, a następnie przywróci poprzednie ustawienia z własnej kopii zapasowej. Czaty i projekty pozostają na miejscu.
3. Uruchom ponownie program. Jeśli ręcznie zmieniałeś konfigurację po instalacji, a przywracanie odmawia jej nadpisania, zapisz nową kopię pliku i usuń tylko ustawienia ratecloud ręcznie.
4. Jeśli klucz nie jest już potrzebny, odłącz go lub usuń osobno w ustawieniach kluczy API. Usunięcie dostawcy z programu samo w sobie nie unieważnia klucza.

10 / POMOC

Jeśli coś nie działa