Özel çevirileri tanımlama

  • 5 dakika

Azure AI Çeviri tarafından kullanılan varsayılan çeviri modeli genel çeviri için etkili olsa da, özel çeviri gerektiren belirli terim sözlüklerine sahip işletmeler veya sektörler için bir çeviri çözümü geliştirmeniz gerekebilir.

Bu sorunu çözmek için kendi kaynak ve hedef terim kümelerinizi çeviri için eşleyen özel bir model oluşturabilirsiniz. Özel model oluşturmak için Özel Çeviri portalını kullanarak şunları yapın:

  1. Azure AI Çeviri kaynağınıza bağlı bir çalışma alanı oluşturun.
  2. Proje oluşturma.
  3. Eğitim veri dosyalarını karşıya yükleyin ve modeli eğitin.
  4. Modelinizi test edin ve modelinizi yayımlayın.
  5. API'ye çeviri çağrıları yapın.

Screenshot showing the Custom Translator portal.

Özel modelinize benzersiz bir kategori kimliği atanır (ekran görüntüsünde vurgulanır), kategori parametresini kullanarak Azure AI Çeviri kaynağınıza yapılan çeviri çağrılarında belirtebilirsiniz ve bu da çevirinin varsayılan model yerine özel modeliniz tarafından gerçekleştirilmesine neden olur.

API çağırma

Çeviri başlatmak için aşağıdaki istek URL'sine bir POST isteği gönderirsiniz:

https://api.cognitive.microsofttranslator.com/translate?api-version=3.0

İsteğinizin birkaç parametre içermesi gerekir:

  • api-version: API'nin gerekli sürümü.
  • to: Çevrilecek hedef dil. Örneğin: to=fr Fransızca için.
  • category: Kategori kimliğiniz.

İsteğiniz ayrıca bir dizi gerekli üst bilgi içermelidir:

  • Ocp-Apim-Subscription-Key. İstemci anahtarınız için üst bilgi. Örneğin: Ocp-Apim-Subscription-Key=<your-client-key>.
  • Content-Type. Yükün içerik türü. Gerekli biçim: Content-Type: application/json; charset=UTF-8.

İstek gövdesi, çevirmek istediğiniz metni belirten bir özelliğe sahip JSON nesnesi içeren bir Text dizi içermelidir:

[
    {"Text":"Where can I find my employee details?"}
]

İsteğinizi API'ye göndermenin C#, Python ve curl gibi farklı yolları vardır. Örneğin, hızlı bir arama yapmak için curl kullanarak post isteği gönderebilirsiniz:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=nl&category=<category-id>" -H "Ocp-Apim-Subscription-Key: <your-key" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Where can I find my employee details?'}]"

Yukarıdaki istek, bir cümleyi İngilizceden Felemenkçe'ye çevirmek için bir çağrı yapar.

Yanıt döndürüldü

Yanıt, isteğin 200 başarılı olup olmadığının yanıt kodunu döndürür. Ayrıca çevrilmiş metni içeren bir yanıt gövdesi döndürür, örneğin:

[
    {
        "translations":[
            {"text":"Waar vind ik mijn personeelsgegevens?","to":"nl"}
        ]
    }
]

İstek başarılı olmadıysa, hata türüne 400 bağlı olarak (eksik veya geçersiz sorgu parametreleri) bir dizi farklı durum kodu döndürülebilir. Kodların tam listesi ve açıklamaları için yanıt durum kodları bölümüne bakın.

Dekont

Özel çeviri hakkında daha fazla bilgi için bkz . Hızlı Başlangıç: Özel modellerle derleme, yayımlama ve çevirme.