Proveedores de traducción pura

Qué es un proveedor de traducción pura, cuáles admite Read Frog, qué necesita cada uno y cuándo elegir uno en lugar de un proveedor LLM.

Qué es un proveedor de traducción pura

Un proveedor de traducción pura hace una sola cosa: le envías texto y te devuelve una traducción. No hay modelo que elegir, ni prompt que escribir, ni conversación. Read Frog los agrupa bajo Pure translation providers en Opciones → Proveedores de API → Add Provider.

Un proveedor LLM traduce porque se le pide que traduzca. Ese paso extra es lo que hace posibles el contexto de la página, la redacción de tu propio prompt y tu glosario, y también es la razón de que cueste más tokens y normalmente tarde más.

Qué no pueden hacer

Los proveedores de traducción pura se pueden asignar a la traducción de página, a los subtítulos de vídeo, a la traducción de la barra de selección y a la traducción de entrada. No pueden llevar nada que dependa de un prompt:

AI Smart Context no tiene ningún prompt que enriquecer, así que el ajuste no hace nada con estos proveedores.
Los prompts de traducción personalizados aparecen en gris en la ventana emergente cuando el proveedor seleccionado no es un LLM.
Las acciones de IA personalizadas y las sugerencias de notas requieren un proveedor LLM y no aceptan ninguno de estos.
La segmentación con IA de los subtítulos se omite; los subtítulos se traducen línea a línea según llegan.
Los términos del glosario se ignoran. El glosario viaja dentro del prompt de sistema, así que solo llega a la traducción con LLM.

Si tu glosario deja de surtir efecto de repente en una página, comprueba qué proveedor está usando esa función. Cada función elige su propio proveedor, así que la traducción de página puede estar en DeepL mientras tu barra de selección sigue en un LLM.

Los proveedores de este grupo

DeepL

La API oficial de DeepL. Necesita una API Key y nada más: no hay campo de Base URL, porque Read Frog elige el endpoint Free o Pro según la forma de tu clave. Consulta DeepL para los detalles y su manejo de los códigos de idioma.

DeepLX

Una API no oficial compatible con DeepL. Necesita una Base URL, y una clave de API solo si tu instancia la pide, así que una instancia pública gratuita funciona con el campo de clave vacío. La Base URL puede contener un marcador {{apiKey}} cuando tu proveedor espera el token en un sitio distinto de la ruta. Consulta DeepLX.

Google Translate y Microsoft Translator

Pertenecen a la misma familia pero no necesitan ninguna configuración: vienen ya añadidos y activados, no tienen credenciales que rellenar y no se pueden eliminar. Por eso no los encontrarás en el diálogo Add Provider.

Microsoft Translator no se puede combinar con el modo de página Solo traducción. Su endpoint no conserva el marcado, así que Read Frog bloquea esa combinación en lugar de dejar que corrompa la página.

Añadir y activar uno

Abre las opciones de Read Frog y ve a Proveedores de API.

Pulsa Add Provider y elige un proveedor del grupo Pure translation providers.

Rellena los campos que muestre ese proveedor: una clave de API para DeepL, una Base URL (y opcionalmente una clave) para DeepLX.

Usa Test Connection junto al campo de API Key y espera el resultado.

Activa el interruptor Enabled y luego asigna el proveedor a una función en Feature providers.

Un proveedor añadido pero no activado no aparecerá en los selectores de función. Asignarlo a una función desde su propio editor lo activa por ti.

Probar la conexión

Test Connection no es un ping: traduce la palabra Hi con tus ajustes reales, así que una marca verde significa que esta configuración exacta ha producido una traducción.

Una marca verde significa éxito; un reloj de arena significa que funcionó pero tardó más de tres segundos.
Una cruz roja significa que la solicitud falló. El motivo no se muestra en el botón, así que prueba una traducción en una página real para ver el texto del error.
El botón está desactivado mientras el campo de la clave de API está vacío, salvo en DeepLX, al que se le permite funcionar sin clave.
El resultado se borra a los pocos segundos, y se reinicia en cuanto editas el proveedor, la clave o la URL, así que una comprobación caducada nunca avala una configuración que hayas cambiado desde entonces.

Cuándo elegir uno de estos

Elige un proveedor de traducción pura cuando:

Traduces páginas largas o pistas de subtítulos completas y quieres la menor latencia por solicitud.
Quieres un coste predecible. DeepL factura caracteres, no tokens, y una clave gratuita de DeepL o una instancia pública de DeepLX no cuestan nada.
Tu cuota de LLM es escasa y prefieres gastarla en acciones de IA personalizadas antes que en traducir páginas al por mayor.

Quédate en un proveedor LLM cuando:

Dependes de un glosario, de un prompt personalizado o de AI Smart Context.
El texto necesita criterio y no fidelidad literal: expresiones hechas, chistes, jerga de un campo.
Quieres que un mismo proveedor sirva para la traducción y para las funciones de IA, en lugar de mantener dos.

Un buen término medio es poner la traducción de página en un proveedor de traducción pura y mantener la barra de selección en un LLM, así la vía rápida es barata y la vía cuidadosa sigue disponible para las palabras en las que te detienes.

Solución de problemas

«DeepL API key is not configured»

El campo de API Key está vacío. DeepL no tiene modo sin clave.

«DeepL translation request failed» o «DeepLX translation request failed»

El proveedor respondió con un estado de error. Read Frog añade a este mensaje el código de estado y el cuerpo del error del propio proveedor, que normalmente es lo más rápido que puedes leer. Las causas habituales son una clave no válida o caducada, una clave que no corresponde al plan y una cuota de caracteres agotada.

«API key is required when using `{{apiKey}}` placeholder in DeepLX baseURL»

Tu Base URL contiene el marcador pero el campo de API Key está vacío. Rellena la clave o quita el marcador de la URL.

«Unexpected response format from DeepLX translation API»

La solicitud tuvo éxito pero el cuerpo no era lo que devuelve una instancia de DeepLX. Read Frog espera JSON con la traducción en un campo de texto data. Las instancias públicas reconvertidas para otra cosa o puestas detrás de una página de inicio de sesión suelen fallar aquí.