Setup custom API Immersive Translate

Buka pengaturan layanan OpenAI

Halaman layanan OpenAI resmi Immersive Translate mendokumentasikan alamat API kustom di More Settings. Mulai di sana saat mengevaluasi endpoint yang kompatibel dengan OpenAI. Catat versi ekstensi dan browser agar pemeriksaan setup berikutnya merujuk lingkungan yang dapat direproduksi.

Pilih satu konfigurasi untuk tes pertama dan tetap sediakan pengaturan default untuk pemulihan. Masukkan credential hanya di pengaturan ekstensi privat. Pastikan endpoint merupakan penerima yang dimaksud sebelum mengirim konten halaman, terutama ketika browser juga memiliki akses ke layar administrasi merchant.

Periksa apakah alamat berupa base atau rute lengkap

Jangan berasumsi setiap kolom alamat kustom berperilaku seperti baseURL SDK. Halaman resmi menyertakan URL chat-completions lengkap dalam contoh Azure. Periksa teks bantuan di ekstensi terpasang dan path request keluar yang telah disanitasi untuk menentukan cara alamat digunakan.

Untuk kandidat chat-completions APIsRouter, rute lengkapnya adalah https://api.apisrouter.com/v1/chat/completions. Jika versi terpasang secara eksplisit mengharapkan base URL dan menambahkan rute, gunakan https://api.apisrouter.com/v1. Hindari akhiran chat/completions ganda. Worksheet berikut menjelaskan pengaturan kandidat, bukan konfigurasi ekstensi yang telah diuji.

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

Buat jalur permintaan terjemahan tetap terlihat

Ekstensi mengirim permintaan terjemahan ke alamat layanan terpilih. Perlakukan alamat itu sebagai keputusan berbagi data, bukan hanya kolom konektivitas. Gunakan konten yang Anda miliki atau boleh diproses melalui endpoint yang dipilih, dan tinjau seberapa banyak halaman yang disertakan tindakan terjemahan.

Flow berikut mengilustrasikan jalur gateway yang diusulkan menggunakan mekanisme alamat kustom terdokumentasi. Label model terpilih adalah pilihan konfigurasi, bukan daftar model terverifikasi. Autentikasi toko, pengeditan produk, dan persetujuan impor berada di luar jalur request ini.

Verifikasi satu halaman terkendali terlebih dahulu

Gunakan halaman pendek dengan deskripsi produk sintetis, istilah merek terlindungi, kuantitas dengan satuan, dan tautan. Terjemahkan hanya halaman itu. Bandingkan hasil yang terlihat dengan sumber dan periksa tujuan jaringan yang disanitasi, model terpilih, serta status response.

Periksa apakah konten dihilangkan, diduplikasi, atau tercampur dengan bahasa sumber. Lalu coba paragraf yang lebih panjang dan layout dengan heading atau daftar. Simpan sumber dan output yang diamati agar perubahan konfigurasi berikutnya dapat dibandingkan dengan materi yang sama. Ini memberi baseline diagnostik yang berguna sebelum memproses dokumen besar.

Gunakan pembacaan dwibahasa untuk pertanyaan editorial

Terjemahan browser dapat membantu peninjau memeriksa materi sumber yang tidak dikenal atau menemukan frasa yang memerlukan perhatian. Biarkan sumber asli tetap terlihat dan bandingkan klaim, kuantitas, serta terminologi secara langsung. Jika peninjau tidak dapat menilai bahasa target, arahkan kandidat kepada orang yang dapat melakukannya, bukan menerima tampilan fasih sebagai bukti.

Simpan keputusan glosarium dalam alur katalog. Jangan berasumsi endpoint kustom juga menyediakan penegakan glosarium atau validasi tingkat kolom di dalam ekstensi. Deskripsi produk yang dimaksudkan untuk impor tetap memerlukan kandidat berpaut-sumber, hasil peninjauan, dan pemetaan tujuan sendiri.

Diagnosis error sebelum menerjemahkan lebih banyak konten

Mulai dari path request, credential, dan model ID persis. Catat error terstruktur bila tersedia dan samarkan header sebelum membagikan bukti. Jika request dibatasi, kurangi beban kerja dan hormati panduan retry layanan, jangan cepat-cepat mengulangi terjemahan satu halaman penuh.

Gunakan bagian yang lebih kecil untuk membedakan kegagalan koneksi dari masalah konten atau penanganan response. Ubah satu pengaturan pada satu waktu. Halaman resmi berisi contoh harga dan laju permintaan historis; gunakan dokumentasi endpoint serta batas akun terkini, bukan menyalin angka tersebut ke setup baru.

Pisahkan output browser dari delivery katalog

Tampilan browser yang diterjemahkan adalah permukaan inspeksi. Untuk menerbitkan teks produk, buat kandidat dalam paket peninjauan katalog, pertahankan pengenal dan revisi sumber, lalu teruskan kolom yang disetujui melalui jalur impor atau API terjemahan toko yang sebenarnya.

Verifikasi delivery dengan membaca kolom tersimpan dan membuka locale storefront yang dimaksud. Jangan mengandalkan ekstensi browser editor untuk membuktikan apa yang akan dilihat pengunjung biasa. Catat penggunaan request terjemahan terpisah dari operasi toko, dan perhitungkan retry saat mengevaluasi beban kerja. Gunakan harga saat ini, bukan mengasumsikan biaya tetap per halaman atau karakter.

Bukti dan batas integrasi

Dokumentasi resmi menetapkan pengaturan alamat kustom. Request ekstensi terpasang melalui APIsRouter belum diuji untuk artikel ini, sehingga perilaku alamat yang tepat, kompatibilitas model, dan hasil render masih menjadi pemeriksaan setup. Diagram adalah alur konfigurasi ilustratif.

Catatan kompatibilitas lengkap harus mencakup versi ekstensi dan browser, pengaturan tersanitasi, tujuan request, model persis, halaman sumber terkendali, dan terjemahan yang diamati. Pisahkan tinjauan kolom terlindungi dari pemeriksaan transport. Bagian pendek yang berhasil tidak otomatis memvalidasi setiap format dokumen atau workflow publikasi toko.

Pertanyaan umum