Saltar al contenido principal

Solución de Problemas

Problemas comunes y cómo resolverlos.

No ocurre nada cuando presiono el atajo​

  1. Asegúrate de que SpokenCode está en ejecución. Busca el icono de SpokenCode en la bandeja del sistema (área inferior derecha de la barra de tareas de Windows). Si no está, inicia SpokenCode desde el Menú Inicio.

  2. Comprueba que tu micrófono está conectado y funcionando. Intenta grabar algo en otra app (como la Grabadora de voz de Windows) para confirmar que el micrófono funciona.

  3. Vuelve a registrar el atajo. Abre SpokenCode, ve a Configuración → Teclado, cambia el Modo de Grabación, haz clic en Guardar Configuración, luego cámbialo de vuelta y guarda de nuevo. Esto actualiza el registro del atajo.

La app me pide una clave de API​

Necesitas una clave de API de SpokenCode para usar la app.

  1. Visita spokencode.dev y crea una cuenta gratuita
  2. Copia tu clave de API — se muestra solo una vez en el registro
  3. Abre SpokenCode, ve a Configuración → Configuración de la API de SpokenCode → Clave de API
  4. Pega la clave y haz clic en Guardar Configuración
  5. Haz clic en Probar Conexión para verificar que la clave es válida

Mi transcripción es imprecisa​

  • Habla con claridad y coloca el micrófono cerca de tu boca
  • Establece tu idioma explícitamente en Configuración → Configuración de la API de SpokenCode → Idioma en lugar de usar la detección automática
  • Cambia a Whisper Large V3 en Configuración → Configuración de la API de SpokenCode → Modelo de Transcripción para la mayor precisión

Mi palabra clave de comando de voz no se reconoce​

  • La palabra clave debe estar al inicio de tu frase — decir "necesito una función javascript" no funcionará; di "javascript crear una función" en su lugar
  • Comprueba que Configuración → Idioma de Interfaz coincide con el idioma que estás hablando. Las palabras clave son diferentes para cada idioma (por ejemplo, el español usa "comando" en lugar de "command")
  • Habla a un ritmo normal — el habla rápida o poco clara puede reconocerse incorrectamente

Se me acabaron los créditos​

Tu saldo de créditos se muestra en la esquina superior derecha de la ventana de la app. Cuando llega a 0, la transcripción y la generación de código dejan de funcionar.

Compra más créditos en spokencode.dev.

La ventana flotante está en el camino​

Ve a Configuración → Configuración de Comportamiento y desmarca Mostrar Ventana Flotante, luego haz clic en Guardar Configuración. Puedes seguir usando todos los atajos con normalidad — la única diferencia es que no aparece ningún indicador visual durante la grabación.

La app desapareció y no puedo encontrarla​

SpokenCode se minimiza a la bandeja del sistema cuando cierras la ventana. Busca el icono de SpokenCode en la esquina inferior derecha de la barra de tareas de Windows (puede que necesites hacer clic en la flecha hacia arriba ^ para ver los iconos ocultos de la bandeja).

Haz clic derecho en el icono y selecciona Abrir Interfaz para mostrar la ventana de nuevo.

Obtener Más Ayuda​

Si ninguno de los pasos anteriores resuelve tu problema:

  1. Abre un informe de error en GitHub Issues

Al reportar, incluye:

  • Tu versión de SpokenCode (visible en la pestaña Acerca de)
  • Tu versión de Windows (ej.: Windows 11 23H2)
  • Una descripción del problema y lo que intentaste
  • Cualquier mensaje de error visible en pantalla