Lo que necesitas antes de abrir VS Code
Una clave de API de Qwen para VS Code es simplemente una clave de API más la configuración correcta del endpoint en una extensión. Reúne primero estos tres valores:
- URL base:
https://api.uncensoredqwen.com/v1 - ID de modelo:
uncensored - Clave de API: creada en la página de claves de API después de registrarte con Google o con correo electrónico y contraseña
Las cuentas nuevas pueden reclamar $0,50 de crédito de prueba con un solo clic en esa página. No requiere tarjeta, está limitado a uno por persona y es válido durante 7 días. Eso es suficiente para probar la configuración de un editor durante unos días de codificación real.
Una nota sobre la nomenclatura: el servicio es un modelo de pesos abiertos alojado ejecutado por un proveedor independiente. No es la API oficial de Alibaba, ni es un enrutador hacia otros proveedores. En tu editor aparecerá bajo el nombre de visualización que tú le asignes.
Prueba la clave con curl primero
Antes de cambiar cualquier configuración del editor, confirma que la clave y la URL funcionan por separado. Si esto falla, ninguna extensión tendrá éxito, y sabrás que el problema es la clave y no el plugin.
export API_KEY="paste-your-key-here"
curl https://api.uncensoredqwen.com/v1/models \
-H "Authorization: Bearer $API_KEY"
Una lista JSON que incluye uncensored significa que la autenticación funciona. Luego envía una completación real:
curl https://api.uncensoredqwen.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python function that reverses a string."}],"max_tokens":200}'
Los encabezados de respuesta incluyen X-Balance-USD, que es una forma rápida de ver el crédito restante sin salir de la terminal.
Añade el proveedor en una extensión de VS Code
Varias extensiones de VS Code para asistencia de codificación con IA pueden conectarse a cualquier servidor compatible con OpenAI. Las etiquetas varían ligeramente de una herramienta a otra, pero los campos se mapean uno a uno. Busca una opción de proveedor llamada "OpenAI Compatible", "OpenAI" con una URL base personalizada, o "endpoint personalizado".
| Campo de la extensión | Valor a ingresar |
|---|---|
| Proveedor | Compatible con OpenAI (o OpenAI con URL base personalizada) |
| URL base / Base de API | https://api.uncensoredqwen.com/v1 |
| Clave de API | Tu clave de cuenta |
| ID del modelo | uncensored |
Las extensiones que leen un archivo de configuración JSON suelen querer algo con esta forma. Los nombres exactos de las claves varían, así que consulta la documentación de tu extensión y adapta los nombres de los campos:
{
"models": [
{
"title": "Uncensored API",
"provider": "openai",
"model": "uncensored",
"apiBase": "https://api.uncensoredqwen.com/v1",
"apiKey": "paste-your-key-here"
}
]
}
No hagas commit de este archivo. Si tu configuración está dentro de un repositorio, usa el almacenamiento de secretos de la extensión o una variable de entorno, y añade la ruta de la configuración a .gitignore.
Después de guardar, abre el panel de chat de la extensión y envía un mensaje corto como "Explica esta función" con un archivo abierto. Una respuesta en streaming significa que la configuración está lista.
Corrige los errores de configuración comunes
La mayoría de las configuraciones fallidas se deben a una serie de errores tipográficos. Revisa esta lista en orden.
La URL tiene la forma incorrecta
La URL base termina en /v1. Las extensiones añaden /chat/completions ellas mismas. Si pegas la ruta completa, obtienes un 404 porque el cliente solicita /v1/chat/completions/chat/completions. Una barra final suele ser inofensiva, pero la falta de /v1 no lo es.
El nombre del modelo es incorrecto
Algunas extensiones rellenan automáticamente un menú desplegable de modelos con nombres de otro servicio. Sobrescríbelo con uncensored exactamente, en minúsculas. Si el campo es un menú desplegable sin una entrada personalizada, busca una opción de "modelo personalizado" u "otro".
La clave tiene caracteres extraños
Copiar desde una página web puede añadir un espacio o salto de línea final. Pégalo en un editor de texto plano, recórtalo y pégalo de nuevo. Una respuesta 401 casi siempre apunta a esto o a una clave de una cuenta diferente.
La extensión sigue comunicándose con su servidor predeterminado
Si tu saldo no cambia después de las solicitudes de chat, el editor puede estar utilizando un proveedor integrado. Comprueba que el perfil del modelo activo sea el que editaste y recarga la ventana después de cambiar la configuración.
Las peticiones fallan con 429
Ese es un límite de peticiones, cubierto en la siguiente sección. El cuerpo del error contiene un código que indica qué límite alcanzaste.
Comprueba que las peticiones lleguen realmente a la API
Los editores rara vez te dicen qué servidor respondió. Dos comprobaciones rápidas eliminan la duda.
- Observa el saldo. Ejecuta la llamada
/v1/modelso una llamada de completación corta desde la terminal, anota el encabezadoX-Balance-USD, envía tres mensajes de chat en el editor y luego repite la llamada desde la terminal. El número debería disminuir en una pequeña cantidad. La misma cifra está disponible desdeGET /v1/balance. - Pide algo que la configuración predeterminada rechazaría o manejaría de manera diferente. Una prueba pequeña e inofensiva es solicitar una respuesta en exactamente cinco palabras. Si la respuesta sigue la instrucción y llega en streaming, la conexión está sana.
Si el saldo no cambia, abre el panel de salida de la extensión o la consola del desarrollador. La mayoría de las extensiones registran la URL de la petición y el estado HTTP, y un host incorrecto aparece de inmediato. Corrige la URL base, recarga la ventana y vuelve a intentarlo.
Los equipos que comparten un repositorio deberían darle a cada persona una clave separada en lugar de un valor compartido. De esta manera, un límite de peticiones alcanzado por una persona no bloquea a las demás, y una clave filtrada puede reemplazarse sin molestar a los demás.
Autocompletado, chat y límites de peticiones
El chat es suave con los límites: una petición por mensaje. El autocompletado en línea es diferente. Muchas extensiones envían una petición tras una breve pausa al escribir, lo que puede producir docenas de llamadas por minuto mientras trabajas.
Conoce los números. Una clave completa permite 8 peticiones simultáneas y 300 peticiones por minuto. Una clave de prueba permite 2 simultáneas y 60 por minuto. Cuando los excedes, la API responde con HTTP 429 y el código rate_limited (demasiadas por minuto) o concurrency (demasiadas a la vez). En caso de sobrecarga temporal, también obtienes 429 con un encabezado Retry-After: 5. Una completación en streaming mantiene su espacio de concurrencia hasta que termina el streaming, por lo que los streams lentos cuentan contra ti por más tiempo.
Configuraciones prácticas que ayudan:
- Usa el servicio para chat, ediciones y explicaciones, y desactiva el autocompletado de pestañas o aumenta su retraso de debounce mientras estás en una clave de prueba.
- Reduce el número máximo de tokens de salida para el autocompletado a unas pocas decenas. Las completaciones cortas terminan rápidamente y liberan el espacio.
- Evita ejecutar varias ventanas del editor contra la misma clave durante una prueba.
Las peticiones fallidas o rechazadas no se cobran, por lo que los errores no cuestan nada más que tiempo.
Coste de una sesión de codificación
Los prompts de codificación son intensivos en entrada porque las extensiones adjuntan el contenido de los archivos. El precio es de $0,15 por cada 1M de tokens de entrada y $0,50 por cada 1M de tokens de salida. Considera un turno de chat que envía 6.000 tokens de código y contexto y recibe 800 tokens de vuelta:
- Entrada: 6.000 x $0,15 / 1.000.000 = $0,0009
- Salida: 800 x $0,50 / 1.000.000 = $0,0004
- Total: $0.0013 por turno
Con 100 de estos turnos en una jornada laboral, el costo es de $0,13. El crédito de prueba de $0,50 cubre aproximadamente 380 turnos de este tamaño ($0,50 / $0,0013 es aproximadamente 385). El crédito es prepago, no caduca, y las recargas son montos enteros desde $20 hasta $500, con un bono del 5% desde $50, 10% desde $100 y 15% desde $200. Consulta la página de precios para ver los métodos de pago.
La ventana de contexto es de 100.000 tokens, incluyendo prompt y completado. Si una extension indexa todo tu repositorio en cada prompt, las peticiones grandes costarán más y se acercarán a ese límite. Reduce el contexto a los archivos que realmente necesitas.
Privacidad y dónde leer más
Los prompts no se usan para entrenamiento. Aún así, el código fuente a menudo contiene secretos, así que mantén los archivos .env y las credenciales fuera de los archivos que adjuntas a un chat. La mayoría de las extensiones te permiten excluir rutas del contexto.
El modelo es solo de texto. Responde preguntas de codificación, redacta funciones, explica errores y admite llamadas a funciones y modo JSON, pero no genera imágenes, audio ni video. Para campos de petición y ejemplos más allá de esta página, lee la documentación de la API. Si algo sigue fallando después de las verificaciones anteriores, el artículo anterior sobre errores comunes de la API Qwen enumera más patrones de error con soluciones.
