Ligação e API
sem suposições

01 / INÍCIO

Início rápido

1. Registe-se ou entre no Rate Cloud. Confirme o email. Para o acesso de teste gratuito de três horas, vincule o Telegram no painel; após o fim do período de teste, é necessária uma subscrição do modelo escolhido.
2. Abra Configurações → Chaves de API e crie a chave. Copie o segredo imediatamente: após fechar a janela, ele não é mais mostrado.
3. Abra Ligação no painel, selecione o programa e o sistema operativo. A aba «Automático» mostra um comando pronto com a sua chave, se a instalação automática for suportada.
4. Cole o comando no Terminal ou PowerShell, aguarde a mensagem de instalação bem-sucedida, reinicie o programa e selecione Rate Cloud. Se preferir configuração manual, na mesma página abra o separador «Manualmente».
5. Envie uma mensagem de teste curta. A lista de modelos do programa contém todas as cinco opções; o pedido ao modelo será executado com uma subscrição ativa ou acesso de teste e com acesso adequado da chave.

A instalação automática altera apenas a configuração do programa selecionado e guarda uma cópia de segurança do ficheiro existente. Os chats não são removidos. O comando de desligamento encontra-se ao lado do comando de ligação no painel.

02 / ACESSO

Como emitir uma chave de API

1. No painel, clique em «Configurações», desça até ao bloco «Chaves de API» e clique em «+ Criar chave».
2. Dê à chave um nome claro, por exemplo «Codex no portátil». O nome é apenas para si.
3. Em «Acesso aos modelos», selecione «Todos os modelos ativos» se quiser usar automaticamente subscrições futuras. A opção «Apenas modelos selecionados» restringe a chave aos modelos listados; comprar outra subscrição por si só não removerá esta restrição.
4. Escolha o acesso IP: «Qualquer IP» para um portátil comum ou a lista de endereços permitidos para um servidor permanente. Defina o prazo de validade. Se usar Codex ou Claude Code, ative a opção «Suporte Codex / Claude Code».
5. Clique em «Criar chave» e copie o segredo exibido. Guarde-o como uma palavra-passe. Se perder o segredo, emita uma nova chave. Não coloque a chave num repositório público ou num pedido de suporte.

A chave controla o acesso, a subscrição controla o direito de fazer pedidos a um modelo específico. A lista dos cinco modelos pode ser exibida mesmo sem subscrição; isso evita reconfigurar o cliente após a compra. Para Codex e Claude Code, é necessária uma chave com compatibilidade ativada. Abrir API keys →

03 / CATÁLOGO

Todos os cinco modelos

No campo model Passe o ID na API exatamente como na tabela. O ID escreve-se em latim, minúsculas, com pontos e hífens exatamente como na tabela. Não adicione prefixo ao ID ratecloud/ na API direta: ela só é necessária para selecionar o fornecedor dentro de alguns programas.

Nomes exatos para Codex e Claude Code

Aqui estão listadas todas as opções sem abreviaturas. No Codex, defina a linha pretendida em model, no Claude Code — em ANTHROPIC_MODEL.

A subscrição de cada modelo é contratada separadamente em página de preços. Verifique o acesso de teste e a disponibilidade do modelo no painel. Se estiver subscrito em vários modelos, o comando automático seleciona por predefinição o modelo com a subscrição ativa mais antiga. Nos clientes Codex, os IDs têm o formato ratecloud/glm-5.3, e no Claude Code — ocx-claude-ratecloud--glm-5.3; da mesma forma, insira qualquer um dos outros quatro IDs.

04 / PROGRAMADORES

HTTP API e primeiro pedido

Pedidos para /v1 transmitem o cabeçalho Authorization: Bearer O_SEU_API_KEY. Primeiro, verifique o catálogo e, em seguida, envie um pedido simples. Nestes exemplos, é usado o GLM 5.3; substitua o ID por um dos cinco modelos com acesso válido.

macOS / Linux: Terminal

printf 'Вставьте Chave de 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 'Cole a sua chave de 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

Para SDK compatível com OpenAI, defina o Base URL https://llm.rate-cloud.com/v1, a sua chave e um dos IDs da tabela. Para o pedido direto de Responses, use a mesma chave e /v1/responses.

05 / PROGRAMAS

Codex CLI, aplicação e VS Code

Caminho simples: em painel selecione «Codex», o seu SO e «Automático». O comando usa a chave com o «Suporte para Codex / Claude Code» ativado. Após a instalação, abra a lista de modelos e selecione Rate Cloud. A extensão Codex do VS Code usa as definições do Codex.

Configuração manual

1. Instale Codex conforme as instruções da OpenAI. Feche o Codex e o VS Code.
2. Abra ~/.codex/config.toml no macOS/Linux ou %USERPROFILE%\.codex\config.toml no Windows. Se o ficheiro existir, guarde uma cópia. Se não existir, crie um ficheiro de texto com esse nome.
3. Adicione os parâmetros globais no início do ficheiro, antes das secções entre colchetes. Adicione a secção do provedor no final. Mantenha as restantes configurações.

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"

No terminal a partir do qual executa o Codex, defina RATE_CLOUD_API_KEY com o seu segredo: no macOS/Linux — export RATE_CLOUD_API_KEY='O_SEU_API_KEY', no PowerShell — $env:RATE_CLOUD_API_KEY='O_SEU_API_KEY'. Depois, na mesma janela, execute codex. Ao iniciar o VS Code a partir do terminal, use code ., para que a extensão receba a mesma variável. Para os outros modelos, substitua a parte após ratecloud/ pelo ID necessário da tabela.

Para um exemplo manual exato para o SO selecionado, use o separador «Manualmente» no painel. Confira o formato do fornecedor com documentação do Codex.

06 / PROGRAMAS

Claude Code

Para o Claude Code, é necessária uma chave com compatibilidade Codex / Claude Code ativada e acesso válido ao modelo selecionado. Em painel selecione Claude Code e o seu SO: o comando automático configurará a deteção de todos os cinco modelos. O nome do modelo neste cliente tem o prefixo ocx-claude-ratecloud--.

Execução manual sem alterar ficheiros

Instale Claude Code, abra o Terminal ou o PowerShell e defina três variáveis antes do comando claude. Substitua apenas O_SEU_API_KEY e, se desejar, o sufixo do modelo.

macOS / Linux

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

Estas variáveis valem no terminal atual. A instalação automática guarda as definições em ~/.claude/settings.json ou %USERPROFILE%\.claude\settings.json, sem afetar o histórico dos chats. Mais detalhes sobre as variáveis e as definições — em documentação do Claude Code.

07 / PROGRAMAS

OpenCode

O comando automático no painel adiciona o provedor Rate Cloud e todos os cinco modelos à configuração do OpenCode. Ele considera o formato da versão instalada do OpenCode. No Windows, a configuração fica em %USERPROFILE%\.config\opencode\opencode.json; no macOS/Linux — em ~/.config/opencode/opencode.json.

Exemplo manual para OpenCode v1

Crie uma cópia do ficheiro existente, abra-o num editor de texto e adicione o fornecedor ao objeto provider. Para um ficheiro novo, o exemplo completo abaixo serve. Substitua O_SEU_API_KEY pelo segredo, guarde o ficheiro, reinicie o OpenCode e abra /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": "O_SEU_API_KEY"
      },
      "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 usa um formato diferente providers. Não cole o exemplo v1 na configuração v2: o exemplo pronto de ambas as versões está na aba «Manualmente» do painel. Documentação oficial do OpenCode.

08 / PROGRAMAS

OpenClaw, Continue, Hermes e outros

Para OpenClaw, Continue e Hermes, em painel há comandos automáticos para Windows, macOS e Linux, bem como exemplos manuais com caminhos de ficheiros e botões de copiar. Escolha o programa e o SO antes de copiar o comando.

OpenClaw manualmente

1. Feche o OpenClaw. Abra o indicado acima openclaw.json e guarde uma cópia.
2. Adicione o provedor ratecloud в models.providers, sem excluir as outras entradas. Em agents.defaults.model.primary indique o necessário ratecloud/ID.
3. Substitua O_SEU_API_KEY, guarde o ficheiro e reinicie o OpenClaw. Abaixo está um exemplo mínimo para um ficheiro novo; para um existente, transfira apenas os campos do Rate Cloud.

{
  "models": {"providers": {"ratecloud": {
    "baseUrl": "https://llm.rate-cloud.com/v1",
    "apiKey": "O_SEU_API_KEY",
    "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 para VS Code manualmente

1. Instale a extensão Continue, feche o VS Code e guarde uma cópia ~/.continue/config.yaml (Windows: %USERPROFILE%\.continue\config.yaml).
2. No array models: adicione uma entrada para cada modelo. Para um ficheiro novo, use o exemplo abaixo; num existente, conserve as restantes entradas e adicione mais quatro blocos seguindo o mesmo modelo, alterando name и model pela tabela.
3. Substitua O_SEU_API_KEY, guarde o ficheiro e reinicie o VS Code. No menu de modelos do Continue, selecione «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: O_SEU_API_KEY
    useResponsesApi: false
    roles: [chat, edit, apply]

Para todos os cinco modelos sem repetir manualmente o bloco, use o comando automático do painel: ele adicionará o catálogo completo.

Hermes manualmente

1. Feche o Hermes, abra ~/.hermes/config.yaml (Windows: %USERPROFILE%\.hermes\config.yaml) e guarde uma cópia.
2. Adicione o provedor e o modelo conforme o exemplo abaixo. Se o ficheiro já contiver outras configurações, una as entradas sem substituir o ficheiro inteiro.
3. No ficheiro ao lado .env adicione a linha RATE_CLOUD_API_KEY="O_SEU_API_KEY". Guarde ambos os ficheiros e reinicie o 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 e outros editores

1. Nas configurações do editor, procure AI, Models ou Providers e adicione um provedor próprio compatível com OpenAI. Se o editor não oferecer o seu próprio Base URL, este esquema de ligação não se aplica a ele.
2. Indique o nome Rate Cloud, Base URL https://llm.rate-cloud.com/v1 e o segredo da chave de API. Não adicione /chat/completions no campo Base URL.
3. Adicione o modelo com o ID exato da tabela acima e selecione-o para o chat. Repita para os restantes quatro, se o editor não carregar a lista via /models. Para Zed e JetBrains, abra o separador passo a passo «Manualmente» no painel — os nomes dos campos são diferentes.

Para Zed, JetBrains AI Assistant e extensões do VS Code, o painel mostra passos manuais com os campos exatos do cliente selecionado. O comando automático é oferecido apenas onde o instalador pode alterar a configuração com segurança. O Cursor não fornece uma forma confirmada de definir um Base URL compatível arbitrário para este esquema; não introduza a chave num método de ligação não verificado.

09 / GESTÃO

Como desligar o Rate Cloud

1. Abra Ligação no painel e selecione o mesmo programa e SO usados na instalação.
2. Copie o comando «Desativar» e execute-o no Terminal ou no PowerShell. O instalador verificará se o ficheiro foi alterado após a instalação e, em seguida, restaurará as definições anteriores a partir da sua cópia de segurança. Os chats e os projetos permanecem no lugar.
3. Reinicie o programa. Se alterou a configuração manualmente após a instalação e a restauração se recusar a substituí-la, guarde uma nova cópia do ficheiro e remova apenas as definições ratecloud manualmente.
4. Se a chave já não for necessária, desligue-a ou remova-a separadamente em definições das chaves de API. Remover o fornecedor do programa, por si só, não revoga a chave.

10 / AJUDA

Se algo não funcionar