Immersive Translate özel API kurulumu
Updated 2026-09-05
Bir çeviri uç noktasını değerlendirmek için belgelenmiş özel adres ayarını kullanın. Kontrollü bir sayfayla başlayın, ardından editoryal incelemeyi desteklemek için iki dilli okuma yapın.
OpenAI hizmet ayarlarını açın
Immersive Translate'in resmî OpenAI hizmet sayfası More Settings altında özel API adresini belgeler. OpenAI uyumlu bir uç noktayı değerlendirirken oradan başlayın. Sonraki kurulum kontrolünün yeniden üretilebilir bir ortama başvurması için eklenti sürümünü ve tarayıcıyı kaydedin.
İlk test için tek bir yapılandırma seçin ve kurtarma için varsayılan ayarları erişilebilir tutun. Kimlik bilgisini yalnızca özel eklenti ayarına girin. Özellikle tarayıcının satıcı yönetim ekranlarına da eriştiği durumda sayfa içeriğini göndermeden önce uç noktanın hedeflenen alıcı olduğunu doğrulayın.
Adresin temel mi yoksa tam rota mı olduğunu kontrol edin
Her özel adres alanının SDK baseURL gibi davrandığını varsaymayın. Resmî sayfa Azure örneğinde tam bir chat-completions URL'si içerir. Adresin nasıl kullanıldığını belirlemek için kurulu eklentinizdeki yardım metnini ve temizlenmiş dışarı giden istek yolunu inceleyin.
APIsRouter sohbet tamamlama adayı için tam rota https://api.apisrouter.com/v1/chat/completions adresidir. Kurulu sürüm açıkça temel URL bekliyor ve rotayı ekliyorsa bunun yerine https://api.apisrouter.com/v1 adresini kullanın. Yinelenen chat/completions son ekinden kaçının. Aşağıdaki çalışma sayfası test edilmiş eklenti yapılandırmasını değil aday ayarları açıklar.
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Çeviri istek yolunu görünür tutun
Eklenti çeviri isteklerini seçilen hizmet adresine gönderir. Bu adresi yalnızca bağlantı alanı değil, veri paylaşımı kararı sayın. Sahip olduğunuz veya seçilen uç nokta üzerinden işleyebileceğiniz içeriği kullanın ve seçilen çeviri eyleminin sayfanın ne kadarını dahil ettiğini inceleyin.
Aşağıdaki akış, belgelenmiş özel adres mekanizmasıyla önerilen ağ geçidi yolunu gösterir. Seçilen model etiketi doğrulanmış model listesi değil, yapılandırma seçimidir. Mağaza kimlik doğrulaması, ürün düzenleme ve içe aktarma onayları bu istek yolunun dışındadır.
Önce tek bir kontrollü sayfayı doğrulayın
Sentetik ürün açıklaması, korunan marka terimi, birimli miktar ve bağlantı içeren kısa bir sayfa kullanın. Yalnızca o sayfayı çevirin. Görünür sonucu kaynakla karşılaştırın ve temizlenmiş ağ hedefini, seçilen modeli ve yanıt durumunu inceleyin.
İçeriğin atlandığını, yinelendiğini veya kaynak diliyle karıştığını kontrol edin. Ardından daha uzun bir paragrafı ve başlık veya listeli bir düzeni deneyin. Sonraki yapılandırma değişikliğini aynı materyalle karşılaştırabilmek için kaynağı ve gözlenen çıktıyı saklayın. Bu, büyük bir belgeyi işlemeden önce yararlı bir tanı tabanı verir.
Editoryal sorular için iki dilli okuma kullanın
Tarayıcı çevirisi, inceleyenin tanımadığı kaynak materyali incelemesine veya dikkat gerektiren bir ifadeyi belirlemesine yardım edebilir. Özgün metni görünür tutun ve iddiaları, miktarları ve terminolojiyi doğrudan karşılaştırın. İnceleyen hedef dili değerlendiremiyorsa akıcı görünüşü kanıt saymak yerine adayı değerlendirebilecek birine yönlendirin.
Sözlük kararlarını katalog iş akışında tutun. Özel uç noktanın eklenti içinde sözlük uygulaması veya alan düzeyinde doğrulama sağladığını varsaymayın. İçe aktarılması amaçlanan ürün açıklamalarının kendi kaynak bağlantılı adayı, inceleme sonucu ve hedef eşlemesi gerekir.
Daha fazla içerik çevirmeden önce hataları teşhis edin
İstek yolu, kimlik bilgisi ve kesin model ID'siyle başlayın. Varsa yapılandırılmış hataları kaydedin ve kanıtı paylaşmadan önce başlıkları redakte edin. İstekler sınırlıysa tam sayfa çevirisini hızlıca tekrarlamak yerine iş yükünü azaltın ve hizmetin yeniden deneme kılavuzuna uyun.
Bağlantı başarısızlığını içerik veya yanıt işleme sorunundan ayırmak için daha küçük bir pasaj kullanın. Her seferinde tek ayar değiştirin. Resmî sayfa tarihsel fiyat ve istek hızı örnekleri içerir; yeni kuruluma bu sayıları kopyalamak yerine mevcut uç noktanızın dokümantasyonunu ve hesap sınırlarını kullanın.
| Belirti | İncele | Sonraki kontrol |
|---|---|---|
| Rota hatası | Gerçek son URL | Temel ve tam yol işlemesi |
| Kimlik doğrulama hatası | Kimlik bilgisi sağlayıcısı ve hedef | Özel ayarlar ve anahtar kapsamı |
| Model reddedildi | Kesin istek model alanı | Katalog ve hesap uygunluğu |
| Hız sınırı | Yanıt üst verisi ve iş yükü | Daha küçük grup ve sınırlı yeniden deneme |
| Kısmi çeviri | Dönen içerik ve sayfa bölümlendirmesi | Kontrollü pasaj karşılaştırması |
Tarayıcı çıktısını katalog tesliminden ayırın
Çevrilmiş tarayıcı görünümü bir inceleme yüzeyidir. Ürün metni yayımlamak için katalog inceleme paketinde aday oluşturun, tanımlayıcıları ve kaynak revizyonlarını koruyun, ardından onaylı alanları mağazanın gerçek içe aktarma veya çeviri API'sinden geçirin.
Teslimi saklanan alanları okuyarak ve amaçlanan mağaza locale'ini açarak doğrulayın. Sıradan ziyaretçinin ne göreceğini kanıtlamak için editörün tarayıcı eklentisine güvenmeyin. Çeviri isteği kullanımını mağaza işlemlerinden ayrı kaydedin ve iş yükünü değerlendirirken yeniden denemeleri hesaba katın. Sayfa veya karakter başına sabit maliyet varsaymak yerine güncel fiyatlandırmaya başvurun.
Kanıt ve entegrasyon sınırları
Resmî dokümantasyon özel adres ayarını oluşturur. Bu makale için APIsRouter üzerinden kurulu eklenti isteği test edilmedi; kesin adres davranışı, model uyumluluğu ve oluşturulan sonuç hâlâ kurulum kontrolleridir. Diyagram örnek bir yapılandırma akışıdır.
Tamamlanmış uyumluluk kaydı eklenti ve tarayıcı sürümlerini, temizlenmiş ayarları, istek hedefini, kesin modeli, kontrollü kaynak sayfasını ve gözlenen çeviriyi içermelidir. Korunan alan incelemesini taşıma kontrolünden ayrı tutun. Kısa bir pasajın başarılı olması her belge biçimini veya mağaza yayım iş akışını otomatik doğrulamaz.
Sık sorulan sorular
API adresini nereden değiştiririm?
Resmî OpenAI hizmet dokümantasyonu More Settings'i gösterir. Son adres biçimini seçerken kurulu eklenti sürümünü ve alan yardımını kontrol edin.
Kopyalanan /v1 URL'si bazen neden başarısız olur?
Araçlar rota ekleyip eklemedikleri veya eksiksiz istek URL'si bekleyip beklemedikleri konusunda farklıdır. Gerçek dışarı giden yolu inceleyin ve eksik ya da yinelenen chat-completions bölümlerinden kaçının.
Özel yapılandırmaya hangi kimlik bilgisi ait?
Yapılandırılmış uç nokta için verilen kimlik bilgisini özel olarak girin. Başka sağlayıcının kimlik bilgisi veya mağaza yönetim tokenı onun yerine geçmez.
Çevrilmiş ürün sayfası mağazamı günceller mi?
Tarayıcı çevirisi katalog depolaması değildir. Onaylı ürün metnini teslim etmek için mağazanın çeviri veya içe aktarma yolunu kullanın ve saklanan alanları doğrulayın.
Ürün terminolojisini nasıl korurum?
İçerik iş akışınızda incelenmiş sözlük tutun ve tarayıcı sonucunu onunla karşılaştırın. Özel adresin terimleri uyguladığını varsaymak yerine eklentiye özgü sözlük özelliğini ayrıca doğrulayın.