Herramientas e integracionesGuía
Conecta OpenHands a CheapTokens: modelo, Base URL, clave
Rellena tres campos en OpenHands Settings > LLM (Advanced) para ejecutar el agente con un modelo de CheapTokens, y aprende a leer los tres fallos habituales.
En esta página
Puedes ejecutar OpenHands con un modelo de CheapTokens rellenando tres campos en Settings > LLM después de activar Advanced: Custom Model (openai/), Base URL (https:/) y API Key. Eso es toda la configuración. El resto de esta página explica qué significa cada campo y cómo se ve cuando uno de ellos está mal.
Los nombres de los campos y la regla del string de modelo provienen de la página de documentación de OpenHands sobre endpoints compatibles con OpenAI (consultada el 8 de noviembre de 2026; la página no tiene fecha ni versión). La última versión de OpenHands en esa fecha es la v1.37.0 (6 de noviembre de 2026). Si una etiqueta en tu build se ve algo distinta, guíate por la posición: modelo, base URL, clave.
Antes de abrir Settings#
Tener tres cosas a mano te ahorrará un viaje: la clave, el id del modelo y acceso a Settings.
Lista de verificación
¿Listo para configurar?
¿Es tu primera vez con claves y base URLs? Qué es base_url y cómo cambiarla lo cubre en unos minutos, y listar modelos con GET /v1/models muestra cómo buscar un id por tu cuenta.
Los tres campos#
Abre Settings > LLM y activa Advanced. El campo Base URL está debajo del interruptor Advanced.
La documentación describe la regla del modelo así: Custom Model es openai/ seguido del nombre del modelo, y si pasas por un proxy que tiene su propio prefijo, openai/. La parte después de openai/ es el nombre del modelo. Para CheapTokens el id es deepseek-, así que el string completo es openai/.
Desplaza la tabla hacia la derecha →
| Campo | Valor |
|---|---|
| Custom Model | openai/ |
| Base URL | https:/ |
| API Key | tu clave de CheapTokens |
¿Por qué este modelo para un agente? DeepSeek-V4-Flash tiene una ventana de contexto de 380K y hasta 32.768 tokens de salida por respuesta, y un único precio a cualquier hora, así que una sesión larga no se encarece en hora punta. Un agente de programación reenvía mucho contexto en cada paso, y para eso está la ventana.
¿Prefieres GLM? Usa openai/ (390K de contexto, hasta 8.192 tokens de salida) en el mismo campo y no cambies nada más. Mismo saldo, misma clave, misma Base URL.
Comprueba las piezas fuera de OpenHands primero#
Antes de culpar al agente, envía una petición con la misma URL, clave e id. Si esto funciona, cualquier problema que quede está en cómo escribiste los campos.
curl https://api.cheaptokens.dev/v1/chat/completions \
-H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-ai/DeepSeek-V4-Flash-0731","messages":[{"role":"user","content":"Say ready"}],"max_tokens":20}'Fíjate en lo que falta: no hay openai/ en el valor de model. Ese prefijo es para OpenHands, no para la API. La respuesta trae un bloque usage con prompt_tokens y completion_ — los mismos dos números que luego verás sumarse a lo largo de una sesión de agente.
Comparar
El string del modelo: un prefijo, dos resultados
Solo el id
deepseek- — la forma para curl y la API.
Con el prefijo
openai/ — la forma para el campo Custom Model.
Cómo se ve un campo incorrecto#
Cada uno de los tres campos puede ser la causa:
- Clave incorrecta. La API responde 401 — falta la clave, está mal escrita o tiene un espacio final por el copiado.
- Base URL incorrecta. La petición va al lugar equivocado y recibes un 404 o un error de conexión. La dirección debe terminar en
/v1y no contener ninguna ruta extra. - String de modelo incorrecto. O falta el prefijo, o el id que va después no es el id completo (la API solo acepta el
gateway_idcompleto, no un id corto comodeepseek-).v4- flash- 0731
El razonamiento completo sobre 401 frente a 404 está en API 401 o 404: clave, base URL o id de modelo incorrectos.
Pruébalo tú mismoPruébalo: la clave es correcta, la URL es correcta, el agente sigue fallando en el primer paso. ¿Qué campo abres?Mostrar respuesta
El campo Custom Model. Comprueba que empieza por openai/ y que el id que va después está escrito exactamente como en la tabla de arriba. La clave y la URL son las fáciles de verificar con curl.
Cuánto cuesta una sesión#
Un agente factura todo el contexto en cada paso, no tu tarea de una línea. Supón que OpenHands trabaja en un bug durante 40 pasos, con unos 30.000 tokens enviados y 1.500 escritos de vuelta por paso. Un paso con DeepSeek-V4-Flash es $0.0006; cuarenta de ellos están abajo, junto a los otros modelos y OpenRouter.
| Modelo | Entrada $/1M | Salida $/1M | Por solicitud | 40 solicitudes | OpenRouter, 40 solicitudes |
|---|---|---|---|---|---|
| GLM-5.3-Flash | $0.02 | $0.04 | $0.00066 | $0.0264 | $0.0452 |
| DeepSeek-V4-Flash | $0.015 | $0.10 | $0.0006 | $0.024 | $0.0924 |
| MiniMax-M2.7 | $0.05 | $0.15 | $0.0017 | $0.069 | $0.828 |
30.000 tokens de entrada y 1500 tokens de salida por solicitud. Los precios por 1M de tokens son actuales y cambian junto con nuestras tarifas; la columna de OpenRouter muestra precios de referencia para la misma carga de trabajo.
En total, contando entrada y salida juntas, DeepSeek-V4-Flash sale más barato que OpenRouter para esta carga de trabajo. Los supuestos son tuyos para cambiar: una corrección corta puede llevar 10 pasos, un refactor grande 100. Los precios actuales están en la página de precios, y la página del modelo es DeepSeek barato.
¿Ya usas OpenHands con otro proveedor?#
Entonces solo cambias tres valores: Custom Model, Base URL, API Key. Nada más en el proyecto cambia, y puedes volver atrás de la misma forma. La conexión paso a paso para la API en sí está en la documentación de CheapTokens; una configuración similar en otra herramienta es conectar Aider.
