Hızlı Başlangıç: Azure OpenAI transkripsiyon modelleriyle metne konuşma

Bu hızlı başlangıçta , OpenAI transkripsiyon modelini kullanarak konuşmayı metne dönüştürebilirsiniz. Transkripsiyon modeli birçok dilde insan konuşmasının dökümünü alabilir ve diğer dilleri İngilizceye çevirebilir.

Çevrimdışı transkripsiyon için kullanın gpt-transcribe. Bu model Ses API'sinin transkripsiyon yolunu kullanır ve bir Gerçek Zamanlı API modeli değildir.

Bu hızlı başlangıçta, canlı akış oturumu değil, bir dosya yükleme istek-yanıt akışı (ses dosyası başına bir istek) kullanılır.

Çevrimdışı transkripsiyon için kullanın gpt-transcribe. Bu model Ses API'sinin transkripsiyon yolunu kullanır ve bir Gerçek Zamanlı API modeli değildir.

Bu hızlı başlangıçta, canlı akış oturumu değil, bir dosya yükleme istek-yanıt akışı (ses dosyası başına bir istek) kullanılır.

Ipucu

Bu hızlı başlangıcın tamamlanması yaklaşık 10-15 dakika sürer.

Önkoşullar

  • Azure aboneliği - ücretsiz bir abonelik oluşturma.
  • supported bölgesinde dağıtılmış konuşma metin modeline sahip bir Azure OpenAI kaynağı. Daha fazla bilgi için bkz. Kaynak oluşturma ve Azure OpenAI ile model dağıtma.
  • Azure OpenAI kaynağı için en azından Cognitive Services Contributor rolüne atandığınızdan emin olun.
  • Örnek bir ses dosyası. <c0>wikipediaOcelot.wav</c0> gibi örnek sesleri GitHub'daki Foundry Tools SDK'sinde Azure Speech deposundan</c1> alabilirsiniz.

Kurulum

Anahtarı ve uç noktayı alma

Azure OpenAI'ye karşı başarılı bir şekilde çağrı yapmak için endpoint ve key gerekir.

Değişken adı Değer
AZURE_OPENAI_ENDPOINT Azure portalından kaynağınızı incelerken hizmet uç noktasını Anahtarlar ve Uç Nokta bölümünde bulabilirsiniz. Alternatif olarak, uç noktayı Microsoft Döküm portalındaki Deployments sayfasında bulabilirsiniz. Örnek uç nokta: https://docs-test-001.openai.azure.com/.
AZURE_OPENAI_API_KEY Bu değer, Azure portalında kaynağınızı incelerken Keys & Endpoint bölümü içerisinde bulunabilir. veya KEY1kullanabilirsinizKEY2.

Azure portalında kaynağınıza gidin. Uç Nokta ve AnahtarlarKaynak Yönetimi bölümünde bulunabilir. Api çağrılarınızın kimliğini doğrulamak için hem uç noktanızı hem de erişim anahtarınızı kopyalayın. veya KEY1kullanabilirsinizKEY2. Her zaman iki anahtara sahip olmak, hizmet kesintisine neden olmadan anahtarları güvenli bir şekilde döndürmenize ve yeniden oluşturmanıza olanak tanır.

Azure portalındaki Azure OpenAI kaynağına ait genel bakış kullanıcı arabiriminin ekran görüntüsü, uç nokta ve erişim anahtarlarının konumunun kırmızıyla daire içine alınmış haliyle.

Ortam değişkenleri

Anahtarınız ve uç noktanız için kalıcı ortam değişkenleri oluşturun ve atayın.

Önemli

API anahtarlarını dikkatli kullanın. API anahtarını doğrudan kodunuzla eklemeyin ve hiçbir zaman herkese açık olarak göndermeyin. API anahtarı kullanıyorsanız, Azure Key Vault güvenli bir şekilde depolayın. Uygulamalarınızda API anahtarlarını güvenli bir şekilde kullanma hakkında daha fazla bilgi için bkz. Azure Key Vault ile API anahtarları.

Yapay zeka hizmetleri güvenliği hakkında daha fazla bilgi için bkz. Azure Yapay Zeka Hizmetleri istekleri doğrulama.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 

setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE"

REST API isteği ve yanıtı oluşturma

Bash kabuğunda aşağıdaki komutu çalıştırın. YourDeploymentName öğesini, transkripsiyon modelini dağıtırken seçtiğiniz dağıtım adıyla değiştirin. Dağıtım adı, model adıyla aynı olmayabilir. Temel alınan model adıyla aynı olan bir dağıtım adı seçmediğiniz sürece model adının girilmesi hatayla sonuçlanır.

curl $AZURE_OPENAI_ENDPOINT/openai/deployments/YourDeploymentName/audio/transcriptions?api-version=2024-02-01 \
 -H "api-key: $AZURE_OPENAI_API_KEY" \
 -H "Content-Type: multipart/form-data" \
 -F file="@./wikipediaOcelot.wav"

Yukarıdaki komutun örnek uç noktası olan ilk satırı aşağıdaki gibi görünür:

curl https://aoai-docs.openai.azure.com/openai/deployments/{YourDeploymentName}/audio/transcriptions?api-version=2024-02-01 \

Önemli

Üretim için Azure Key Vault gibi güvenli bir yöntem kullanarak kimlik bilgilerinizi depolayın ve erişin. Daha fazla bilgi için bkz. kimlik bilgisi güvenliği.

Çıkışı doğrula

Yanıt, ses dosyanızın tam dökümünü içeren bir text alan içerir. Aşağıdaki örneğe benzer bir çıktı görmeniz gerekir. Hatalarla karşılaşırsanız:

  • Dağıtım adınızın tam olarak eşleştiğinden emin olun
  • Ses dosyası yolunuzun doğru olup olmadığını denetleyin
  • API anahtarınızın ve uç noktanızın geçerli olduğundan emin olun

Çıkış

{"text":"The ocelot, Lepardus paradalis, is a small wild cat native to the southwestern United States, Mexico, and Central and South America. This medium-sized cat is characterized by solid black spots and streaks on its coat, round ears, and white neck and undersides. It weighs between 8 and 15.5 kilograms, 18 and 34 pounds, and reaches 40 to 50 centimeters 16 to 20 inches at the shoulders. It was first described by Carl Linnaeus in 1758. Two subspecies are recognized, L. p. paradalis and L. p. mitis. Typically active during twilight and at night, the ocelot tends to be solitary and territorial. It is efficient at climbing, leaping, and swimming. It preys on small terrestrial mammals such as armadillo, opossum, and lagomorphs."}

Önkoşullar

Kurulum

Anahtarı ve uç noktayı alma

Azure OpenAI'ye karşı başarılı bir şekilde çağrı yapmak için endpoint ve key gerekir.

Değişken adı Değer
AZURE_OPENAI_ENDPOINT Azure portalından kaynağınızı incelerken hizmet uç noktasını Anahtarlar ve Uç Nokta bölümünde bulabilirsiniz. Alternatif olarak, uç noktayı Microsoft Döküm portalındaki Deployments sayfasında bulabilirsiniz. Örnek uç nokta: https://docs-test-001.openai.azure.com/.
AZURE_OPENAI_API_KEY Bu değer, Azure portalında kaynağınızı incelerken Keys & Endpoint bölümü içerisinde bulunabilir. veya KEY1kullanabilirsinizKEY2.

Azure portalında kaynağınıza gidin. Uç Nokta ve AnahtarlarKaynak Yönetimi bölümünde bulunabilir. Api çağrılarınızın kimliğini doğrulamak için ihtiyacınız olacak şekilde uç noktanızı ve erişim anahtarınızı kopyalayın. veya KEY1kullanabilirsinizKEY2. Her zaman iki anahtara sahip olmak, hizmet kesintisine neden olmadan anahtarları güvenli bir şekilde döndürmenize ve yeniden oluşturmanıza olanak tanır.

Azure portalındaki Azure OpenAI kaynağına ait genel bakış kullanıcı arabiriminin ekran görüntüsü, uç nokta ve erişim anahtarlarının konumunun kırmızıyla daire içine alınmış haliyle.

Ortam değişkenleri

Anahtarınız ve uç noktanız için kalıcı ortam değişkenleri oluşturun ve atayın.

Önemli

API anahtarlarını dikkatli kullanın. API anahtarını doğrudan kodunuzla eklemeyin ve hiçbir zaman herkese açık olarak göndermeyin. API anahtarı kullanıyorsanız, Azure Key Vault güvenli bir şekilde depolayın. Uygulamalarınızda API anahtarlarını güvenli bir şekilde kullanma hakkında daha fazla bilgi için bkz. Azure Key Vault ile API anahtarları.

Yapay zeka hizmetleri güvenliği hakkında daha fazla bilgi için bkz. Azure Yapay Zeka Hizmetleri istekleri doğrulama.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 

setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE"

Önemli

Parolasız kimlik doğrulaması önerilir

Parolasız kimlik doğrulaması için şunları yapmanız gerekir:

  1. azure-identity() paketinipip install azure-identity kullanın.
  2. Rolü kullanıcı hesabınıza atayın Cognitive Services User . Bu, Azure portalında Access denetimi (IAM)>Add role assignment altında yapılabilir.
  3. Azure CLI kullanarak oturum açın, az login gibi.

Python ortamı oluşturma

Projeniz için yeni bir dizin oluşturun ve bir terminal veya komut isteminden bu dizine gidin.

mkdir whisper-quickstart; cd whisper-quickstart

Bu proje için bir sanal ortam oluşturun ve etkinleştirin.

python -m venv .venv
.venv\Scripts\activate

OpenAI Python istemci kitaplığını şu şekilde yükleyin:

pip install openai

Python uygulamasını oluşturma

  1. quickstart.py adlı yeni bir Python dosyası oluşturun. Ardından tercih ettiğiniz düzenleyicide veya IDE'de açın.

  2. quickstart.py içeriğini aşağıdaki kodla değiştirin. Dağıtım adınızı eklemek için kodu değiştirin:

    import os
    from openai import AzureOpenAI
        
    client = AzureOpenAI(
        api_key=os.getenv("AZURE_OPENAI_API_KEY"),  
        api_version="2024-02-01",
        azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
    )
    
    deployment_id = "YOUR-DEPLOYMENT-NAME-HERE" #This will correspond to the custom name you chose for your deployment when you deployed a model."
    audio_test_file = "./wikipediaOcelot.wav"
    
    result = client.audio.transcriptions.create(
        file=open(audio_test_file, "rb"),            
        model=deployment_id
    )
    
    print(result)

Hızlı başlangıç dosyanızda komutunu kullanarak python uygulamayı çalıştırın:

python quickstart.py

Önemli

Üretim için Azure Key Vault gibi güvenli bir yöntem kullanarak kimlik bilgilerinizi depolayın ve erişin. Daha fazla bilgi için bkz. kimlik bilgisi güvenliği.

Çıkışı doğrula

Yanıt, ses dosyanızın tam dökümünü içeren bir text alan içerir. Aşağıdaki örneğe benzer bir çıktı görmeniz gerekir. Hatalarla karşılaşırsanız:

  • Dağıtım adınızın tam olarak eşleştiğinden emin olun
  • Ses dosyası yolunuzun doğru olup olmadığını denetleyin
  • API anahtarınızın ve uç noktanızın geçerli olduğundan emin olun

Çıkış

{"text":"The ocelot, Lepardus paradalis, is a small wild cat native to the southwestern United States, Mexico, and Central and South America. This medium-sized cat is characterized by solid black spots and streaks on its coat, round ears, and white neck and undersides. It weighs between 8 and 15.5 kilograms, 18 and 34 pounds, and reaches 40 to 50 centimeters 16 to 20 inches at the shoulders. It was first described by Carl Linnaeus in 1758. Two subspecies are recognized, L. p. paradalis and L. p. mitis. Typically active during twilight and at night, the ocelot tends to be solitary and territorial. It is efficient at climbing, leaping, and swimming. It preys on small terrestrial mammals such as armadillo, opossum, and lagomorphs."}

Önkoşullar

Microsoft Entra ID önkoşulları

Microsoft Entra ID ile önerilen anahtarsız kimlik doğrulaması için şunları yapmanız gerekir:

  • Microsoft Entra ID ile anahtarsız kimlik doğrulaması için kullanılan Azure CLI yükleyin.
  • Rolü kullanıcı hesabınıza atayın Cognitive Services User . rolleri Azure portalında Access denetimi (IAM)>Add role assignment altında atayabilirsiniz.

Kurulum

  1. Yeni bir klasör whisper-quickstart oluşturun ve aşağıdaki komutu kullanarak hızlı başlangıç klasörüne gidin:

    mkdir whisper-quickstart && cd whisper-quickstart

  2. Aşağıdaki komutla yeni bir konsol uygulaması oluşturun:

    dotnet new console

  3. OpenAI .NET istemci kitaplığınıdotnet add package komutuyla yükleyin:

    dotnet add package Azure.AI.OpenAI

  4. Önerilen anahtarsız doğrulama için Microsoft Entra ID ile Azure.Identity paketini yükleyin.

    dotnet add package Azure.Identity

  5. Microsoft Entra ID ile önerilen anahtarsız kimlik doğrulaması için aşağıdaki komutla Azure'a oturum açın.

    az login

Kaynak bilgilerini alma

Uygulamanızın kimliğini Azure OpenAI kaynağınızla doğrulamak için aşağıdaki bilgileri almanız gerekir:

Değişken adı Değer
AZURE_OPENAI_ENDPOINT Bu değer, Azure portalından kaynağınızı incelerken Keys ve Endpoint bölümünde bulunabilir.
AZURE_OPENAI_DEPLOYMENT_NAME Bu değer, bir modeli dağıtırken dağıtımınız için seçtiğiniz özel ada karşılık gelir. Bu değer Azure portalında Kaynak Yönetimi>Model Dağıtımları altında bulunabilir.

Anahtarsız kimlik doğrulaması ve ortam değişkenlerini ayarlama hakkında daha fazla bilgi edinin.

Hızlı başlangıcı çalıştırma

Bu hızlı başlangıçtaki örnek kod, önerilen anahtarsız kimlik doğrulaması için Microsoft Entra ID kullanır. API anahtarı kullanmayı tercih ederseniz, nesnesini bir DefaultAzureCredential nesneyle değiştirebilirsinizAzureKeyCredential.

AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());

Not

wikipediaOcelot.wav gibi örnek ses dosyalarını GitHub konumundaki Azure Döküm Araçları SDK'sı deposundan alabilirsiniz.

Hızlı başlangıcı çalıştırmak için şu adımları izleyin:

  1. öğesinin içeriğini Program.cs aşağıdaki kodla değiştirin ve yer tutucu değerlerini kendi kodunuzla güncelleştirin.

    using Azure;
using Azure.AI.OpenAI;
using Azure.Identity; // Required for Passwordless auth


string deploymentName = "whisper";

string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT") ?? "https://<your-resource-name>.openai.azure.com/";
string key = Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY") ?? "<your-key>";

// Use the recommended keyless credential instead of the AzureKeyCredential credential.
AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential()); 
//AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(key));

var audioFilePath = "<audio file path>"

var audioClient = openAIClient.GetAudioClient(deploymentName);

var result = await audioClient.TranscribeAudioAsync(audioFilePath);

Console.WriteLine("Transcribed text:");
foreach (var item in result.Value.Text)
{
    Console.Write(item);
}

  2. dotnet run komutunu veya Visual Studio üst kısmındaki çalıştır düğmesini kullanarak uygulamayı çalıştırın:

    dotnet run

Çıkışı doğrula

Transkripsiyon, ses dosyanızın tam dökümünü içeren bir özelliğe sahip bir Text yanıt döndürür. Aşağıdaki örneğe benzer bir çıktı görmeniz gerekir. Hatalarla karşılaşırsanız:

  • Dağıtım adınızın tam olarak eşleştiğinden emin olun
  • Ses dosyası yolunuzun doğru olup olmadığını denetleyin
  • API anahtarınızın ve uç noktanızın geçerli olduğundan emin olun

Çıkış

Örnek ses dosyasını kullanıyorsanız konsolda aşağıdaki metnin yazdırıldığını görmeniz gerekir:

The ocelot, Lepardus paradalis, is a small wild cat native to the southwestern United States, 
Mexico, and Central and South America. This medium-sized cat is characterized by solid 
black spots and streaks on its coat, round ears...

Kaynak kodu | Paketi (npm) | Örnekler

Önkoşullar

Microsoft Entra ID önkoşulları

Microsoft Entra ID ile önerilen anahtarsız kimlik doğrulaması için şunları yapmanız gerekir:

  • Microsoft Entra ID ile anahtarsız kimlik doğrulaması için kullanılan Azure CLI yükleyin.
  • Rolü kullanıcı hesabınıza atayın Cognitive Services User . rolleri Azure portalında Access denetimi (IAM)>Add role assignment altında atayabilirsiniz.

Kurulum

  1. Yeni bir klasör synthesis-quickstart oluşturun ve aşağıdaki komutu kullanarak hızlı başlangıç klasörüne gidin:

    mkdir synthesis-quickstart && cd synthesis-quickstart

  2. Aşağıdaki komutla package.json oluşturun:

    npm init -y

  3. JavaScript için OpenAI istemci kitaplığını şu şekilde yükleyin:

    npm install openai

  4. Önerilen parolasız kimlik doğrulaması için:

    npm install @azure/identity

Kaynak bilgilerini alma

Uygulamanızın kimliğini Azure OpenAI kaynağınızla doğrulamak için aşağıdaki bilgileri almanız gerekir:

Değişken adı Değer
AZURE_OPENAI_ENDPOINT Bu değer, Azure portalından kaynağınızı incelerken Keys ve Endpoint bölümünde bulunabilir.
AZURE_OPENAI_DEPLOYMENT_NAME Bu değer, bir modeli dağıtırken dağıtımınız için seçtiğiniz özel ada karşılık gelir. Bu değer Azure portalında Kaynak Yönetimi>Model Dağıtımları altında bulunabilir.

Anahtarsız kimlik doğrulaması ve ortam değişkenlerini ayarlama hakkında daha fazla bilgi edinin.

Dikkat

SDK ile önerilen anahtarsız kimlik doğrulamasını kullanmak için ortam değişkeninin AZURE_OPENAI_API_KEY ayarlanmamış olduğundan emin olun.

Örnek uygulama oluşturma

  1. index.js Dosyayı aşağıdaki kodla oluşturun:

    const { createReadStream } = require("fs");
const { AzureOpenAI } = require("openai");
const { DefaultAzureCredential, getBearerTokenProvider } = require("@azure/identity");

// You will need to set these environment variables or edit the following values
const audioFilePath = "<audio file path>";
const endpoint = process.env.AZURE_OPENAI_ENDPOINT || "Your endpoint";

// Required Azure OpenAI deployment name and API version
const apiVersion = process.env.OPENAI_API_VERSION || "2024-08-01-preview";
const deploymentName = process.env.AZURE_OPENAI_DEPLOYMENT_NAME || "whisper";

// keyless authentication    
const credential = new DefaultAzureCredential();
const scope = "https://ai.azure.com/.default";
const azureADTokenProvider = getBearerTokenProvider(credential, scope);

function getClient() {
  return new AzureOpenAI({
    endpoint,
    azureADTokenProvider,
    apiVersion,
    deployment: deploymentName,
  });
}

export async function main() {
  console.log("== Transcribe Audio Sample ==");

  const client = getClient();
  const result = await client.audio.transcriptions.create({
    model: "",
    file: createReadStream(audioFilePath),
  });

  console.log(`Transcription: ${result.text}`);
}

main().catch((err) => {
  console.error("The sample encountered an error:", err);
});

  2. Aşağıdaki komutla Azure oturum açın:

    az login

  3. JavaScript dosyasını çalıştırın.

    node index.js

wikipediaOcelot.wav gibi örnek ses dosyalarını GitHub konumundaki Azure Döküm Araçları SDK'sı deposundan alabilirsiniz.

Çıkış

{"text":"The ocelot, Lepardus paradalis, is a small wild cat native to the southwestern United States, Mexico, and Central and South America. This medium-sized cat is characterized by solid black spots and streaks on its coat, round ears, and white neck and undersides. It weighs between 8 and 15.5 kilograms, 18 and 34 pounds, and reaches 40 to 50 centimeters 16 to 20 inches at the shoulders. It was first described by Carl Linnaeus in 1758. Two subspecies are recognized, L. p. paradalis and L. p. mitis. Typically active during twilight and at night, the ocelot tends to be solitary and territorial. It is efficient at climbing, leaping, and swimming. It preys on small terrestrial mammals such as armadillo, opossum, and lagomorphs."}

Kaynak kodu | Paketi (npm) | Örnekler

Önkoşullar

Microsoft Entra ID önkoşulları

Microsoft Entra ID ile önerilen anahtarsız kimlik doğrulaması için şunları yapmanız gerekir:

  • Microsoft Entra ID ile anahtarsız kimlik doğrulaması için kullanılan Azure CLI yükleyin.
  • Rolü kullanıcı hesabınıza atayın Cognitive Services User . rolleri Azure portalında Access denetimi (IAM)>Add role assignment altında atayabilirsiniz.

Ayarlamak

  1. Yeni bir klasör whisper-quickstart oluşturun ve aşağıdaki komutu kullanarak hızlı başlangıç klasörüne gidin:

    mkdir whisper-quickstart && cd whisper-quickstart

  2. Aşağıdaki komutla package.json oluşturun:

    npm init -y

  3. package.json öğesini aşağıdaki komutla ECMAScript olarak güncelleyin.

    npm pkg set type=module

  4. JavaScript için OpenAI istemci kitaplığını şu şekilde yükleyin:

    npm install openai

  5. Önerilen parolasız kimlik doğrulaması için:

    npm install @azure/identity

Kaynak bilgilerini alma

Uygulamanızın kimliğini Azure OpenAI kaynağınızla doğrulamak için aşağıdaki bilgileri almanız gerekir:

Değişken adı Değer
AZURE_OPENAI_ENDPOINT Bu değer, Azure portalından kaynağınızı incelerken Keys ve Endpoint bölümünde bulunabilir.
AZURE_OPENAI_DEPLOYMENT_NAME Bu değer, bir modeli dağıtırken dağıtımınız için seçtiğiniz özel ada karşılık gelir. Bu değer Azure portalında Kaynak Yönetimi>Model Dağıtımları altında bulunabilir.

Anahtarsız kimlik doğrulaması ve ortam değişkenlerini ayarlama hakkında daha fazla bilgi edinin.

Dikkat

SDK ile önerilen anahtarsız kimlik doğrulamasını kullanmak için ortam değişkeninin AZURE_OPENAI_API_KEY ayarlanmamış olduğundan emin olun.

Örnek uygulama oluşturma

  1. index.ts Dosyayı aşağıdaki kodla oluşturun:

    import { createReadStream } from "fs";
import { AzureOpenAI } from "openai";
import { DefaultAzureCredential, getBearerTokenProvider } from "@azure/identity";

// You will need to set these environment variables or edit the following values
const audioFilePath = "<audio file path>";
const endpoint = process.env.AZURE_OPENAI_ENDPOINT || "Your endpoint";

// Required Azure OpenAI deployment name and API version
const apiVersion = process.env.OPENAI_API_VERSION || "2024-08-01-preview";
const deploymentName = process.env.AZURE_OPENAI_DEPLOYMENT_NAME || "whisper";

// keyless authentication    
const credential = new DefaultAzureCredential();
const scope = "https://ai.azure.com/.default";
const azureADTokenProvider = getBearerTokenProvider(credential, scope);

function getClient(): AzureOpenAI {
  return new AzureOpenAI({
    endpoint,
    azureADTokenProvider,
    apiVersion,
    deployment: deploymentName,
  });
}

export async function main() {
  console.log("== Transcribe Audio Sample ==");

  const client = getClient();
  const result = await client.audio.transcriptions.create({
    model: "",
    file: createReadStream(audioFilePath),
  });

  console.log(`Transcription: ${result.text}`);
}

main().catch((err) => {
  console.error("The sample encountered an error:", err);
});

  2. tsconfig.json dosyasını oluşturun ve TypeScript kodunu ECMAScript için dönüştürüp aşağıdaki kodu kopyalayın.

    {
    "compilerOptions": {
      "module": "NodeNext",
      "target": "ES2022", // Supports top-level await
      "moduleResolution": "NodeNext",
      "skipLibCheck": true, // Avoid type errors from node_modules
      "strict": true // Enable strict type-checking options
    },
    "include": ["*.ts"]
}

  3. TypeScript'ten JavaScript'e dönüştürme.

    tsc

  4. Aşağıdaki komutla Azure oturum açın:

    az login

  5. Kodu aşağıdaki komutla çalıştırın:

    node index.js

wikipediaOcelot.wav gibi örnek ses dosyalarını GitHub konumundaki Azure Döküm Araçları SDK'sı deposundan alabilirsiniz.

Önemli

API anahtarlarını dikkatli kullanın. API anahtarını doğrudan kodunuzla eklemeyin ve hiçbir zaman herkese açık olarak göndermeyin. API anahtarı kullanıyorsanız, Azure Key Vault güvenli bir şekilde depolayın. Uygulamalarınızda API anahtarlarını güvenli bir şekilde kullanma hakkında daha fazla bilgi için bkz. Azure Key Vault ile API anahtarları.

Yapay zeka hizmetleri güvenliği hakkında daha fazla bilgi için bkz. Azure Yapay Zeka Hizmetleri istekleri doğrulama.

Çıkış

{"text":"The ocelot, Lepardus paradalis, is a small wild cat native to the southwestern United States, Mexico, and Central and South America. This medium-sized cat is characterized by solid black spots and streaks on its coat, round ears, and white neck and undersides. It weighs between 8 and 15.5 kilograms, 18 and 34 pounds, and reaches 40 to 50 centimeters 16 to 20 inches at the shoulders. It was first described by Carl Linnaeus in 1758. Two subspecies are recognized, L. p. paradalis and L. p. mitis. Typically active during twilight and at night, the ocelot tends to be solitary and territorial. It is efficient at climbing, leaping, and swimming. It preys on small terrestrial mammals such as armadillo, opossum, and lagomorphs."}

Önkoşullar

Ayarlamak

Anahtarı ve uç noktayı alma

Azure OpenAI'ye karşı başarılı bir şekilde çağrı yapmak için endpoint ve key gerekir.

Değişken adı Değer
AZURE_OPENAI_ENDPOINT Azure portalından kaynağınızı incelerken hizmet uç noktasını Anahtarlar ve Uç Nokta bölümünde bulabilirsiniz. Alternatif olarak, uç noktayı Microsoft Döküm portalındaki Deployments sayfasında bulabilirsiniz. Örnek uç nokta: https://docs-test-001.openai.azure.com/.
AZURE_OPENAI_API_KEY Bu değer, Azure portalında kaynağınızı incelerken Keys & Endpoint bölümü içerisinde bulunabilir. veya KEY1kullanabilirsinizKEY2.

Azure portalında kaynağınıza gidin. Uç Nokta ve AnahtarlarKaynak Yönetimi bölümünde bulunabilir. Api çağrılarınızın kimliğini doğrulamak için ihtiyacınız olacak şekilde uç noktanızı ve erişim anahtarınızı kopyalayın. veya KEY1kullanabilirsinizKEY2. Her zaman iki anahtara sahip olmak, hizmet kesintisine neden olmadan anahtarları güvenli bir şekilde döndürmenize ve yeniden oluşturmanıza olanak tanır.

Azure portalındaki Azure OpenAI kaynağına ait genel bakış kullanıcı arabiriminin ekran görüntüsü, uç nokta ve erişim anahtarlarının konumunun kırmızıyla daire içine alınmış haliyle.

Ortam değişkenleri

Anahtarınız ve uç noktanız için kalıcı ortam değişkenleri oluşturun ve atayın.

Önemli

API anahtarlarını dikkatli kullanın. API anahtarını doğrudan kodunuzla eklemeyin ve hiçbir zaman herkese açık olarak göndermeyin. API anahtarı kullanıyorsanız, Azure Key Vault güvenli bir şekilde depolayın. Uygulamalarınızda API anahtarlarını güvenli bir şekilde kullanma hakkında daha fazla bilgi için bkz. Azure Key Vault ile API anahtarları.

Yapay zeka hizmetleri güvenliği hakkında daha fazla bilgi için bkz. Azure Yapay Zeka Hizmetleri istekleri doğrulama.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 

setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE"

PowerShell uygulaması oluşturma

Aşağıdaki komutu çalıştırın. YourDeploymentName öğesini, transkripsiyon modelini dağıtırken seçtiğiniz dağıtım adıyla değiştirin. Dağıtım adı, model adıyla aynı olmayabilir. Temel alınan model adıyla aynı olan bir dağıtım adı seçmediğiniz sürece model adının girilmesi hatayla sonuçlanır.

# Azure OpenAI metadata variables
$openai = @{
    api_key     = $Env:AZURE_OPENAI_API_KEY
    api_base    = $Env:AZURE_OPENAI_ENDPOINT # your endpoint should look like the following https://YOUR_RESOURCE_NAME.openai.azure.com/
    api_version = '2024-02-01' # this may change in the future
    name        = 'YourDeploymentName' #This will correspond to the custom name you chose for your deployment when you deployed a model.
}

# Header for authentication
$headers = [ordered]@{
    'api-key' = $openai.api_key
}

$form = @{ file = get-item -path './wikipediaOcelot.wav' }

# Send a completion call to generate an answer
$url = "$($openai.api_base)/openai/deployments/$($openai.name)/audio/transcriptions?api-version=$($openai.api_version)"

$response = Invoke-RestMethod -Uri $url -Headers $headers -Form $form -Method Post -ContentType 'multipart/form-data'
return $response.text

wikipediaOcelot.wav gibi örnek ses dosyalarını GitHub konumundaki Azure Döküm Araçları SDK'sı deposundan alabilirsiniz.

Önemli

Üretim için >Azure Key Vault ile PowerShell Gizli Dizi Yönetimi gibi güvenli bir yöntem kullanarak kimlik bilgilerinizi depolayın ve erişin. Daha fazla bilgi için bkz. kimlik bilgisi güvenliği.

Çıkış

The ocelot, Lepardus paradalis, is a small wild cat native to the southwestern United States, Mexico, and Central and South America. This medium-sized cat is characterized by solid black spots and streaks on its coat, round ears, and white neck and undersides. It weighs between 8 and 15.5 kilograms, 18 and 34 pounds, and reaches 40 to 50 centimeters 16 to 20 inches at the shoulders. It was first described by Carl Linnaeus in 1758. Two subspecies are recognized, L. p. paradalis and L. p. mitis. Typically active during twilight and at night, the ocelot tends to be solitary and territorial. It is efficient at climbing, leaping, and swimming. It preys on small terrestrial mammals such as armadillo, opossum, and lagomorphs.

Not

Azure OpenAI ile kullanabileceğiniz diğer ses modelleri hakkında bilgi için bkz. Audio models.

Ipucu

Transkripsiyon modelinin dosya boyutu sınırı 25 MB'tır. 25 MB'tan büyük bir dosyanın dökümünü almanız gerekiyorsa, Foundry Tools'da Azure Speech toplu transkripsiyon API'sini kullanabilirsiniz.

Sorun giderme

Kimlik doğrulama hataları

401 Yetkisiz hatalar alırsanız şunları doğrulayın:

  • API anahtarınız ortam değişkenlerinde doğru ayarlanmış
  • Azure OpenAI kaynağınız etkin
  • Hesabınızda Bilişsel Hizmetler Katkıda Bulunanı rolü vardır

Dosya biçimi hataları

Transkripsiyon modeli mp3, mp4, mpeg, mpga, m4a, wav ve webm biçimlerini destekler. Diğer biçimler hata döndürür.

Dosya boyutu sınırı

Ses dosyaları 25 MB veya daha küçük olmalıdır. Daha büyük dosyalar için Azure Konuşma toplu transkripsiyon API kullanın.

Dağıtım bulunamadı

Dağıtım adınızın Azure OpenAI Studio'da oluşturduğunuz adla tam olarak eşleştiğinden emin olun. Dağıtım adları büyük/küçük harfe duyarlıdır.

Kaynakları temizleme

Azure OpenAI kaynağını temizlemek ve kaldırmak istiyorsanız kaynağı silebilirsiniz. Kaynağı silmeden önce dağıtılan modelleri silmeniz gerekir.

Sonraki adımlar

  • Son güncelleştirme: