Aracılığıyla paylaş

Döküm Araçları v3.0'da Azure Translator

Yenilikler neler?

Translator'ın 3.0 sürümü modern bir JSON tabanlı Web API'sini sağlar. Mevcut özellikleri daha az işlemle birleştirerek kullanılabilirliği ve performansı artırır ve yeni özellikler sağlar.

  • Bir dildeki metni bir betikten başka bir betike dönüştürmek için çeviri.
  • Tek bir istekte birden çok dile çeviri.
  • Tek bir istekte dil algılama, çeviri ve çeviri.
  • Terimlerin alternatif çevirilerini aramak, arka çevirileri ve bağlam içinde kullanılan terimleri gösteren örnekleri bulmak için sözlük.
  • Daha bilgilendirici dil algılama sonuçları.

Temel URL'ler

Translator'a yönelik istekler çoğu durumda, isteğin kaynaklandığı yere en yakın veri merkezi tarafından işlenir. Genel uç nokta kullanılırken bir veri merkezi hatası varsa, istek coğrafyanın dışına yönlendirilebilir.

İsteğin belirli bir coğrafyada işlenmesini zorlamak için istenen coğrafi uç noktayı kullanın. Tüm istekler coğrafyadaki veri merkezleri arasında işlenir.

✔️ Özellik: Translator Metin Çevirisi

Hizmet uç noktası İstek işleme veri merkezi
Genel (önerilen):
api.cognitive.microsofttranslator.com		 En yakın kullanılabilir veri merkezi.
Amerika:
api-nam.cognitive.microsofttranslator.com		 Doğu ABD 2 • Batı ABD 2
Asya Pasifik
api-apc.cognitive.microsofttranslator.com:		 Doğu Japonya • Güneydoğu Asya
Avrupa (İsviçre hariç):
api-eur.cognitive.microsofttranslator.com		 Orta Fransa • Batı Avrupa
İsviçre:
Daha fazla bilgi için bkz. İsviçre hizmet uç noktaları.		 kuzey İsviçre • İsviçre Batı

İsviçre hizmet uç noktaları

Kuzey İsviçre veya Batı İsviçre'de bulunan bir kaynağı olan müşteriler, Metin API'leri isteklerinin İsviçre içinde sunulduğundan emin olabilir. İsteklerin İsviçre'de işlenmesini sağlamak için veya Resource regioniçinde Switzerland NorthSwitzerland West Translator kaynağını oluşturun ve ardından API isteklerinizde kaynağın özel uç noktasını kullanın.

Örneğin: Azure portalında Resource region ile Switzerland North bir Translator kaynağı oluşturursanız ve kaynak adınız ise my-swiss-n, özel uç noktanız olur https​://my-swiss-n.cognitiveservices.azure.com. Çeviri için örnek bir istek de şu şekildedir:

// Pass secret key and region using headers to a custom endpoint
curl -X POST "https://my-swiss-n.cognitiveservices.azure.com/translator/text/v3.0/translate?to=fr" \
-H "Ocp-Apim-Subscription-Key: xxx" \
-H "Ocp-Apim-Subscription-Region: switzerlandnorth" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello'}]" -v

Özel Çevirmen şu anda İsviçre'de kullanılamıyor.

Sanal Ağ desteği

Translator artık Azure genel bulutunun tüm bölgelerinde Sanal Ağ (VNET) özellikleriyle kullanılabilir. Sanal Ağı etkinleştirmek için bkz. Foundry Araçları sanal ağlarını yapılandırma.

Bu özelliği açtığınızda Translator'ı çağırmak için özel uç noktayı kullanmanız gerekir. Genel çeviri uç noktasını ("api.cognitive.microsofttranslator.com") kullanamazsınız ve erişim belirteci ile kimlik doğrulaması yapamazsınız.

Bir çevirmen kaynağı oluşturduktan ve seçili ağlardan ve özel uç noktalardan erişime izin verdikten sonra özel uç noktayı bulabilirsiniz.

  1. Azure portalında Translator kaynağınıza gidin.

  2. Kaynak Yönetimi bölümünden Ağ'ı seçin.

  3. Güvenlik duvarları ve sanal ağlar sekmesinde Seçili Ağlar ve Özel Uç Noktalar'ı seçin.

    Azure portalındaki sanal ağ ayarının ekran görüntüsü.

  4. Yaptığınız değişiklikleri uygulamak için Kaydet'i seçin.

  5. Kaynak Yönetimi bölümünde Anahtarlar ve Uç Nokta'ya tıklayın.

  6. Sanal Ağ sekmesini seçin.

  7. Metin çevirisi ve Belge çevirisi için uç noktalar listelenir.

    Sanal ağ uç noktasının ekran görüntüsü.

Başlıklar Açıklama
Ocp-Apim-Subscription-Key Değer, Translator aboneliğinizin Azure gizli anahtarıdır.
Ocp-Apim-Subscription-Region Değer, çevirmen kaynağının bölgesidir. Kaynak şu durumdaysa bu değer isteğe bağlıdır: global

Özel uç noktayı kullanarak Translator'ı çağırmak için örnek bir istek aşağıda verilmiş.

// Pass secret key and region using headers
curl -X POST "https://<your-custom-domain>.cognitiveservices.azure.com/translator/text/v3.0/translate?api-version=3.0&to=es" \
     -H "Ocp-Apim-Subscription-Key:<your-key>" \
     -H "Ocp-Apim-Subscription-Region:<your-region>" \
     -H "Content-Type: application/json" \
     -d "[{'Text':'Hello, what is your name?'}]"

Ölçümler

Ölçümler, Azure portalında çevirmen kullanımı ve kullanılabilirlik bilgilerini görüntülemenizi sağlar. Daha fazla bilgi için bkz. Veri ve platform ölçümleri.

Translator Ölçümleri

Bu tabloda, çeviri API'si çağrılarını izlemek için nasıl kullanıldıklarına yönelik açıklama içeren kullanılabilir ölçümler listelenmektedir.

Ölçümler Açıklama
TotalCalls Toplam API çağrısı sayısı.
TotalTokenCalls Kimlik doğrulama belirtecini kullanan belirteç hizmeti aracılığıyla yapılan toplam API çağrısı sayısı.
SuccessfulCalls Başarılı çağrı sayısı.
TotalErrors Hata yanıtı içeren çağrı sayısı.
BlockedCalls Hız veya kota sınırını aşan çağrı sayısı.
ServerErrors Sunucu iç hatası (5XX) ile çağrı sayısı.
ClientErrors İstemci tarafı hatası (4XX) ile çağrı sayısı.
Gecikme İsteğin tamamlanması için milisaniye cinsinden süre.
Çevrilen Karakterler Gelen metin isteğindeki toplam karakter sayısı.
  • Last updated on