Schnellstart: Sprache in Text mit dem Azure OpenAI Flüstermodell

Voraussetzungen

• Ein Azure-Abonnement – Create one for free.
• Eine Azure OpenAI-Ressource mit einem Sprach-zu-Text-Modell, die in einer unterstützten Region bereitgestellt wird. Weitere Informationen finden Sie unter Create a resource and deploy a model with Azure OpenAI.
• Stellen Sie sicher, dass Sie mindestens die Rolle Cognitive Services Contributor für die Azure OpenAI-Ressource zugewiesen sind.
• Eine Beispielaudiodatei. Sie können Beispielaudio, z. B. wikipediaOcelot.wav, aus dem Repository Azure Speech im Foundry Tools SDK-Repository unter GitHub abrufen.

Konfiguration

Abrufen von Schlüssel und Endpunkt

Um erfolgreich Azure OpenAI aufzurufen, benötigen Sie einen endpoint und einen key.

Wechseln Sie im Azure-Portal zu Ihrer Ressource. Der Endpunkt und die Schlüssel finden Sie im Abschnitt "Ressourcenverwaltung ". Kopieren Sie Ihren Endpunkt und den Zugriffsschlüssel, da Sie beide zum Authentifizieren Ihrer API-Aufrufe benötigen. Sie können entweder KEY1 oder KEY2. Das Vorhandensein von zwei Schlüsseln ermöglicht es Ihnen, Schlüssel sicher zu rotieren und neu zu generieren, ohne den Dienst zu unterbrechen.

Umgebungsvariablen

Erstellen und Zuweisen persistenter Umgebungsvariablen für Ihren Schlüssel und Endpunkt.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 

setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE" 

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_API_KEY', 'REPLACE_WITH_YOUR_KEY_VALUE_HERE', 'User')

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_ENDPOINT', 'REPLACE_WITH_YOUR_ENDPOINT_HERE', 'User')

echo export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE" >> /etc/environment && source /etc/environment

echo export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE" >> /etc/environment && source /etc/environment

Erstellen einer REST-API-Anforderung und -Antwort

Führen Sie in einer Bash-Shell den folgenden Befehl aus. Sie müssen YourDeploymentName durch den von Ihnen beim Bereitstellen des Flüstermodells ausgewählten Bereitstellungsnamen ersetzen. Der Bereitstellungsname entspricht nicht unbedingt dem Modellnamen. Die Eingabe des Modellnamens führt zu einem Fehler, es sei denn, Sie haben einen Bereitstellungsnamen ausgewählt, der mit dem zugrunde liegenden Modellnamen identisch ist.

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"

Die erste Zeile des vorherigen Befehls mit einem Beispielendpunkt würde wie folgt angezeigt:

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

Überprüfen Sie die Ausgabe

Die Antwort enthält ein text Feld mit der vollständigen Transkription Ihrer Audiodatei. Die Ausgabe sollte dem unten stehenden Beispiel ähneln. Wenn Fehler auftreten:

• Bitte überprüfen Sie, ob Ihr Bereitstellungsname genau übereinstimmt.
• Überprüfen Sie, ob ihr Audiodateipfad korrekt ist.
• Sicherstellen, dass Der API-Schlüssel und der Endpunkt gültig sind

Ausgabe

{"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."}

Voraussetzungen

• Ein Azure-Abonnement. Sie können eine kostenlos erstellen.
• Eine Azure OpenAI-Ressource mit einem Sprach-zu-Text-Modell, die in einer unterstützten Region bereitgestellt wird. Weitere Informationen finden Sie unter Create a resource and deploy a model with Azure OpenAI.
• Python 3,8 oder höher
• Die Azure CLI.
• Eine Beispielaudiodatei. Sie können Beispielaudio, z. B. wikipediaOcelot.wav, aus dem Repository Azure Speech im Foundry Tools SDK-Repository unter GitHub abrufen.

Konfiguration

Abrufen von Schlüssel und Endpunkt

Um erfolgreich Azure OpenAI aufzurufen, benötigen Sie einen endpoint und einen key.

Wechseln Sie im Azure-Portal zu Ihrer Ressource. Der Endpunkt und die Schlüssel finden Sie im Abschnitt "Ressourcenverwaltung ". Kopieren Sie Ihren Endpunkt und den Zugriffsschlüssel, da Sie beide zum Authentifizieren Ihrer API-Aufrufe benötigen. Sie können entweder KEY1 oder KEY2. Das Vorhandensein von zwei Schlüsseln ermöglicht es Ihnen, Schlüssel sicher zu rotieren und neu zu generieren, ohne den Dienst zu unterbrechen.

Umgebungsvariablen

Erstellen und Zuweisen persistenter Umgebungsvariablen für Ihren Schlüssel und Endpunkt.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 

setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE"

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_API_KEY', 'REPLACE_WITH_YOUR_KEY_VALUE_HERE', 'User')

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_ENDPOINT', 'REPLACE_WITH_YOUR_ENDPOINT_HERE', 'User')

echo export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE" >> /etc/environment && source /etc/environment

echo export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE" >> /etc/environment && source /etc/environment

Erstellen einer Python Umgebung

Erstellen Sie ein neues Verzeichnis für Ihr Projekt, und navigieren Sie über ein Terminal oder eine Eingabeaufforderung dorthin.

mkdir whisper-quickstart; cd whisper-quickstart

Erstellen und Aktivieren einer virtuellen Umgebung für dieses Projekt.

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

python3 -m venv .venv
source .venv/bin/activate

Installieren Sie die OpenAI-Python-Clientbibliothek mit:

pip install openai

pip install openai==0.28.1

Erstellen der Python-App

1. Erstellen Sie eine neue Python Datei namens quickstart.py. Öffnen Sie sie dann in Ihrem bevorzugten Editor oder ihrer IDE.

2. Ersetzen Sie den Inhalt von quickstart.py durch den folgenden Code. Ändern Sie den Code, um Ihren Bereitstellungsnamen hinzuzufügen:

    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)

    import openai
    import time
    import os
    
    openai.api_key = os.getenv("AZURE_OPENAI_API_KEY")
    openai.api_base = os.getenv("AZURE_OPENAI_ENDPOINT")  # your endpoint should look like the following https://YOUR_RESOURCE_NAME.openai.azure.com/
    openai.api_type = "azure"
    openai.api_version = "2024-02-01"
    
    model_name = "whisper"
    deployment_id = "YOUR-DEPLOYMENT-NAME-HERE" #This will correspond to the custom name you chose for your deployment when you deployed a model."
    audio_language="en"
    
    audio_test_file = "./wikipediaOcelot.wav"
    
    result = openai.Audio.transcribe(
                file=open(audio_test_file, "rb"),            
                model=model_name,
                deployment_id=deployment_id
            )
    
    print(result)

Führen Sie die Anwendung mit dem python Befehl in Der Schnellstartdatei aus:

python quickstart.py

Überprüfen Sie die Ausgabe

Die Antwort enthält ein text Feld mit der vollständigen Transkription Ihrer Audiodatei. Die Ausgabe sollte dem unten stehenden Beispiel ähneln. Wenn Fehler auftreten:

• Bitte überprüfen Sie, ob Ihr Bereitstellungsname genau übereinstimmt.
• Überprüfen Sie, ob ihr Audiodateipfad korrekt ist.
• Sicherstellen, dass Der API-Schlüssel und der Endpunkt gültig sind

Ausgabe

{"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."}

Voraussetzungen

• Ein Azure-Abonnement. Sie können eine kostenlos erstellen.
• Eine Azure OpenAI-Ressource mit einem Sprach-zu-Text-Modell, die in einer unterstützten Region bereitgestellt wird. Weitere Informationen finden Sie unter Create a resource and deploy a model with Azure OpenAI.
• Die .NET 8.0 SDK

Microsoft Entra ID Voraussetzungen

Für die empfohlene schlüssellose Authentifizierung mit Microsoft Entra ID müssen Sie:

• Installieren Sie die Azure CLI, die für die schlüssellose Authentifizierung mit Microsoft Entra ID verwendet wird.
• Weisen Sie die Cognitive Services User Rolle Ihrem Benutzerkonto zu. Sie können rollen im Azure-Portal unter Access control (IAM)>Add role assignment zuweisen.

Konfiguration

1. Erstellen Sie einen neuen Ordner whisper-quickstart , und wechseln Sie mit dem folgenden Befehl zum Schnellstartordner:

   mkdir whisper-quickstart && cd whisper-quickstart
   

2. Erstellen Sie eine neue Konsolenanwendung mit dem folgenden Befehl:

   dotnet new console
   

3. Installieren Sie die OpenAI .NET Clientbibliothek mit dem Befehl dotnet add package:

   dotnet add package Azure.AI.OpenAI
   

4. Installieren Sie für die empfohlene schlüssellose Authentifizierung mit Microsoft Entra ID das Azure.Identity Paket mit:

   dotnet add package Azure.Identity
   

5. Melden Sie sich für die recommended schlüssellose Authentifizierung mit Microsoft Entra ID mit dem folgenden Befehl bei Azure an:

   az login
   

Abrufen von Ressourceninformationen

Sie müssen die folgenden Informationen abrufen, um Ihre Anwendung mit Ihrer Azure OpenAI-Ressource zu authentifizieren:

Schnellstart ausführen

Der Beispielcode in dieser Schnellstartanleitung verwendet Microsoft Entra ID für die empfohlene schlüssellose Authentifizierung. Wenn Sie einen API-Schlüssel verwenden möchten, können Sie das DefaultAzureCredential Objekt durch ein AzureKeyCredential Objekt ersetzen.

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

AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(key));

Führen Sie die folgenden Schritte aus, um die Schnellstartanleitung auszuführen:

1. Ersetzen Sie den Inhalt Program.cs durch den folgenden Code, und aktualisieren Sie die Platzhalterwerte durch Ihren eigenen.

   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. Führen Sie die Anwendung mit dem Befehl dotnet run oder der Schaltfläche "Ausführen" oben in Visual Studio aus:

   dotnet run
   

Überprüfen Sie die Ausgabe

Die Transkription gibt eine Antwort mit einer Text Eigenschaft zurück, die die vollständige Transkription Ihrer Audiodatei enthält. Die Ausgabe sollte dem unten stehenden Beispiel ähneln. Wenn Fehler auftreten:

• Bitte überprüfen Sie, ob Ihr Bereitstellungsname genau übereinstimmt.
• Überprüfen Sie, ob ihr Audiodateipfad korrekt ist.
• Sicherstellen, dass Der API-Schlüssel und der Endpunkt gültig sind

Ausgabe

Wenn Sie die Beispielaudiodatei verwenden, sollte der folgende Text in der Konsole gedruckt werden:

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...

Source-Code | Package (npm) | Samples

Voraussetzungen

• Ein Azure-Abonnement – Create one for free
• LTS-Versionen von Node.js
• Azure CLI für die kennwortlose Authentifizierung in einer lokalen Entwicklungsumgebung verwendet, erstellen Sie den erforderlichen Kontext, indem Sie sich mit dem Azure CLI anmelden.
• Eine Azure OpenAI-Ressource mit einem Sprach-zu-Text-Modell, die in einer unterstützten Region bereitgestellt wird. Weitere Informationen finden Sie unter Create a resource and deploy a model with Azure OpenAI.

Microsoft Entra ID Voraussetzungen

Für die empfohlene schlüssellose Authentifizierung mit Microsoft Entra ID müssen Sie:

• Installieren Sie die Azure CLI, die für die schlüssellose Authentifizierung mit Microsoft Entra ID verwendet wird.
• Weisen Sie die Cognitive Services User Rolle Ihrem Benutzerkonto zu. Sie können rollen im Azure-Portal unter Access control (IAM)>Add role assignment zuweisen.

Konfiguration

1. Erstellen Sie einen neuen Ordner synthesis-quickstart , und wechseln Sie mit dem folgenden Befehl zum Schnellstartordner:

   mkdir synthesis-quickstart && cd synthesis-quickstart
   

2. Erstellen Sie den package.json mit dem folgenden Befehl:

   npm init -y
   

3. Installieren Sie die OpenAI-Clientbibliothek für JavaScript mit:

   npm install openai
   

4. Für die empfohlene kennwortlose Authentifizierung:

   npm install @azure/identity
   

Abrufen von Ressourceninformationen

Sie müssen die folgenden Informationen abrufen, um Ihre Anwendung mit Ihrer Azure OpenAI-Ressource zu authentifizieren:

Erstellen einer Beispielanwendung

Sie können Beispiel-Audiodateien wie wikipediaOcelot.wav aus dem Azure Speech in Foundry Tools SDK-Repository auf GitHub herunterladen.

Ausgabe

{"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."}

Source-Code | Package (npm) | Samples

Voraussetzungen

• Ein Azure-Abonnement – Create one for free
• LTS-Versionen von Node.js
• Typescript
• Azure CLI für die kennwortlose Authentifizierung in einer lokalen Entwicklungsumgebung verwendet, erstellen Sie den erforderlichen Kontext, indem Sie sich mit dem Azure CLI anmelden.
• Eine Azure OpenAI-Ressource mit einem Sprach-zu-Text-Modell, die in einer unterstützten Region bereitgestellt wird. Weitere Informationen finden Sie unter Create a resource and deploy a model with Azure OpenAI.

Microsoft Entra ID Voraussetzungen

Für die empfohlene schlüssellose Authentifizierung mit Microsoft Entra ID müssen Sie:

• Installieren Sie die Azure CLI, die für die schlüssellose Authentifizierung mit Microsoft Entra ID verwendet wird.
• Weisen Sie die Cognitive Services User Rolle Ihrem Benutzerkonto zu. Sie können rollen im Azure-Portal unter Access control (IAM)>Add role assignment zuweisen.

Einrichten

1. Erstellen Sie einen neuen Ordner whisper-quickstart , und wechseln Sie mit dem folgenden Befehl zum Schnellstartordner:

   mkdir whisper-quickstart && cd whisper-quickstart
   

2. Erstellen Sie den package.json mit dem folgenden Befehl:

   npm init -y
   

3. Aktualisieren Sie das package.json auf ECMAScript mit dem folgenden Befehl:

   npm pkg set type=module
   

4. Installieren Sie die OpenAI-Clientbibliothek für JavaScript mit:

   npm install openai
   

5. Für die empfohlene kennwortlose Authentifizierung:

   npm install @azure/identity
   

Abrufen von Ressourceninformationen

Sie müssen die folgenden Informationen abrufen, um Ihre Anwendung mit Ihrer Azure OpenAI-Ressource zu authentifizieren:

Erstellen einer Beispielanwendung

Sie können Beispiel-Audiodateien wie wikipediaOcelot.wav aus dem Azure Speech in Foundry Tools SDK-Repository auf GitHub herunterladen.

Ausgabe

{"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."}

Voraussetzungen

• Ein Azure-Abonnement – Create one for free
• Sie können entweder die neueste Version, PowerShell 7 oder Windows PowerShell 5.1.
• Eine Azure OpenAI-Ressource mit einem Sprach-zu-Text-Modell, die in einer unterstützten Region bereitgestellt wird. Weitere Informationen finden Sie unter Create a resource and deploy a model with Azure OpenAI.

Einrichten

Abrufen von Schlüssel und Endpunkt

Um erfolgreich Azure OpenAI aufzurufen, benötigen Sie einen endpoint und einen key.

Wechseln Sie im Azure-Portal zu Ihrer Ressource. Der Endpunkt und die Schlüssel finden Sie im Abschnitt "Ressourcenverwaltung ". Kopieren Sie Ihren Endpunkt und den Zugriffsschlüssel, da Sie beide zum Authentifizieren Ihrer API-Aufrufe benötigen. Sie können entweder KEY1 oder KEY2. Das Vorhandensein von zwei Schlüsseln ermöglicht es Ihnen, Schlüssel sicher zu rotieren und neu zu generieren, ohne den Dienst zu unterbrechen.

Umgebungsvariablen

Erstellen und Zuweisen persistenter Umgebungsvariablen für Ihren Schlüssel und Endpunkt.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 

setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE" 

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_API_KEY', 'REPLACE_WITH_YOUR_KEY_VALUE_HERE', 'User')

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_ENDPOINT', 'REPLACE_WITH_YOUR_ENDPOINT_HERE', 'User')

echo export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE" >> /etc/environment && source /etc/environment

echo export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE" >> /etc/environment && source /etc/environment

Erstellen einer PowerShell-App

Führen Sie den folgenden Befehl aus. Sie müssen YourDeploymentName durch den von Ihnen beim Bereitstellen des Flüstermodells ausgewählten Bereitstellungsnamen ersetzen. Der Bereitstellungsname entspricht nicht unbedingt dem Modellnamen. Die Eingabe des Modellnamens führt zu einem Fehler, es sei denn, Sie haben einen Bereitstellungsnamen ausgewählt, der mit dem zugrunde liegenden Modellnamen identisch ist.

# 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

Sie können Beispiel-Audiodateien wie wikipediaOcelot.wav aus dem Azure Speech in Foundry Tools SDK-Repository auf GitHub herunterladen.

Ausgabe

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.