1. Antes de empezar
- Necesitas el desbloqueo BYOK en tu cuenta — una compra única, consulta Precios. Inicia sesión en la app o la extensión con la cuenta que lo compró.
- Consigue una clave del proveedor: Gemini en Google AI Studio, o Qwen en Alibaba Cloud Model Studio (edición International).
- Hay un único campo de clave. Voxis reconoce el proveedor por la propia clave:
AIza…es Gemini,sk-…es Qwen. Puedes guardar ambas a la vez — Voxis elige el mejor motor según el idioma de destino (Qwen habla unos 29 destinos con voz natural; Gemini cubre los 79).
2. Añade una clave de Gemini
Crea una clave de API en Google AI Studio, copia el valor AIza…, pégalo en el campo de clave y guarda. Para Gemini no aparece fila de workspace — es normal; Gemini no lo necesita.
3. Añade una clave de Qwen — pega el archivo entero
Model Studio te entrega la clave como un pequeño archivo de credenciales descargable (CSV). La única regla que lo hace funcionar todo:
No pegues la ruta del archivo, ni pegues solo la clave. Abre el archivo, selecciona todo su contenido, cópialo y pégalo entero en el campo de clave.
Voxis lee de ese pegado las dos mitades de una vez: la clave de API y el workspace. El workspace importa porque una clave de Qwen pertenece a un workspace y — sobre todo en el navegador — el workspace forma parte de la propia dirección de conexión. Sin él, la clave no puede conectar.
- ¿Pegaste solo la clave
sk-…a secas? Voxis te pedirá el workspace por su nombre. - ¿Pegaste la ruta del archivo (como
C:\Users\…\key.csv)? Verás el aviso de "pega una clave de API" — pega el contenido del archivo. - Crea la clave en el Model Studio International. Una clave de la región equivocada falla como si fuera una clave inválida.
4. Empieza a traducir
En la extensión: abre la pestaña donde se reproduce el vídeo, haz clic en el icono de Voxis y mira la línea bajo el botón Iniciar — nombra la pestaña que se traducirá ("Iniciar traduce esta pestaña: …"). Si nombra la pestaña equivocada, cambia a la del vídeo y abre el popup allí. Luego pulsa Iniciar. En la app de Windows: elige Vídeo/Juego o Reunión y arranca — las primeras palabras traducidas pueden tardar unos segundos.
Si algo no funciona
- Aviso de "pega una clave de API" — pegaste una ruta de archivo o texto plano. Abre el archivo y pega su contenido.
- Un error justo tras Iniciar que nombra el workspace — falta el workspace. Vuelve a pegar el archivo de credenciales completo.
- Un error rápido y concreto sobre el emparejamiento clave/workspace — no se corresponden, o la región es incorrecta. Descarga el archivo de nuevo y pégalo otra vez.
- Conectado, pero en silencio — asegúrate de haber pulsado Iniciar en la pestaña que reproduce el vídeo y de que realmente está sonando.
- Un idioma no arranca solo con la clave de Qwen — ese destino no tiene voz de Qwen. Añade también una clave de Gemini; Voxis enruta automáticamente.