Çeviri kaynağı oluşturma

Bu makalede, Azure portalında Çeviri kaynağı oluşturmayı öğreneceksiniz. Azure AI Çeviri, Azure yapay zeka hizmetleri ailesinin bir parçası olan bulut tabanlı bir makine çevirisi hizmetidir. Azure kaynakları, oluşturduğunuz hizmetlerin örnekleridir. Azure AI hizmetlerine yönelik tüm API istekleri, erişimin kimliğini doğrulamak için bir uç nokta URL'si ve salt okunur anahtar gerektirir.

Önkoşullar

Başlamak için etkin bir Azure hesabınız olmalıdır. Aboneliğiniz yoksa 12 aylık ücretsiz bir abonelik oluşturabilirsiniz.

Kaynağınızı oluşturma

Azure hesabınızla Çeviri hizmetine iki farklı kaynak türü aracılığıyla erişebilirsiniz:

  1. Tek hizmetli kaynak türleri, tek bir hizmet API anahtarına ve uç noktasına erişimi etkinleştirir.

  2. Çok hizmetli kaynak türleri, tek bir API anahtarı ve uç nokta kullanarak birden çok Azure AI hizmetine erişim sağlar.

Projenizi ve örnek ayrıntılarınızı tamamlama

Çeviri hizmetine erişmek için hangi kaynak türünü kullanmak istediğinize karar verdikten sonra, projenizin ve örneğinizin ayrıntılarını girebilirsiniz.

  1. Abonelik. Kullanılabilir Azure aboneliklerinizden birini seçin.

  2. Kaynak Grubu. Yeni bir kaynak grubu oluşturabilir veya kaynağınızı aynı yaşam döngüsünü, izinleri ve ilkeleri paylaşan önceden var olan bir kaynak grubuna ekleyebilirsiniz.

  3. Kaynak Bölgesi. İşletmeniz veya uygulamanız belirli bir bölge gerektirmediği sürece Genel'i seçin. Belge Çevirisi özelliğini yönetilen kimlik yetkilendirmesiyle kullanmayı planlıyorsanız Doğu ABD gibi bir coğrafi bölge seçin.

  4. Adı. Kaynağınız için bir ad girin. Seçtiğiniz ad Azure içinde benzersiz olmalıdır.

    Not

    Belge Çevirisi gibi özel bir etki alanı uç noktası gerektiren bir Çeviri özelliği kullanıyorsanız, Ad alanına girdiğiniz değer uç nokta için özel etki alanı adı parametresi olacaktır.

  5. Fiyatlandırma katmanı. Gereksinimlerinizi karşılayan bir fiyatlandırma katmanı seçin:

    • Her aboneliğin ücretsiz katmanı vardır.
    • Ücretsiz katmanın özellikleri ve işlevleri ücretli planlar ile aynıdır ve süresi dolmaz.
    • Abonelik başına yalnızca bir ücretsiz katman kaynağı kullanılabilir.
    • Belge Çevirisi ücretli katmanlarda desteklenir. Language Studio yalnızca S1 veya D3 örnek katmanlarını destekler. Yalnızca Belge Çevirisi'ni denemek istiyorsanız Standart S1 örnek katmanını seçin.
  6. Çok hizmetli bir kaynak oluşturursanız, Temel bilgiler sekmesinin altındaki bağlantılar hizmetin uygun işlemiyle ilgili teknik belgeler sağlar.

  7. Gözden geçir + Oluştur’u seçin.

  8. Hizmet koşullarını gözden geçirin ve kaynağınızı dağıtmak için Oluştur'u seçin.

  9. Kaynağınız başarıyla dağıtıldıktan sonra Kaynağa git'i seçin.

    Kimlik doğrulama anahtarları ve uç nokta URL'si

    Tüm Azure AI hizmetleri API istekleri için bir uç nokta URL'si ve kimlik doğrulaması için salt okunur anahtar gerekir.

    • Kimlik doğrulama anahtarları. Anahtarınız, Çeviri hizmetine gönderilen her istekte geçirilen benzersiz bir dizedir. Anahtarınızı bir sorgu dizesi parametresi aracılığıyla veya HTTP isteği üst bilgisinde belirterek geçirebilirsiniz.

    • Uç nokta URL'si. Belirli bir Azure bölgesine veya özel uç noktaya ihtiyacınız yoksa API isteğinizde Genel uç noktayı kullanın. Daha fazla bilgi için bkz . Temel URL'ler. Genel uç nokta URL'si şeklindedir api.cognitive.microsofttranslator.com.

Kimlik doğrulama anahtarlarınızı ve uç noktanızı alma

Çeviri kaynağınızla bağlantınızın kimliğini doğrulamak için anahtarlarını ve uç noktasını bulmanız gerekir.

  1. Yeni kaynağınız dağıtıldıktan sonra Kaynağa git'i seçin veya kaynak sayfanıza gidin.

  2. Sol gezinti bölmesinde, Kaynak Yönetimi'nin altında Anahtarlar ve Uç Nokta'yı seçin.

  3. Anahtarlarınızı ve uç nokta URL'nizi kopyalayıp Not Defteri gibi uygun bir konuma yapıştırın.

    Çeviri kaynağının Anahtarlar ve Uç Nokta sayfasını gösteren Azure portalının ekran görüntüsü. Anahtarlar ve uç noktalar vurgulanır.

Metin Çevirisi istemcisi oluşturma

Metin Çevirisi hem genel hem de bölgesel uç noktaları destekler. Kimlik doğrulama anahtarlarınızı aldıktan sonra, Metin Çevirisi hizmetiyle etkileşim kurmak için kimlik doğrulaması için kullanarak AzureKeyCredential örneğini TextTranslationClientoluşturmanız gerekir:

  1. Genel kaynak uç noktası kullanarak bir TextTranslationClient oluşturmak için kaynak API anahtarınız gerekir:

      AzureKeyCredential credential = new('<apiKey>');
      TextTranslationClient client = new(credential);
    
  2. Bölgesel bir kaynak uç noktası kullanarak bir TextTranslationClient oluşturmak için kaynak API anahtarınıza ve kaynağınızın bulunduğu bölgenin adına ihtiyacınız vardır:

    AzureKeyCredential credential = new('<apiKey>');
    TextTranslationClient client = new(credential, '<region>');
    

Kaynak veya kaynak grubunu silme

Uyarı

Bir kaynak grubunun silinmesi, gruptaki tüm kaynakları da siler.

Kaynağı silmek için:

  1. Azure portalında Kaynak grupları'nı arayıp seçin ve kaynak grubunuzu seçin.

  2. Bitişik onay kutusunu seçerek silinecek kaynakları seçin.

  3. Sağ kenardaki üst menüden Sil'i seçin.

  4. Kaynakları Sil iletişim kutusuna delete yazın.

  5. Sil'i seçin.

Kaynak grubunu silmek için:

  1. Azure portalında Kaynak Grubunuz'a gidin.

  2. Üst menü çubuğundan Kaynak grubunu sil'i seçin.

  3. Kaynak grubu adını girip Sil'i seçerek silme isteğini onaylayın.

Sonraki adım