Conexión y API
sin conjeturas

01 / INICIO

Inicio rápido

1. Regístrate o inicie sesión en Rate Cloud. Confirme su correo. Para el acceso de prueba gratuito de tres horas, vincule Telegram en el panel; una vez finalizado el período de prueba, necesita una suscripción al modelo elegido.
2. Abra Configuración → Claves de API y cree la clave. Copie el secreto de inmediato: tras cerrar la ventana ya no se muestra.
3. Abra Conexión en el panel, seleccione el programa y el sistema operativo. La pestaña «Automático» muestra un comando listo con su clave, si se admite la instalación automática.
4. Pega el comando en Terminal o PowerShell, espera el mensaje de instalación exitosa, reinicia el programa y selecciona Rate Cloud. Si prefieres la configuración manual, en la misma página abre la pestaña «Manual».
5. Envíe un mensaje corto de prueba. La lista de modelos del programa contiene las cinco posiciones; la solicitud al modelo se ejecutará si hay una suscripción activa o acceso de prueba y el acceso de la clave es adecuado.

La instalación automática solo modifica la configuración del programa elegido y guarda una copia de seguridad del archivo existente. Los chats no se eliminan. El comando de desconexión está junto al comando de conexión en el panel.

02 / ACCESO

Cómo crear una clave API

1. En el panel, haz clic en «Ajustes», desplázate al bloque «Claves API» y haz clic en «+ Crear clave».
2. Dale a la clave un nombre descriptivo, por ejemplo «Codex en portátil». El nombre es solo para ti.
3. En «Acceso a modelos» selecciona «Todos los modelos activos» si quieres usar automáticamente las suscripciones futuras. La opción «Solo modelos seleccionados» restringe la clave a los modelos listados; comprar otra suscripción no eliminará esta restricción por sí sola.
4. Elige el acceso IP: «Cualquier IP» para un portátil normal o una lista de direcciones permitidas para un servidor permanente. Indica la vigencia. Si usas Codex o Claude Code, activa la casilla «Compatibilidad Codex / Claude Code».
5. Haz clic en «Crear clave» y copia el secreto mostrado. Guárdalo como una contraseña. Si pierdes el secreto, crea una nueva clave. No incluyas la clave en un repositorio público ni en una consulta a soporte.

La clave controla el acceso, la suscripción da derecho a realizar solicitudes a un modelo concreto. La lista de los cinco modelos puede mostrarse incluso sin suscripción; esto evita tener que reconfigurar el cliente tras la compra. Para Codex y Claude Code se necesita una clave con la compatibilidad activada. Abrir API-claves →

03 / CATÁLOGO

Los cinco modelos

En el campo model En la API, pasa el ID exactamente como en la tabla. El ID se escribe en alfabeto latino, minúsculas, con puntos y guiones tal cual aparece en la tabla. No añadas prefijo al ID ratecloud/ en la API directa: solo hace falta para seleccionar el proveedor dentro de algunos programas.

Nombres exactos para Codex y Claude Code

Aquí se listan todas las opciones sin abreviar. En Codex indica la línea correspondiente en model, en Claude Code: en ANTHROPIC_MODEL.

La suscripción a cada modelo se contrata por separado en la página de precios. Compruebe el acceso de prueba y la disponibilidad del modelo en el panel. Si tiene suscripción a varios modelos, el comando automático selecciona por defecto el modelo con la suscripción activa más antigua. En los clientes Codex, los ID tienen la forma ratecloud/glm-5.3, y en Claude Code — ocx-claude-ratecloud--glm-5.3; del mismo modo, sustituya cualquiera de los otros cuatro ID.

04 / DESARROLLADORES

HTTP API y primera solicitud

Solicitudes a /v1 envían la cabecera Authorization: Bearer TU_CLAVE_API. Primero compruebe el catálogo y luego envíe una solicitud sencilla. En estos ejemplos se usa GLM 5.3; sustituya el ID por uno de los cinco modelos con acceso vigente.

macOS / Linux: Terminal

printf 'Вставьте Clave 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 'Pega tu clave 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 un SDK compatible con OpenAI, indica el Base URL https://llm.rate-cloud.com/v1, su clave y uno de los ID de la tabla. Para una solicitud Responses directa, use la misma clave y /v1/responses.

05 / PROGRAMAS

Codex CLI, aplicación y VS Code

Ruta sencilla: en panel seleccione «Codex», su SO y «Automático». El comando usa una clave con «Compatibilidad con Codex / Claude Code» activada. Tras la instalación, abra la lista de modelos y seleccione Rate Cloud. La extensión VS Code Codex usa la configuración de Codex.

Configuración manual

1. Instale Codex según la guía de OpenAI. Cierra Codex y VS Code.
2. Abra ~/.codex/config.toml en macOS/Linux o %USERPROFILE%\.codex\config.toml en Windows. Si el archivo existe, guarde una copia. Si no, cree un archivo de texto con ese nombre.
3. Añade los parámetros globales al inicio del archivo, antes de las secciones entre corchetes. Añade la sección del proveedor al final. Conserva el resto de ajustes.

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"

En el terminal desde el que ejecutas Codex, establece RATE_CLOUD_API_KEY con su secreto: en macOS/Linux — export RATE_CLOUD_API_KEY='TU_CLAVE_API', en PowerShell — $env:RATE_CLOUD_API_KEY='TU_CLAVE_API'. Luego en la misma ventana ejecuta codex. Al iniciar VS Code desde la terminal, use code ., para que la extensión reciba la misma variable. Para los demás modelos, sustituya la parte posterior a ratecloud/ por el ID que necesita de la tabla.

Para un ejemplo manual exacto según el SO seleccionado, usa la pestaña «Manual» en el panel. Compare el formato del proveedor con con la documentación de Codex.

06 / PROGRAMAS

Claude Code

Para Claude Code necesitas una clave con la compatibilidad Codex / Claude Code activada y acceso vigente al modelo seleccionado. En panel seleccione Claude Code y su SO: el comando automático configurará la detección de los cinco modelos. El nombre del modelo en este cliente lleva el prefijo ocx-claude-ratecloud--.

Ejecución manual sin modificar archivos

Instale Claude Code, abra Terminal o PowerShell y defina tres variables antes del comando claude. Sustituye solo TU_CLAVE_API y, si lo desea, el sufijo del modelo.

macOS / Linux

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

Estas variables surten efecto en la terminal actual. La instalación automática guarda los ajustes en ~/.claude/settings.json o %USERPROFILE%\.claude\settings.json, sin afectar al historial de chats. Más información sobre las variables y los ajustes, en de la documentación de Claude Code.

07 / PROGRAMAS

OpenCode

El comando automático del panel añade el proveedor Rate Cloud y los cinco modelos a la configuración de OpenCode. Detecta el formato de la versión instalada de OpenCode. En Windows la configuración se encuentra en %USERPROFILE%\.config\opencode\opencode.json; en macOS/Linux: en ~/.config/opencode/opencode.json.

Ejemplo manual para OpenCode v1

Cree una copia del archivo existente, ábralo en un editor de texto y añada el proveedor al objeto provider. Para un archivo nuevo sirve el ejemplo completo de abajo. Sustituye TU_CLAVE_API por el secreto, guarde el archivo, reinicie OpenCode y 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": "TU_CLAVE_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 usa un formato diferente providers. No pegue el ejemplo v1 en la configuración v2: el ejemplo listo para ambas versiones está en la pestaña «Manual» del panel. Documentación oficial de OpenCode.

08 / PROGRAMAS

OpenClaw, Continue, Hermes y otros

Para OpenClaw, Continue y Hermes en panel hay comandos automáticos para Windows, macOS y Linux, así como ejemplos manuales con rutas de archivo y botones de copia. Seleccione el programa y el SO antes de copiar el comando.

OpenClaw manualmente

1. Cierra OpenClaw. Abre el indicado arriba openclaw.json y guarde una copia.
2. Añade el proveedor ratecloud в models.providers, sin eliminar otras entradas. En agents.defaults.model.primary indique el que necesita ratecloud/ID.
3. Sustituye TU_CLAVE_API, guarde el archivo y reinicie OpenClaw. Aquí abajo tiene un ejemplo mínimo para un archivo nuevo; para uno existente, traslade solo los campos de Rate Cloud.

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

1. Instale la extensión Continue, cierre VS Code y guarde una copia ~/.continue/config.yaml (Windows: %USERPROFILE%\.continue\config.yaml).
2. En el array models: añada una entrada para cada modelo. Para un archivo nuevo, use el ejemplo de abajo; en uno existente, conserve sus demás entradas y añada otros cuatro bloques con el mismo patrón, cambiando name и model según la tabla.
3. Sustituye TU_CLAVE_API, guarde el archivo y reinicie VS Code. En el menú de modelos de Continue, seleccione «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: TU_CLAVE_API
    useResponsesApi: false
    roles: [chat, edit, apply]

Para los cinco modelos sin repetir el bloque manualmente, usa el comando automático del panel: añadirá el catálogo completo.

Hermes manualmente

1. Cierra Hermes, abre ~/.hermes/config.yaml (Windows: %USERPROFILE%\.hermes\config.yaml) y guarda una copia.
2. Añade el proveedor y el modelo según el ejemplo de abajo. Si el archivo ya contiene otros ajustes, combina las entradas sin reemplazar todo el archivo.
3. En el archivo adyacente .env añada la línea RATE_CLOUD_API_KEY="TU_CLAVE_API". Guarde ambos archivos y reinicie 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 y otros editores

1. En los ajustes del editor busca AI, Models o Providers y añade un proveedor propio compatible con OpenAI. Si el editor no ofrece su propio Base URL, este esquema de conexión no le sirve.
2. Indique el nombre Rate Cloud, Base URL https://llm.rate-cloud.com/v1 y el secreto de la clave de API. No añada /chat/completions en el campo Base URL.
3. Añade el modelo con el ID exacto de la tabla superior y selecciónalo para el chat. Repite para los otros cuatro si el editor no carga la lista mediante /models. Para Zed y JetBrains abre la pestaña paso a paso «Manual» en el panel; los nombres de los campos son distintos.

Para Zed, JetBrains AI Assistant y extensiones de VS Code, el panel muestra pasos manuales con los campos del cliente seleccionado. El comando automático solo se ofrece cuando el instalador puede modificar la configuración de forma segura. Cursor no ofrece un método verificado para establecer un Base URL compatible arbitrario para este esquema; no introduzcas la clave en un método de conexión no verificado.

09 / ADMINISTRACIÓN

Cómo desconectar Rate Cloud

1. Abra Conexión en el panel y seleccione el mismo programa y SO que en la instalación.
2. Copie el comando «Desconectar» y ejecútelo en Terminal o PowerShell. El instalador comprobará si el archivo se modificó después de la instalación y luego restaurará la configuración anterior desde su copia de seguridad. Los chats y proyectos permanecen intactos.
3. Reinicie el programa. Si modificó la configuración manualmente después de la instalación y la restauración se niega a sobrescribirla, guarde una copia nueva del archivo y elimine solo los ajustes ratecloud manualmente.
4. Si la clave ya no se necesita, desconéctala o elimínala por separado en en los ajustes de las claves de API. Eliminar el proveedor del programa no revoca la clave por sí mismo.

10 / AYUDA

Si algo no funciona