Налаштування користувацького API Immersive Translate
Updated 2026-09-05
Використовуйте документоване налаштування користувацької адреси для оцінювання кінцевої точки перекладу. Почніть із контрольованої сторінки, а потім використовуйте двомовне читання для редакційної перевірки.
Відкрийте налаштування сервісу OpenAI
Офіційна сторінка сервісу OpenAI для Immersive Translate документує користувацьку API-адресу в More Settings. Почніть із неї під час оцінювання кінцевої точки, сумісної з OpenAI. Запишіть версію розширення та браузер, щоб подальша перевірка налаштування стосувалася відтворюваного середовища.
Оберіть одну конфігурацію для першого тесту та залиште налаштування за замовчуванням доступними для відновлення. Вводьте облікові дані лише в приватних налаштуваннях розширення. Підтвердьте, що кінцева точка є потрібним одержувачем, до надсилання будь-якого контенту сторінки, особливо коли браузер також має доступ до адміністративних екранів продавця.
Перевірте, чи є адреса базовим або повним маршрутом
Не припускайте, що кожне поле користувацької адреси працює як baseURL SDK. Офіційна сторінка містить повний URL chat-completions у прикладі Azure. Перегляньте довідку встановленого розширення та очищений шлях вихідного запиту, щоб визначити, як використовується адреса.
Для кандидата chat-completions APIsRouter повний маршрут — https://api.apisrouter.com/v1/chat/completions. Якщо ваша встановлена версія явно очікує базовий URL і додає маршрут, використовуйте натомість https://api.apisrouter.com/v1. Уникайте дубльованого суфікса chat/completions. Наведений нижче робочий аркуш описує можливі налаштування, а не перевірену конфігурацію розширення.
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Зробіть шлях запиту перекладу видимим
Розширення надсилає запити на переклад до вибраної адреси сервісу. Розглядайте цю адресу як рішення про обмін даними, а не лише поле з’єднання. Використовуйте контент, яким ви володієте або який можете обробляти через вибрану кінцеву точку, і перевірте, яку частину сторінки включає вибрана дія перекладу.
Наведений нижче процес ілюструє запропонований шлях шлюзу через документований механізм користувацької адреси. Ярлик вибраної моделі є конфігураційним рішенням, а не списком перевірених моделей. Автентифікація магазину, редагування товару та схвалення імпорту перебувають поза цим шляхом запиту.
Спочатку перевірте одну контрольовану сторінку
Використайте коротку сторінку із синтетичним описом товару, захищеним терміном бренду, кількістю з одиницею та посиланням. Перекладайте лише цю сторінку. Порівняйте видимий результат із джерелом і перевірте очищене мережеве призначення, вибрану модель та статус відповіді.
Перевірте, чи контент не пропущено, не продубльовано й не змішано з мовою джерела. Потім спробуйте довший абзац і макет із заголовками або списками. Збережіть джерело та спостережуваний результат, щоб наступну зміну конфігурації можна було порівняти з тим самим матеріалом. Це дає корисну діагностичну основу до обробки великого документа.
Використовуйте двомовне читання для редакційних питань
Переклад браузера може допомогти рецензенту перевірити незнайомий матеріал джерела або визначити фразу, що потребує уваги. Тримайте оригінал видимим і безпосередньо порівнюйте твердження, кількості й термінологію. Якщо рецензент не може оцінити цільову мову, передайте кандидата тому, хто може, а не приймайте плавне звучання за доказ.
Глосарійні рішення зберігайте в процесі каталогу. Не припускайте, що користувацька кінцева точка також забезпечує контроль глосарія або перевірку на рівні полів у розширенні. Описи товарів для імпорту все одно потребують власного кандидата з посиланням на джерело, результату перевірки та мапування призначення.
Діагностуйте помилки до перекладу більшого обсягу
Почніть зі шляху запиту, облікових даних і точного ID моделі. Де можливо, записуйте структуровані помилки та очищуйте заголовки до поширення доказів. Якщо запити обмежені, зменште навантаження та дотримуйтеся рекомендацій сервісу щодо повторів замість швидкого повторення повносторінкового перекладу.
Використайте менший вибраний уривок, щоб відрізнити збій з’єднання від проблем із контентом або обробкою відповіді. Змінюйте одне налаштування за раз. Офіційна сторінка містить історичні приклади ціни та частоти запитів; замість копіювання цих чисел у нове налаштування використовуйте документацію й ліміти облікового запису вашої актуальної кінцевої точки.
| Симптом | Що перевірити | Наступна перевірка |
|---|---|---|
| Помилка маршруту | Фактичний фінальний URL | Обробка базового або повного шляху |
| Помилка автентифікації | Емітент облікових даних і призначення | Приватні налаштування та область ключа |
| Модель відхилено | Точне поле моделі запиту | Каталог і право облікового запису |
| Ліміт частоти | Метадані відповіді та навантаження | Менша партія й обмежений повтор |
| Частковий переклад | Повернений контент і сегментація сторінки | Порівняння контрольованого уривка |
Відокремте результат браузера від доставки каталогу
Перекладена сторінка в браузері є поверхнею перевірки. Щоб опублікувати текст товару, створіть кандидата в пакеті перевірки каталогу, збережіть ідентифікатори й ревізії джерела, а потім передайте схвалені поля через фактичний API імпорту або перекладу магазину.
Перевірте доставку, прочитавши збережені поля та відкривши потрібну локаль вітрини. Не покладайтеся на розширення браузера редактора як доказ того, що побачить звичайний відвідувач. Окремо записуйте використання запитів перекладу й операцій магазину та враховуйте повтори під час оцінювання навантаження. Звертайтеся до актуальних тарифів, а не припускайте фіксовану вартість сторінки або символу.
Докази та межі інтеграції
Офіційна документація встановлює налаштування користувацької адреси. Запит встановленого розширення через APIsRouter для цієї статті не перевірявся, тому точна поведінка адреси, сумісність моделі та відображений результат залишаються перевірками налаштування. Схема є ілюстративним потоком конфігурації.
Завершений запис сумісності має містити версії розширення й браузера, очищені налаштування, призначення запиту, точну модель, контрольовану сторінку джерела та спостережуваний переклад. Перевірку захищених полів тримайте окремо від цієї транспортної перевірки. Успішний короткий уривок автоматично не перевіряє кожен формат документа або процес публікації магазину.
Поширені запитання
Де змінити API-адресу?
Офіційна документація сервісу OpenAI вказує на More Settings. Обираючи фінальний формат адреси, перевірте версію встановленого розширення та довідку його поля.
Чому скопійований URL /v1 іноді не працює?
Інструменти відрізняються тим, чи додають маршрут, чи очікують повний URL запиту. Перевірте фактичний вихідний шлях і уникайте відсутніх або дубльованих сегментів chat-completions.
Які облікові дані належать користувацькій конфігурації?
Використовуйте облікові дані, видані для налаштованої кінцевої точки, і вводьте їх приватно. Облікові дані іншого провайдера або токен адміністрування магазину не замінюють їх.
Чи оновлює перекладена сторінка товару мій магазин?
Переклад браузера не є сховищем каталогу. Використовуйте шлях перекладу або імпорту магазину та перевірте збережені поля для доставки схваленого тексту товару.
Як зберегти термінологію товару?
Ведіть перевірений глосарій у процесі контенту та порівнюйте результат браузера з ним. Окремо перевіряйте спеціальну функцію глосарія розширення, а не припускайте, що користувацька адреса застосовує терміни.