Configuração de API personalizada do Immersive Translate

Updated 2026-09-05

Use a configuração de endereço personalizado documentada para avaliar um endpoint de tradução. Comece com uma página controlada e depois use leitura bilíngue para apoiar a revisão editorial.

Abra as configurações do serviço OpenAI

A página oficial do serviço OpenAI do Immersive Translate documenta um endereço de API personalizado em More Settings. Comece por ali ao avaliar um endpoint compatível com OpenAI. Registre a versão da extensão e o navegador para que uma verificação posterior de configuração aponte para um ambiente reproduzível.

Escolha uma configuração para o primeiro teste e mantenha as configurações padrão disponíveis para recuperação. Digite a credencial somente nas configurações privadas da extensão. Confirme que o endpoint é o destinatário pretendido antes de enviar qualquer conteúdo de página, sobretudo quando o navegador também tem acesso às telas de administração do comerciante.

Confira se o endereço é uma base ou uma rota completa

Não presuma que todo campo de endereço personalizado se comporta como um baseURL de SDK. A página oficial inclui uma URL completa de chat-completions em seu exemplo do Azure. Inspecione o texto de ajuda da extensão instalada e o caminho de solicitação de saída sanitizado para determinar como o endereço é usado.

Para um candidato de chat-completions da APIsRouter, a rota completa é https://api.apisrouter.com/v1/chat/completions. Se sua versão instalada esperar explicitamente uma base URL e acrescentar a rota, use https://api.apisrouter.com/v1. Evite um sufixo chat/completions duplicado. A planilha abaixo descreve configurações candidatas, não uma configuração de extensão testada.

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

Mantenha visível o caminho da solicitação de tradução

A extensão envia solicitações de tradução para o endereço de serviço selecionado. Trate esse endereço como uma decisão de compartilhamento de dados, não apenas como um campo de conectividade. Use conteúdo que você possui ou pode processar pelo endpoint escolhido e revise quanto da página a ação de tradução selecionada inclui.

O fluxo abaixo ilustra o caminho de gateway proposto usando o mecanismo de endereço personalizado documentado. O rótulo do modelo selecionado é uma escolha de configuração, não uma lista de modelos verificados. Autenticação da loja, edição de produtos e aprovações de importação estão fora deste caminho de solicitação.

Caminho proposto de endereço personalizado do Immersive Translate pela APIsRouter até um modelo selecionado do catálogo, para tradução no navegador em vez de atualizações da loja.Immersive Translate routes through More Settings + endereço personalizado to the APIsRouter gateway (api.apisrouter.com/v1), which fans out to: Selected catalog ID.Immersive TranslateviaMore Settings +endereço personalizadoAPIsRouterapi.apisrouter.com/v1Selected catalog ID
Substituição de endereço documentada; configuração de gateway proposta aguardando teste da extensão. A tradução do navegador não grava campos do catálogo.

Verifique primeiro uma página controlada

Use uma página curta com descrição sintética de produto, termo de marca protegido, quantidade com sua unidade e um link. Traduza somente essa página. Compare o resultado visível com a fonte e inspecione o destino de rede sanitizado, o modelo selecionado e o status da resposta.

Confira se o conteúdo foi omitido, duplicado ou misturado com o idioma da fonte. Depois tente um parágrafo mais longo e um layout com títulos ou listas. Salve a fonte e a saída observada para que uma alteração posterior de configuração possa ser comparada com o mesmo material. Isso fornece uma base diagnóstica útil antes de processar um documento grande.

Use leitura bilíngue para questões editoriais

A tradução do navegador pode ajudar um revisor a inspecionar material de origem desconhecido ou identificar uma frase que exige atenção. Mantenha o original visível e compare diretamente alegações, quantidades e terminologia. Se o revisor não puder avaliar o idioma-alvo, encaminhe o candidato a alguém que possa, em vez de aceitar aparência fluente como prova.

Mantenha decisões de glossário no fluxo do catálogo. Não presuma que um endpoint personalizado também fornece aplicação de glossário ou validação no nível do campo dentro da extensão. Descrições de produtos destinadas à importação ainda precisam de candidato ligado à fonte, resultado de revisão e mapeamento de destino próprios.

Diagnostique erros antes de traduzir mais conteúdo

Comece pelo caminho da solicitação, pela credencial e pelo ID exato do modelo. Registre erros estruturados quando disponíveis e redija cabeçalhos antes de compartilhar evidências. Se as solicitações estiverem limitadas, reduza o trabalho e respeite a orientação de tentativas do serviço em vez de repetir rapidamente uma tradução de página inteira.

Use um trecho menor selecionado para distinguir falha de conexão de problemas de conteúdo ou tratamento da resposta. Altere uma configuração por vez. A página oficial contém exemplos históricos de preço e taxa de solicitação; use a documentação e os limites de conta do seu endpoint atual em vez de copiar esses números para uma nova configuração.

SintomaInspecionePróxima verificação
Erro de rotaURL final realTratamento de base versus caminho completo
Erro de autenticaçãoEmissor da credencial e destinoConfigurações privadas e escopo da chave
Modelo rejeitadoCampo de modelo da solicitação exataCatálogo e elegibilidade da conta
Limite de taxaMetadados da resposta e carga de trabalhoLote menor e tentativa limitada
Tradução parcialConteúdo retornado e segmentação da páginaComparação de trecho controlado

Separe a saída do navegador da entrega do catálogo

Uma visualização traduzida no navegador é uma superfície de inspeção. Para publicar texto de produto, crie um candidato no pacote de revisão do catálogo, preserve identificadores e revisões da fonte e depois passe campos aprovados pelo caminho real de importação ou API de tradução da loja.

Verifique a entrega lendo campos armazenados e abrindo o locale pretendido da vitrine. Não dependa da extensão de navegador do editor para provar o que um visitante comum verá. Registre o uso das solicitações de tradução separadamente das operações da loja e contabilize tentativas ao avaliar o trabalho. Consulte os preços atuais em vez de presumir um custo fixo por página ou caractere.

Evidências e limites da integração

A documentação oficial estabelece uma configuração de endereço personalizado. Uma solicitação da extensão instalada pela APIsRouter não foi testada para este artigo; portanto, o comportamento preciso do endereço, a compatibilidade do modelo e o resultado renderizado continuam sendo verificações de configuração. O diagrama é um fluxo de configuração ilustrativo.

Um registro de compatibilidade concluído deve incluir versões da extensão e do navegador, configurações sanitizadas, destino da solicitação, modelo exato, uma página de fonte controlada e a tradução observada. Mantenha a revisão de campos protegidos separada da verificação de transporte. Um trecho curto bem-sucedido não valida automaticamente todos os formatos de documento nem um fluxo de publicação de loja.

Perguntas frequentes

Onde altero o endereço da API?

A documentação oficial do serviço OpenAI aponta para More Settings. Confira a versão instalada da extensão e sua ajuda de campo ao escolher o formato final do endereço.

Por que uma URL /v1 copiada às vezes falha?

As ferramentas diferem quanto a acrescentar uma rota ou esperar uma URL de solicitação completa. Inspecione o caminho de saída real e evite segmentos chat-completions ausentes ou duplicados.

Qual credencial pertence à configuração personalizada?

Use uma credencial emitida para o endpoint configurado e insira-a em privado. Uma credencial de outro provedor ou um token de administração da loja não a substitui.

Uma página de produto traduzida atualiza minha loja?

A tradução do navegador não é armazenamento do catálogo. Use o caminho de tradução ou importação da loja e verifique os campos armazenados para entregar texto de produto aprovado.

Como preservo a terminologia do produto?

Mantenha um glossário revisado no fluxo de conteúdo e compare o resultado do navegador com ele. Verifique separadamente qualquer recurso de glossário específico da extensão, em vez de presumir que o endereço personalizado aplica os termos.