İngilizce dilinde oku

Aracılığıyla paylaş


Hızlı Başlangıç: Yapay zeka sohbetlerinizde görüntüleri kullanma

Tercih ettiğiniz kullanım yöntemini seçin

Azure OpenAI Hizmeti ile görüntülerle GPT-4 Turbo kullanmaya başlayın.

Not

Model seçimi

En son görüntü işleme özellikli modeller ve gpt-4o minişeklindedirgpt-4o. Bu modeller genel önizleme aşamasındadır. En son kullanılabilir GA modeli sürümüdür gpt-4turbo-2024-04-09.

Önemli

Görüntü işleme işlevselliğine sahip sohbet tamamlama modelleri kullanılırken ek kullanım ücretleri uygulanabilir.

Görüntü anlama ile bir sohbet tamamlama modelini dağıtmak ve test etmek için Azure AI Foundry'yi kullanmaya başlamak için bu makaleyi kullanın.

Önkoşullar

Medyanızı hazırlama

Bu hızlı başlangıcı tamamlamak için bir görüntüye ihtiyacınız vardır. Bu örnek görüntüyü veya kullanabileceğiniz başka bir görüntüyü kullanabilirsiniz.

Hızlı başlangıcı tamamlamak için kullanılabilecek bir araba kazasının fotoğrafı.

Azure AI Foundry'ye gidin

  1. Azure AI Foundry'ye göz atın ve Azure OpenAI kaynağınızla ilişkili kimlik bilgileriyle oturum açın. Oturum açma iş akışı sırasında veya sonrasında uygun dizini, Azure aboneliğini ve Azure OpenAI kaynağını seçin.
  2. Çalışmak istediğiniz hub'ı seçin.
  3. Sol gezinti menüsünde Modeller + uç noktalar'ı ve + Modeli dağıt'ı seçin.
  4. Model adını seçerek görüntü özellikli bir dağıtım seçin: gpt-4o veya gpt-4o-mini. Görüntülenen pencerede bir ad ve dağıtım türü seçin. Azure OpenAI kaynağınızın bağlı olduğundan emin olun. Model dağıtımı hakkında daha fazla bilgi için bkz. kaynak dağıtım kılavuzu.
  5. Dağıt'ı seçin.
  6. Ardından yeni modelinizi seçin ve Oyun alanında aç'ı seçin. Sohbet oyun alanında, oluşturduğunuz dağıtım Dağıtım açılan listesinde seçilmelidir.

Çocuk bahçesi

Bu sohbet oturumunda, yardımcıya giriş yaptığınız görüntüleri anlamanıza yardımcı olmasını emredersiniz.

Yardımcı kurulumu, sohbet oturumları, ayarlar ve panellerle ilgili genel yardım için Sohbet hızlı başlangıcına bakın.

Görüntüleri analiz etmek için sohbet oturumu başlatma

Bu sohbet oturumunda, yardımcıya girdiğiniz görüntülerin anlaşılmasına yardımcı olması için talimat acaksınız.

  1. Başlamak için, Dağıtım açılan listesinde görüntü özellikli dağıtımınızın seçili olduğundan emin olun.

  2. Kurulum panelindeki bağlam metin kutusunda, yardımcıya rehberlik etmek için şu istemi sağlayın: "You're an AI assistant that helps people find information." İsterseniz, istemi görüntünüze veya senaryonuza uyarlayabilirsiniz.

    Not

    Modelden gelen yararlı olmayan yanıtları önlemek için Sistem İletisi'ni göreve özgü olacak şekilde güncelleştirmenizi öneririz.

  3. Değişikliklerinizi kaydetmek için Değişiklikleri uygula'yı seçin.

  4. Sohbet oturumu bölmesinde ek düğmesini ve ardından Resmi karşıya yükle'yi seçin. Resminizi seçin.

  5. Sohbet alanına aşağıdaki istemi ekleyin: Describe this imageve ardından gönder simgesini seçerek gönderin.

  6. Gönder simgesinin yerini bir durdur düğmesi alır. Bunu seçerseniz, yardımcı isteğinizi işlemeyi durdurur. Bu hızlı başlangıç için yardımcının yanıtını bitirmesine izin verin.

  7. Yardımcı, resmin açıklamasını verir.

  8. Görüntünüzün analiziyle ilgili bir takip sorusu sorun. girebilirsiniz. "What should I highlight about this image to my insurance company?"

  9. Burada gösterilene benzer bir yanıt almanız gerekir:

    When reporting the incident to your insurance company, you should highlight the following key points from the image:  
    
    1. **Location of Damage**: Clearly state that the front end of the car, particularly the driver's side, is damaged. Mention the crumpled hood, broken front bumper, and the damaged left headlight.  
    
    2. **Point of Impact**: Indicate that the car has collided with a guardrail, which may suggest that no other vehicles were involved in the accident.  
    
    3. **Condition of the Car**: Note that the damage seems to be concentrated on the front end, and there is no visible damage to the windshield or rear of the car from this perspective.  
    
    4. **License Plate Visibility**: Mention that the license plate is intact and can be used for identification purposes.  
    
    5. **Environment**: Report that the accident occurred near a roadside with a guardrail, possibly in a rural or semi-rural area, which might help in establishing the accident location and context.  
    
    6. **Other Observations**: If there were any other circumstances or details not visible in the image that may have contributed to the accident, such as weather conditions, road conditions, or any other relevant information, be sure to include those as well.  
    
    Remember to be factual and descriptive, avoiding speculation about the cause of the accident, as the insurance company will conduct its own investigation.
    

Kodu görüntüleme ve dışarı aktarma

Sohbet oturumunun herhangi bir noktasında, konuşmanın JSON olarak biçimlendirildiğini görmek için sohbet penceresinin üst kısmındaki Ham JSON göster anahtarını etkinleştirebilirsiniz. Hızlı başlangıç sohbet oturumunun başında nasıl göründüğü aşağıda verilmiştir:

JSON
[
	{
		"role": "system",
		"content": [
			"You are an AI assistant that helps people find information."
		]
	},
]

Kaynakları temizleme

Bir Azure OpenAI kaynağını temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Görüntü İşlemeli GPT-4 Turbo modelini dağıtmak ve kullanmak üzere Azure OpenAI REST API'lerini kullanmaya başlamak için bu makaleyi kullanın.

Önkoşullar

Not

Şu anda GÖRÜNTÜ İşlemeli GPT-4 Turbo modeli için içerik filtrelemeyi kapatmak desteklenmiyor.

Anahtarı ve uç noktayı alma

Azure OpenAI API'lerini başarıyla çağırmak için Azure OpenAI kaynağınız hakkında aşağıdaki bilgilere ihtiyacınız vardır:

Değişken Veri Akışı Adı Değer
Uç nokta api_base Uç nokta değeri, Azure portalında kaynağınız için Anahtarlar ve Uç Nokta altında bulunur. Uç noktayı Azure AI Foundry portalındaki Dağıtımlar sayfasından da bulabilirsiniz. Örnek uç nokta: https://docs-test-001.openai.azure.com/.
Anahtar api_key Anahtar değeri, Azure portalında kaynağınız için Anahtarlar ve Uç Nokta altında da bulunur. Azure, kaynağınız için iki anahtar oluşturur. İki değerden birini kullanabilirsiniz.

Azure portalında kaynağınıza gidin. Gezinti bölmesinde Kaynak Yönetimi'nin altında Anahtarlar ve Uç Nokta'yı seçin. Uç nokta değerini ve erişim anahtarı değerini kopyalayın. ANAHTAR 1 veya ANAHTAR 2 değerini kullanabilirsiniz. İki 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ında bir Azure OpenAI kaynağının Anahtarlar ve Uç Nokta sayfasını gösteren ekran görüntüsü.

Yeni Python uygulaması oluşturma

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

  1. quickstart.py içeriğini aşağıdaki kodla değiştirin.

    Python
    # Packages required:
    import requests 
    import json 
    
    api_base = '<your_azure_openai_endpoint>' 
    deployment_name = '<your_deployment_name>'
    API_KEY = '<your_azure_openai_key>'
    
    base_url = f"{api_base}openai/deployments/{deployment_name}" 
    headers = {   
        "Content-Type": "application/json",   
        "api-key": API_KEY 
    } 
    
    # Prepare endpoint, headers, and request body 
    endpoint = f"{base_url}/chat/completions?api-version=2023-12-01-preview" 
    data = { 
        "messages": [ 
            { "role": "system", "content": "You are a helpful assistant." }, 
            { "role": "user", "content": [  
                { 
                    "type": "text", 
                    "text": "Describe this picture:" 
                },
                { 
                    "type": "image_url",
                    "image_url": {
                        "url": "<image URL>"
                    }
                }
            ] } 
        ], 
        "max_tokens": 2000 
    }   
    
    # Make the API call   
    response = requests.post(endpoint, headers=headers, data=json.dumps(data))   
    
    print(f"Status Code: {response.status_code}")   
    print(response.text)
    
  2. Aşağıdaki değişiklikleri yapın:

    1. Uygun alanlara uç nokta URL'nizi ve anahtarınızı girin.
    2. Uygun alana Görüntü İşleme dağıtım adıyla GPT-4 Turbo'nuzu girin.
    3. Alanın değerini "image" görüntünüzün URL'si olarak değiştirin.

      İpucu

      Url yerine temel 64 kodlanmış görüntü verilerini de kullanabilirsiniz. Daha fazla bilgi için bkz . GPT-4 Turbo with Vision nasıl yapılır kılavuzu.

  3. Uygulamayı şu komutla python çalıştırın:

    Console
    python quickstart.py
    

Kaynakları temizleme

Bir Azure OpenAI kaynağını temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Görüntü İşlemeli GPT-4 Turbo modelini dağıtmak ve kullanmak üzere Azure OpenAI Python SDK'sını kullanmaya başlamak için bu makaleyi kullanın.

Kitaplık kaynak kodu | Paketi (PyPi) |

Önkoşullar

Ayarlama

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

Console
pip install openai

Not

Bu kitaplık OpenAI tarafından korunur. Kitaplığın en son güncelleştirmelerini izlemek için sürüm geçmişine bakın.

Anahtarı ve uç noktayı alma

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

Değişken adı Değer
ENDPOINT Hizmet uç noktası, Kaynağınızı Azure portalından incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, uç noktayı Azure AI Foundry portalındaki Dağıtımlar sayfasında bulabilirsiniz. Örnek uç nokta: https://docs-test-001.openai.azure.com/.
API-KEY Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. KEY1 veya KEY2 kullanabilirsiniz.

Azure portalında kaynağınıza gidin. Anahtarlar ve Uç Nokta bölümü Kaynak 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. KEY1 veya KEY2 kullanabilirsiniz. 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ında uç nokta ve erişim anahtarları konumu kırmızıyla daire içine alınmış bir Azure OpenAI kaynağının genel bakış kullanıcı arabiriminin ekran görüntüsü.

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

Kimlik bilgilerini bulutta çalışan uygulamalarınızla depolamaktan kaçınmak için Azure kaynakları için yönetilen kimliklerle Microsoft Entra Id kimlik doğrulaması yapmanızı öneririz.

API anahtarlarını dikkatli kullanın. API anahtarını doğrudan kodunuzla eklemeyin ve hiçbir zaman herkese açık olarak göndermeyin. API anahtarlarını kullanıyorsanız, bunları Azure Key Vault'ta güvenli bir şekilde depolayın, anahtarları düzenli olarak döndürün ve rol tabanlı erişim denetimi ve ağ erişim kısıtlamalarını kullanarak Azure Key Vault'a erişimi kısıtlayı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 AI hizmetlerine yönelik isteklerin kimliğini doğrulama.

Windows Command Prompt
setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 
setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE" 

Yeni Python uygulaması oluşturma

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

  1. quickstart.py içeriğini aşağıdaki kodla değiştirin.

    Python
    from openai import AzureOpenAI
    
    api_base = os.getenv("AZURE_OPENAI_ENDPOINT")
    api_key= os.getenv("AZURE_OPENAI_API_KEY")
    deployment_name = '<your_deployment_name>'
    api_version = '2023-12-01-preview' # this might change in the future
    
    client = AzureOpenAI(
        api_key=api_key,  
        api_version=api_version,
        base_url=f"{api_base}/openai/deployments/{deployment_name}"
    )
    
    response = client.chat.completions.create(
        model=deployment_name,
        messages=[
            { "role": "system", "content": "You are a helpful assistant." },
            { "role": "user", "content": [  
                { 
                    "type": "text", 
                    "text": "Describe this picture:" 
                },
                { 
                    "type": "image_url",
                    "image_url": {
                        "url": "<image URL>"
                    }
                }
            ] } 
        ],
        max_tokens=2000 
    )
    
    print(response)
    
  2. Aşağıdaki değişiklikleri yapın:

    1. Uygun alana GÖRÜNTÜ İşlemeli GPT-4 Turbo dağıtımınızın adını girin.
    2. Alanın değerini "url" görüntünüzün URL'si olarak değiştirin.

      İpucu

      Url yerine temel 64 kodlanmış görüntü verilerini de kullanabilirsiniz. Daha fazla bilgi için bkz . GPT-4 Turbo with Vision nasıl yapılır kılavuzu.

  3. Uygulamayı şu komutla python çalıştırın:

    Console
    python quickstart.py
    

Ö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, bunu Azure Key Vault'ta 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 AI hizmetlerine yönelik isteklerin kimliğini doğrulama.

Kaynakları temizleme

Bir Azure OpenAI kaynağını temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Görüntü İşlemeli GPT-4 Turbo modelini dağıtmak ve kullanmak üzere OpenAI JavaScript SDK'sını kullanmaya başlamak için bu makaleyi kullanın.

Bu SDK, OpenAI tarafından Azure tarafından sağlanan Belirli Azure türleriyle sağlanır.

Başvuru belgeleri | Kitaplık kaynak kodu | Paketi (npm)Örnekler |

Önkoşullar

Not

Bu kitaplık OpenAI tarafından korunur. Kitaplığın en son güncelleştirmelerini izlemek için sürüm geçmişine bakın.

Microsoft Entra Id önkoşulları

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

Kaynak bilgilerini alma

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

Değişken adı Değer
AZURE_OPENAI_ENDPOINT Bu değer, Kaynağınızı Azure portalından incelerken Anahtarlar ve Uç Nokta 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ındaki Kaynak Yönetimi>Modeli Dağıtımları altında bulunabilir.
OPENAI_API_VERSION API Sürümleri hakkında daha fazla bilgi edinin.

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.

Node uygulaması oluşturma

Konsol penceresinde (cmd, PowerShell veya Bash gibi), uygulamanız için yeni bir dizin oluşturun ve bu dizine gidin. Ardından komutunu çalıştırarak npm init package.json dosyasıyla bir düğüm uygulaması oluşturun.

Console
npm init

İstemci kitaplığını yükleme

İstemci kitaplıklarını şu şekilde yükleyin:

Console
npm install openai @azure/identity

Uygulamanızın package.json dosyası bağımlılıklarla güncelleştirilir.

Görüntü istemleri için yeni bir JavaScript uygulaması oluşturma

azure-samples/cognitive-services-sample-data-files dosyasından bir görüntü seçin ve ortam değişkenlerindeki bir görüntünün URL'sini ayarlayın.

  1. quickstart.js içeriğini aşağıdaki kodla değiştirin.

    JavaScript
    const AzureOpenAI = require('openai').AzureOpenAI;
    const { 
        DefaultAzureCredential, 
        getBearerTokenProvider 
    } = require('@azure/identity');
    
    // You will need to set these environment variables or edit the following values
    const endpoint = process.env["AZURE_OPENAI_ENDPOINT"] || "<endpoint>";
    const imageUrl = process.env["IMAGE_URL"] || "<image url>";
    
    // Required Azure OpenAI deployment name and API version
    const apiVersion = "2024-07-01-preview";
    const deploymentName = "gpt-4-with-turbo";
    
    // keyless authentication    
    const credential = new DefaultAzureCredential();
    const scope = "https://cognitiveservices.azure.com/.default";
    const azureADTokenProvider = getBearerTokenProvider(credential, scope);
    
    function getClient(): AzureOpenAI {
      return new AzureOpenAI({
        endpoint,
        azureADTokenProvider,
        apiVersion,
        deployment: deploymentName,
      });
    }
    function createMessages() {
      return {
        messages: [
          { role: "system", content: "You are a helpful assistant." },
          {
            role: "user",
            content: [
              {
                type: "text",
                text: "Describe this picture:",
              },
              {
                type: "image_url",
                image_url: {
                  url: imageUrl,
                },
              },
            ],
          },
        ],
        model: "",
        max_tokens: 2000,
      };
    }
    async function printChoices(completion) {
      for (const choice of completion.choices) {
        console.log(choice.message);
      }
    }
    export async function main() {
      console.log("== Get GPT-4 Turbo with vision Sample ==");
    
      const client = getClient();
      const messages = createMessages();
      const completion = await client.chat.completions.create(messages);
      await printChoices(completion);
    }
    
    main().catch((err) => {
      console.error("Error occurred:", err);
    });
    
  2. Aşağıdaki değişiklikleri yapın:

    1. Uygun alana GÖRÜNTÜ İşlemeli GPT-4 Turbo dağıtımınızın adını girin.
    2. Alanın değerini "url" görüntünüzün URL'si olarak değiştirin.

      İpucu

      Url yerine temel 64 kodlanmış görüntü verilerini de kullanabilirsiniz. Daha fazla bilgi için bkz . GPT-4 Turbo with Vision nasıl yapılır kılavuzu.

  3. Uygulamayı aşağıdaki komutla çalıştırın:

    Console
    node quickstart.js
    

Kaynakları temizleme

Bir Azure OpenAI kaynağını temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Görüntü İşlemeli GPT-4 Turbo modelini dağıtmak ve kullanmak üzere OpenAI JavaScript SDK'sını kullanmaya başlamak için bu makaleyi kullanın.

Bu SDK, OpenAI tarafından Azure tarafından sağlanan Belirli Azure türleriyle sağlanır.

Başvuru belgeleri | Kitaplık kaynak kodu | Paketi (npm)Örnekler |

Önkoşullar

Not

Bu kitaplık OpenAI tarafından korunur. Kitaplığın en son güncelleştirmelerini izlemek için sürüm geçmişine bakın.

Microsoft Entra Id önkoşulları

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

Kaynak bilgilerini alma

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

Değişken adı Değer
AZURE_OPENAI_ENDPOINT Bu değer, Kaynağınızı Azure portalından incelerken Anahtarlar ve Uç Nokta 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ındaki Kaynak Yönetimi>Modeli Dağıtımları altında bulunabilir.
OPENAI_API_VERSION API Sürümleri hakkında daha fazla bilgi edinin.

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.

Node uygulaması oluşturma

Konsol penceresinde (cmd, PowerShell veya Bash gibi), uygulamanız için yeni bir dizin oluşturun ve bu dizine gidin. Ardından komutunu çalıştırarak npm init package.json dosyasıyla bir düğüm uygulaması oluşturun.

Console
npm init

İstemci kitaplığını yükleme

İstemci kitaplıklarını şu şekilde yükleyin:

Console
npm install openai @azure/identity

Uygulamanızın package.json dosyası bağımlılıklarla güncelleştirilir.

Görüntü istemleri için yeni bir JavaScript uygulaması oluşturma

azure-samples/cognitive-services-sample-data-files dosyasından bir görüntü seçin ve ortam değişkenlerindeki bir görüntünün URL'sini ayarlayın.

  1. Bir quickstart.ts oluşturun ve aşağıdaki kodu yapıştırın.

    TypeScript
    import { AzureOpenAI } from "openai";
    import { 
        DefaultAzureCredential, 
        getBearerTokenProvider 
    } from "@azure/identity";
    import type {
      ChatCompletion,
      ChatCompletionCreateParamsNonStreaming,
    } from "openai/resources/index";
    
    // You will need to set these environment variables or edit the following values
    const endpoint = process.env["AZURE_OPENAI_ENDPOINT"] || "<endpoint>";
    const imageUrl = process.env["IMAGE_URL"] || "<image url>";
    
    // Required Azure OpenAI deployment name and API version
    const apiVersion = "2024-07-01-preview";
    const deploymentName = "gpt-4-with-turbo";
    
    // keyless authentication    
    const credential = new DefaultAzureCredential();
    const scope = "https://cognitiveservices.azure.com/.default";
    const azureADTokenProvider = getBearerTokenProvider(credential, scope);
    
    function getClient(): AzureOpenAI {
      return new AzureOpenAI({
        endpoint,
        azureADTokenProvider,
        apiVersion,
        deployment: deploymentName,
      });
    }
    function createMessages(): ChatCompletionCreateParamsNonStreaming {
      return {
        messages: [
          { role: "system", content: "You are a helpful assistant." },
          {
            role: "user",
            content: [
              {
                type: "text",
                text: "Describe this picture:",
              },
              {
                type: "image_url",
                image_url: {
                  url: imageUrl,
                },
              },
            ],
          },
        ],
        model: "",
        max_tokens: 2000,
      };
    }
    async function printChoices(completion: ChatCompletion): Promise<void> {
      for (const choice of completion.choices) {
        console.log(choice.message);
      }
    }
    export async function main() {
      console.log("== Get GPT-4 Turbo with vision Sample ==");
    
      const client = getClient();
      const messages = createMessages();
      const completion = await client.chat.completions.create(messages);
      await printChoices(completion);
    }
    
    main().catch((err) => {
      console.error("Error occurred:", err);
    });
    
  2. Aşağıdaki değişiklikleri yapın:

    1. Uygun alana GÖRÜNTÜ İşlemeli GPT-4 Turbo dağıtımınızın adını girin.
    2. Alanın değerini "url" görüntünüzün URL'si olarak değiştirin.

      İpucu

      Url yerine temel 64 kodlanmış görüntü verilerini de kullanabilirsiniz. Daha fazla bilgi için bkz . GPT-4 Turbo with Vision nasıl yapılır kılavuzu.

  3. Uygulamayı aşağıdaki komutla derleyin:

    Console
    tsc
    
  4. Uygulamayı aşağıdaki komutla çalıştırın:

    Console
    node quickstart.js
    

Kaynakları temizleme

Bir Azure OpenAI kaynağını temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Görüntü İşlemeli GPT-4 Turbo modelini dağıtmak ve kullanmak üzere Azure OpenAI .NET SDK'sını kullanmaya başlamak için bu makaleyi kullanın.

Önkoşullar

Ayarlama

Anahtarı ve uç noktayı alma

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

Değişken adı Değer
AZURE_OPENAI_ENDPOINT Hizmet uç noktası, Kaynağınızı Azure portalından incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, uç noktayı Azure AI Foundry portalındaki Dağıtımlar sayfasında bulabilirsiniz. Örnek uç nokta: https://docs-test-001.openai.azure.com/.
AZURE_OPENAI_API_KEY Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. KEY1 veya KEY2 kullanabilirsiniz.

Azure portalında kaynağınıza gidin. Uç Nokta ve Anahtarlar Kaynak 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. KEY1 veya KEY2 kullanabilirsiniz. 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ında uç nokta ve erişim anahtarları konumu vurgulanmış bir Azure OpenAI kaynağının genel bakış kullanıcı arabiriminin ekran görüntüsü.

.NET uygulamasını oluşturma

  1. komutunu kullanarak dotnet new bir .NET uygulaması oluşturun:

    .NET CLI
    dotnet new console -n OpenAISpeech
    
  2. Yeni uygulamanın dizinine geçin:

    .NET CLI
    cd OpenAISpeech
    

İstemci kitaplığını yükleme

İstemci kitaplığını Azure.OpenAI yükleyin:

.NET CLI
dotnet add package Azure.AI.OpenAI

Parolasız kimlik doğrulaması önerilir

Parolasız kimlik doğrulaması anahtar tabanlı alternatiflerden daha güvenlidir ve Azure hizmetlerine bağlanmak için önerilen yaklaşımdır. Parolasız kimlik doğrulamasını kullanmayı seçerseniz aşağıdakileri tamamlamanız gerekir:

  1. Azure.Identity paketini ekleyin.

    .NET CLI
    dotnet add package Azure.Identity
    
  2. Rolü kullanıcı hesabınıza atayın Cognitive Services User . Bu, OpenAI kaynağınızdaki Azure portalında Erişim denetimi (IAM)>Rol ataması ekle altında yapılabilir.

  3. Aracılığıyla az loginVisual Studio veya Azure CLI kullanarak Azure'da oturum açın.

Uygulama kodunu güncelleştirme

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

    C#
    using Azure;
    using Azure.AI.OpenAI;
    using Azure.Identity;
    using OpenAI.Chat; // Required for Passwordless auth
    
    var endpoint = new Uri("YOUR_AZURE_OPENAI_ENDPOINT");
    var credentials = new AzureKeyCredential("YOUR_AZURE_OPENAI_KEY");
    // var credentials = new DefaultAzureCredential(); // Use this line for Passwordless auth
    var deploymentName = "gpt-4"; // Default name, update with your own if needed
    
    var openAIClient = new AzureOpenAIClient(endpoint, credentials);
    var chatClient = openAIClient.GetChatClient(deploymentName);
    
    var imageUri = "YOUR_IMAGE_URL";
    
    List<ChatMessage> messages = [
        new UserChatMessage(
            ChatMessageContentPart.CreateTextMessageContentPart("Please describe the following image:"),
            ChatMessageContentPart.CreateImageMessageContentPart(new Uri(imageUri), "image/png"))
    ];
    
    ChatCompletion chatCompletion = await chatClient.CompleteChatAsync(messages);
    
    Console.WriteLine($"[ASSISTANT]:");
    Console.WriteLine($"{chatCompletion.Content[0].Text}");
    

Önemli

Kimlik bilgilerini bulutta çalışan uygulamalarınızla depolamaktan kaçınmak için Azure kaynakları için yönetilen kimliklerle Microsoft Entra Id kimlik doğrulaması yapmanızı öneririz.

API anahtarlarını dikkatli kullanın. API anahtarını doğrudan kodunuzla eklemeyin ve hiçbir zaman herkese açık olarak göndermeyin. API anahtarlarını kullanıyorsanız, bunları Azure Key Vault'ta güvenli bir şekilde depolayın, anahtarları düzenli olarak döndürün ve rol tabanlı erişim denetimi ve ağ erişim kısıtlamalarını kullanarak Azure Key Vault'a erişimi kısıtlayı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 AI hizmetlerine yönelik isteklerin kimliğini doğrulama.

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

    .NET CLI
    dotnet run
    

Uygulama, değişken için speechFilePath belirttiğiniz konumda bir ses dosyası oluşturur. Oluşturulan sesi duymak için dosyayı cihazınızda yürütin.

Kaynakları temizleme

Bir Azure OpenAI kaynağını temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Sonraki adımlar