Configuración de API personalizada de Immersive Translate

Abre los ajustes del servicio de OpenAI

La página oficial del servicio de OpenAI de Immersive Translate documenta una dirección de API personalizada en More Settings. Empieza ahí al evaluar un endpoint compatible con OpenAI. Registra la versión de la extensión y el navegador para que una comprobación posterior de configuración se refiera a un entorno reproducible.

Elige una configuración para la primera prueba y conserva los ajustes predeterminados disponibles para recuperarlos. Introduce la credencial solo en los ajustes privados de la extensión. Confirma que el endpoint es el destinatario previsto antes de enviar contenido de una página, especialmente cuando el navegador también pueda acceder a pantallas de administración de comerciantes.

Comprueba si la dirección es una ruta base o completa

No supongas que todos los campos de dirección personalizada se comportan como un baseURL de SDK. La página oficial incluye una URL completa de chat-completions en su ejemplo de Azure. Inspecciona el texto de ayuda de la extensión instalada y la ruta de solicitud saliente saneada para determinar cómo se usa la dirección.

Para un candidato de chat-completions de APIsRouter, la ruta completa es https://api.apisrouter.com/v1/chat/completions. Si tu versión instalada espera explícitamente una URL base y añade la ruta, usa https://api.apisrouter.com/v1. Evita un sufijo chat/completions duplicado. La hoja de trabajo siguiente describe ajustes candidatos, no una configuración de extensión probada.

Service: OpenAI
Settings area: More Settings > custom API address
Full request URL candidate: https://api.apisrouter.com/v1/chat/completions
Base-only candidate, if required by installed version: https://api.apisrouter.com/v1
Credential: gateway key entered privately
Model: exact current catalog ID with verified chat behavior

Mantén visible la ruta de solicitud de traducción

La extensión envía las solicitudes de traducción a la dirección de servicio seleccionada. Trata esa dirección como una decisión sobre el intercambio de datos, no solo como un campo de conectividad. Usa contenido que controles o que puedas procesar mediante el endpoint elegido y revisa cuánto de una página incluye la acción de traducción seleccionada.

El flujo siguiente ilustra la ruta de gateway propuesta usando el mecanismo de dirección personalizada documentado. La etiqueta del modelo seleccionado es una decisión de configuración, no una lista de modelos verificados. La autenticación de tienda, la edición de productos y las aprobaciones de importación están fuera de esta ruta de solicitud.

Verifica primero una página controlada

Usa una página breve con una descripción sintética de producto, un término de marca protegido, una cantidad con su unidad y un enlace. Traduce solo esa página. Compara el resultado visible con la fuente e inspecciona el destino de red saneado, el modelo seleccionado y el estado de la respuesta.

Comprueba si se omite, duplica o mezcla contenido con el idioma de origen. Después prueba un párrafo más largo y un diseño con encabezados o listas. Guarda la fuente y la salida observada para poder comparar un cambio de configuración posterior con el mismo material. Así tendrás una línea base diagnóstica útil antes de procesar un documento grande.

Usa la lectura bilingüe para las cuestiones editoriales

La traducción del navegador puede ayudar a un revisor a inspeccionar material de origen desconocido o identificar una frase que necesita atención. Mantén visible el original y compara directamente las afirmaciones, las cantidades y la terminología. Si el revisor no puede evaluar el idioma de destino, dirige el candidato a alguien que sí pueda hacerlo en lugar de aceptar la apariencia fluida como prueba.

Mantén las decisiones del glosario en el flujo del catálogo. No supongas que un endpoint personalizado también proporciona aplicación del glosario o validación a nivel de campo dentro de la extensión. Las descripciones de producto destinadas a importar todavía necesitan su propio candidato vinculado a la fuente, resultado de revisión y mapeo de destino.

Diagnostica los errores antes de traducir más contenido

Empieza por la ruta de solicitud, la credencial y el ID exacto del modelo. Registra los errores estructurados cuando estén disponibles y redacta las cabeceras antes de compartir evidencia. Si las solicitudes están limitadas, reduce la carga y respeta la guía de reintentos del servicio en lugar de repetir rápidamente una traducción de página completa.

Usa un pasaje seleccionado más pequeño para distinguir un fallo de conexión de problemas de contenido o de manejo de respuestas. Cambia un ajuste cada vez. La página oficial contiene ejemplos históricos de precios y tasas de solicitud; usa la documentación y los límites de cuenta del endpoint actual en lugar de copiar esas cifras en una configuración nueva.

Separa la salida del navegador de la entrega del catálogo

Una vista traducida en el navegador es una superficie de inspección. Para publicar texto de producto, crea un candidato en el paquete de revisión del catálogo, conserva los identificadores y las revisiones de origen y pasa después los campos aprobados por la API de importación o traducción real de la tienda.

Verifica la entrega leyendo los campos almacenados y abriendo el locale previsto del escaparate. No dependas de la extensión del navegador de un editor para demostrar lo que verá un visitante normal. Registra el uso de las solicitudes de traducción por separado de las operaciones de tienda y contabiliza los reintentos al evaluar la carga de trabajo. Consulta los precios actuales en lugar de suponer un coste fijo por página o carácter.

Evidencia y límites de integración

La documentación oficial establece un ajuste de dirección personalizada. Para este artículo no se ha probado una solicitud de una extensión instalada a través de APIsRouter, así que el comportamiento exacto de la dirección, la compatibilidad del modelo y el resultado renderizado siguen siendo comprobaciones de configuración. El diagrama es un flujo de configuración ilustrativo.

Un registro de compatibilidad completado debe incluir las versiones de la extensión y el navegador, los ajustes saneados, el destino de la solicitud, el modelo exacto, una página de origen controlada y la traducción observada. Mantén separada la revisión de campos protegidos de esa comprobación de transporte. Un pasaje corto correcto no valida automáticamente todos los formatos de documento ni un flujo de publicación de tienda.

Preguntas frecuentes