# Clave API de Qwen Code: dónde obtenerla, conectarla y calcular el consumo > Qué es una clave API de Qwen Code, en qué se diferencia de una suscripción, dónde obtenerla, cómo configurar settings.json y qué determina el uso de tokens. Source: https://ailoot.ai/blog/es/qwen-code-api-key/ Canonical: https://ailoot.ai/blog/es/qwen-code-api-key/ Language: es Publisher: Ailoot (https://ailoot.ai/) Translation: guide-141 Revision: sha256-b5843bd6631327df186ca24895d6f780002bbf805b7fd7a5584db96d99333d0b Alguien instala Qwen Code, lo inicia en el terminal y, en la primera solicitud, le pide una clave. Entonces empieza la búsqueda: la gente escribe «buy api key for qwen code» y llega a páginas donde se vende una suscripción o el acceso preparado de otra persona. Aquí explicamos qué es la clave, dónde obtenerla y cuánto cuesta, paso a paso. Lo principal, desde el principio: nadie vende una clave API como un producto independiente. Es una cadena de acceso que tú mismo generas en la cuenta del proveedor del modelo, y generarla es gratis. Más adelante necesitarás dinero para recargar tu saldo; en ese paso se aplican las condiciones del proveedor. A continuación: dónde obtener una clave, cómo conectarla a Qwen Code y cuánto cuesta usarla.
Atención Este material es informativo y describe las reglas públicas. No menciona servicios intermediarios que ofrecen «gestionar» pagos eludiendo restricciones ni explica formas de eludirlas. Los precios se han tomado de las páginas de los proveedores y corresponden a principios de septiembre de 2026; cambian, así que consulta los precios actuales en el sitio del proveedor.
[Documentación de Ailoot](https://ailoot.ai/docs/) — materiales de referencia sobre el uso del servicio.
## ¿Qué es exactamente una clave API para Qwen Code?
Idea clave Una clave API para Qwen Code es una cadena personal parecida a una contraseña que el proveedor del servicio utiliza para identificar tus solicitudes al modelo y calcular su uso. Qwen Code en sí es un agente gratuito y de código abierto; no incorpora su propio modelo. Recibe respuestas de un proveedor externo y se identifica allí con tu clave. Por tanto, «obtener una clave» significa registrarse con un proveedor y generar una cadena de acceso en su cuenta. Proporciona el secreto mediante el entorno del terminal de inicio y referencia el nombre de su variable en la configuración de Qwen Code. Una solicitud al modelo que termine correctamente, además de guardar la configuración, confirma el acceso y puede generar cargos por uso.
Qwen Code es un agente de IA de código abierto que se ejecuta en el terminal y escribe código para tus tareas. Es gratis, se instala mediante npm y no contiene una red neuronal propia. El modelo realiza todo el trabajo inteligente y se ejecuta en los servidores del proveedor. Qwen Code necesita un pase para acceder al modelo. Ese pase es la clave API: una cadena larga parecida a una contraseña que el proveedor te emite personalmente. Cuando el agente envía una solicitud, adjunta la clave; el proveedor la utiliza para identificar de quién es la solicitud, responde y descuenta el uso de tu saldo. De aquí se desprende una idea sencilla que aclara la mitad de la confusión. Una clave no se compra como producto en un mercado: creas una cuenta con un proveedor, haces clic en «crear clave» y obtienes la cadena gratis. La búsqueda «buy api key» en realidad significa «¿dónde creo una cuenta y cómo pago después por el uso?». A continuación respondemos a ambas preguntas. ## ¿En qué se diferencia una clave API de una suscripción y del antiguo inicio de sesión gratuito?
Idea clave Qwen Code admite varias vías de autenticación y facturación. El antiguo nivel gratuito Qwen OAuth se interrumpió el 15 de abril de 2026. Alibaba Coding Plan utiliza una suscripción y un endpoint dedicado; una clave API estándar de Model Studio utiliza pago por uso. Los clientes actuales también ofrecen otras plataformas y planes. Esta guía cubre la clave API estándar de Model Studio: mantén coherentes región, endpoint, modelo y plan de facturación.
Dentro de Qwen Code, `/auth` muestra las opciones de autenticación admitidas por la versión instalada. Elige la plataforma que emitió la clave y su plan de facturación. Las distinciones siguientes explican el antiguo acceso gratuito, Coding Plan y la clave API estándar usada aquí; no son una lista exhaustiva del menú actual. La primera opción es iniciar sesión gratis mediante una cuenta de Qwen (Qwen OAuth). Antes daba acceso al modelo sin necesidad de una clave, pero se interrumpió.

El nivel gratuito de Qwen OAuth se interrumpió el 15 de abril de 2026. Es posible que los tokens guardados anteriormente sigan funcionando durante un tiempo, pero las nuevas solicitudes serán rechazadas.

— Qwen Code Docs, Autenticación, documentación oficial
La segunda opción es la suscripción Coding Plan de Alibaba ModelStudio. Tiene una cuota mensual fija que te da una cuota semanal de solicitudes y una dirección de conexión independiente. La tercera opción es la clave API de un proveedor de modelos. No hay una cuota fija: ingresas dinero en tu saldo y lo gastas a medida que trabajas, según el contador de tokens. Esta opción es flexible y te conviene si usas el agente de forma irregular. El resto de este artículo se centra en ella. ## ¿Dónde puedes obtener una clave API para Qwen Code?
Idea clave Qwen Code puede utilizar varios protocolos y proveedores. Para la vía directa de Alibaba, utiliza Model Studio. La clave, la región o espacio de trabajo, la URL base, el plan de facturación y el modelo deben pertenecer al mismo entorno; una dirección genérica de consola no basta.
Como Qwen Code entiende distintos protocolos, no estás limitado a un solo proveedor de claves. La documentación oficial enumera explícitamente los servicios a los que puede conectarse.

Compatible con los protocolos de OpenAI, Anthropic, Gemini y Qwen. Cualquier proveedor externo o modelo local. Cambia sobre la marcha.

— Qwen Code Docs, Autenticación, documentación oficial
A continuación se describe la vía de conexión directa. Para la vía directa, abre la [consola Alibaba Model Studio](https://modelstudio.console.alibabacloud.com/), selecciona la región prevista y crea una clave en la gestión de claves API. Conserva la región y el nombre del espacio de trabajo junto a la configuración; no copies la clave en notas compartidas. | Región de la clave | URL base estándar compatible con OpenAI | Qué comprobar | |----|----|----| | China (Pekín) | `DASHSCOPE_BASE_URL` | Clave de Pekín y modelo disponible en esa región | | Singapur | `DASHSCOPE_BASE_URL` | Clave de Singapur y modelo disponible en esa región | | Estados Unidos (Virginia), incluidos despliegues Global o US | Copia el API Host del espacio de trabajo estadounidense seleccionado y utiliza su URL base compatible con OpenAI documentada | Clave del espacio estadounidense, ámbito de despliegue y modelos; no reutilices direcciones de Pekín o Singapur | La [guía regional](https://www.alibabacloud.com/help/en/model-studio/regions) recomienda dominios dedicados al espacio de trabajo para producción. Copia el API Host real desde Workspace Management y sigue la [guía de URL base](https://www.alibabacloud.com/help/en/model-studio/base-url); no inventes un ID de espacio. Los endpoints DashScope compartidos y los dedicados son opciones distintas. Coding Plan y Token Plan también utilizan endpoints y claves propios. Copia la URL base completa compatible con OpenAI desde la consola del espacio de trabajo de la región elegida a `DASHSCOPE_BASE_URL`. El JSON omite `baseUrl`; antes de iniciar se proporciona mediante `OPENAI_BASE_URL`. Usa valores reales de la consola, no un identificador de ejemplo. También hay una opción gratuita que no requiere ninguna clave: ejecutar un modelo Qwen en tu ordenador mediante Ollama y conectar Qwen Code a él como a tu propio servidor. Hace falta una máquina potente y una configuración aparte. En la guía sobre [cómo iniciar Qwen Code en el terminal](https://ailoot.ai/blog/es/qwen-code-terminal-auto-edit/) se explica cómo ejecutar el agente localmente. ## ¿Cómo se añade la clave a Qwen Code para que funcione?
Idea clave En `~/.qwen/settings.json`, configura el protocolo, la URL base regional, el ID del modelo y `envKey`, el nombre de la variable de entorno que proporciona la clave. Mantén el valor secreto fuera de este JSON. Inicia Qwen Code desde el terminal que contiene la variable, verifica la conexión y envía un prompt breve antes de considerar utilizable la configuración. `/model` enumera las opciones configuradas; por sí solo no demuestra acceso al proveedor.
Guarda una copia de los ajustes e integra esta conexión en `~/.qwen/settings.json` sin sobrescribir otros proveedores o preferencias. La configuración ilustrativa sigue el [ejemplo de autenticación de Qwen Code](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) con la URL del espacio de trabajo mediante `OPENAI_BASE_URL`, la clave API leída de la variable de entorno indicada por `envKey` y sin el bloque `env` con el secreto en texto claro. `qwen3-coder-plus` es el modelo de ese ejemplo oficial; confirma primero que tu región y cuenta lo ofrecen o utiliza un ID real de la consola regional en ambos campos. Copia la URL base completa compatible con OpenAI desde la consola del espacio de trabajo de la región elegida a `DASHSCOPE_BASE_URL`. El JSON omite `baseUrl`; antes de iniciar se proporciona mediante `OPENAI_BASE_URL`. Usa valores reales de la consola, no un identificador de ejemplo. ```json { "modelProviders": { "openai": [ { "id": "qwen3-coder-plus", "name": "qwen3-coder-plus", "envKey": "DASHSCOPE_API_KEY" } ] }, "security": { "auth": { "selectedType": "openai" } }, "model": { "name": "qwen3-coder-plus" } } ``` `openai` selecciona el protocolo compatible. `envKey` nombra la variable que lee Qwen Code; no es el valor de la clave. `model.name` debe coincidir con el `id` configurado. La [referencia de proveedores](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/model-providers/) documenta estos campos. En macOS o Linux, abre un terminal Bash, introduce la clave en la entrada oculta e inicia Qwen Code en el mismo terminal: ```bash read -r -p 'Workspace OpenAI-compatible Base URL (copy from regional console): ' DASHSCOPE_BASE_URL if [[ -z "$DASHSCOPE_BASE_URL" || ! "$DASHSCOPE_BASE_URL" =~ ^https:[/][/] || "$DASHSCOPE_BASE_URL" == *'{'* || "$DASHSCOPE_BASE_URL" == *'}'* ]]; then printf '%s\n' 'STOP: supply the real regional workspace Base URL.' >&2 else read -r -s -p 'DashScope API key: ' DASHSCOPE_API_KEY printf '\n' if [[ -n "$DASHSCOPE_API_KEY" ]]; then export DASHSCOPE_API_KEY export OPENAI_BASE_URL="$DASHSCOPE_BASE_URL" qwen else printf '%s\n' 'STOP: API key is empty.' >&2 fi fi ``` En Windows utiliza PowerShell: ```powershell $env:DASHSCOPE_BASE_URL = Read-Host 'Workspace OpenAI-compatible Base URL (copy from regional console)' if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_BASE_URL) -or $env:DASHSCOPE_BASE_URL -notmatch '^https:[/][/]' -or $env:DASHSCOPE_BASE_URL -match '[{}]') { throw 'Supply the real regional workspace Base URL.' } $qwenKey = Read-Host 'DashScope API key' -AsSecureString $env:DASHSCOPE_API_KEY = [System.Net.NetworkCredential]::new('', $qwenKey).Password if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_API_KEY)) { throw 'API key is empty.' } $env:OPENAI_BASE_URL = $env:DASHSCOPE_BASE_URL qwen ``` Estos comandos mantienen el secreto fuera del JSON y del historial de comandos; el proceso lo recibe igualmente en su entorno. No lo imprimas, no lo incluyas en Git ni lo pegues en un prompt. Elimina la antigua entrada `env` con el secreto al adoptar esta vía. En un terminal nuevo debes volver a proporcionar la variable. Dentro de Qwen Code, usa `/doctor` para revisar la autenticación y `/model` para comprobar el modelo configurado. En una carpeta de prueba vacía e inocua, envía: «Responde con la palabra connected. No leas ni cambies archivos ni ejecutes comandos». Una respuesta correcta prueba una solicitud al modelo y puede generar cargos. Que un modelo aparezca en `/model` solo confirma la configuración local. Si falla, registra el error sin secretos y el ID de solicitud cuando se facilite. Comprueba la autenticación por separado de la disponibilidad y la facturación: plataforma emisora, región/espacio de trabajo, endpoint estándar o de plan, ID del modelo y saldo/cuota en la misma consola. Un 401 puede deberse a una incompatibilidad clave/endpoint o de plan; no demuestra que el proveedor esté averiado. Detente tras el fallo y corrige la discrepancia documentada antes de repetir la prueba. Este artículo describe un ejemplo documental, no una solicitud de pago ejecutada para la guía. ## ¿Cuánto cuesta trabajar con una clave API y qué hace que aumente la factura?
Idea clave Con una clave API pagas según el consumo: un precio por cada mil tokens de entrada y de salida, sin una cantidad mensual fija. Los modelos más ligeros, como Qwen3-Coder-Flash, cuestan varias veces menos. La factura crece con la cantidad de trabajo: cuanto más largos sean tus archivos y más lea y escriba el agente, mayor será el consumo. Consulta siempre el precio exacto en la página del proveedor, porque cambia.
La diferencia entre una clave y una suscripción es que no hay una cantidad mensual fija. Pagas por lo que el modelo lee y escribe, medido en tokens. Un token es un fragmento de texto de unos pocos caracteres. Cada modelo tiene su propio precio por millón de tokens de entrada y por millón de tokens de salida; la salida casi siempre cuesta más que la entrada. Un millón de tokens parece mucho, pero cuando trabajas en un proyecto grande se consume más rápido de lo que esperarías: el agente lee tus archivos completos en cada solicitud. La conclusión práctica es la siguiente: la factura depende de la cantidad de texto que procesa el agente. Los archivos largos, las sesiones largas y volver a leer código constantemente consumen tu saldo más rápido; el número de tareas es secundario. Otro artículo explica paso a paso [cómo se calcula el uso de tokens API](https://ailoot.ai/blog/es/api-token-usage-calculation/) y por qué el saldo puede agotarse sin que te des cuenta. ## ¿Por qué se rechazan los pagos?
Idea clave Para empezar a gastar con la clave, tienes que recargar tu saldo. Si el sistema de pago rechaza tu tarjeta por el banco que la emitió, cambiar el correo electrónico, el idioma o la configuración del perfil no cambia las condiciones de esa tarjeta.
Aquí es donde se comete un error habitual. El obstáculo aparece en el paso siguiente. Has obtenido la clave, pero sin dinero en el saldo no podrá gastar nada: el proveedor devolverá un error de fondos insuficientes. Si el rechazo está relacionado con el banco que emitió la tarjeta, cambiar el correo electrónico, el idioma de la interfaz o la configuración del perfil no modifica las condiciones de pago. Este mecanismo se explica con el ejemplo de [una tarjeta extranjera para Claude](https://ailoot.ai/blog/es/claude-card-payment-requirements/). Y ten en cuenta que la pasarela de pago toma la decisión final. Puede rechazar el pago por sus propios motivos, y no hay garantías de que se procese. ## ¿Por dónde empezar?
Idea clave Distingue las vías de autenticación y sus planes. Para una clave estándar de Model Studio, mantén coherentes región, espacio de trabajo, endpoint y modelo. Configura `envKey` sin secretos en JSON, proporciona la clave en el terminal de inicio y comprueba una respuesta real. Crear la clave y financiar el uso siguen siendo pasos distintos.
Un breve plan paso a paso: 1. Identifica la plataforma y el plan de facturación en las opciones de autenticación del cliente instalado. La antigua vía OAuth gratuita se interrumpió en abril de 2026. Esta lista cubre una clave estándar de Model Studio de pago por uso; otros planes y plataformas tienen sus propias vías documentadas. 2. Crea una cuenta con un proveedor. La opción más sencilla es Alibaba directamente. 3. Obtén una clave en la cuenta del proveedor, en la sección de claves de acceso. Obtenerla es gratis; no necesitas una tarjeta para ello. 4. Integra la conexión regional en `~/.qwen/settings.json` sin un valor secreto. Proporciona `DASHSCOPE_API_KEY` en el terminal de inicio y comprueba el modelo seleccionado y una respuesta breve como se muestra arriba. 5. Para pagar el uso necesitas una tarjeta emitida a tu nombre que acepte la pasarela de pago del proveedor. La pasarela determina las condiciones para recargar el saldo; obtener una clave y pagar por el uso son pasos distintos. También conviene tener en cuenta qué modelo necesitas. Para tareas exigentes, elige el Qwen3-Coder-Plus de gama alta; para ahorrar, elige el modelo Flash, más ligero y varias veces más barato para el mismo volumen. La guía sobre [Qwen Code como sustituto de Claude Code](https://ailoot.ai/blog/es/qwen-code-token-plan-setup/) explica en qué se diferencia Qwen Code de otros agentes de terminal.
### Fuentes - [Qwen Code - Repositorio de GitHub](https://github.com/QwenLM/qwen-code) - código del agente de código abierto, instalación, compatibilidad con varios protocolos y conexiones a proveedores externos - [Qwen Code - Documentación de autenticación](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) - opciones de plataforma y plan de facturación, interrupción del OAuth gratuito el 15.04.2026 y ajustes con credenciales proporcionadas mediante el entorno - [Alibaba Cloud ModelStudio - Consola](https://bailian.console.alibabacloud.com) - cuenta internacional donde obtener una clave para los modelos Qwen
Hay más materiales disponibles en [Ailoot](https://ailoot.ai/). ## Preguntas sobre Qwen Code ### ¿Emitir una clave de API equivale a comprar consumo del modelo? No. Emitir la cadena de acceso y financiar el consumo son pasos distintos. El proveedor identifica y mide las solicitudes mediante la clave; tenerla no demuestra que la cuenta disponga de saldo o cuota utilizable. ### ¿Qué debe coincidir en la configuración del proveedor de Qwen Code? El protocolo, la URL base del proveedor, la variable de entorno de la clave y el ID del modelo deben pertenecer a la misma conexión. En el ejemplo, model.name coincide con el id de modelProviders; excluye la clave real de las copias compartidas de configuración. ## Ailoot · La empresa y su cartera de proyectos Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI. La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.