Mulai cepat: Menggunakan gambar di obrolan AI Anda

Artikel
10/30/2024

Mulai menggunakan GPT-4 Turbo dengan gambar dengan Azure OpenAI Service.

Catatan

Pilihan model

Model berkemampangan visi terbaru adalah gpt-4o dan gpt-4o mini. Ini ada di pratinjau publik. Model GA terbaru yang tersedia adalah gpt-4 versi turbo-2024-04-09.

Mulai jelajahi GPT-4 Turbo dengan kemampuan Visi dengan pendekatan tanpa kode melalui Azure OpenAI Studio.

Prasyarat

Langganan Azure. Buat akun gratis.
Sumber daya Azure OpenAI Service dengan GPT-4 Turbo dengan model Vision disebarkan. Lihat ketersediaan model Pratinjau GPT-4 dan GPT-4 Turbo untuk wilayah yang tersedia. Untuk informasi selengkapnya tentang pembuatan sumber daya, lihat panduan penyebaran sumber daya.

Catatan

Saat ini tidak didukung untuk menonaktifkan pemfilteran konten untuk GPT-4 Turbo dengan model Visi.

Buka Azure OpenAI Studio

Telusuri ke Azure OpenAI Studio dan masuk dengan kredensial yang terkait dengan sumber daya Azure OpenAI Anda. Selama atau setelah alur kerja masuk, pilih direktori, langganan Azure, dan sumber daya Azure OpenAI yang sesuai.

Di bawah Manajemen pilih Penyebaran dan Buat GPT-4 Turbo dengan penyebaran Visi dengan memilih nama model: "gpt-4" dan versi model "vision-preview". Untuk informasi selengkapnya tentang penyebaran model, lihat panduan penyebaran sumber daya.

Di bawah bagian Playground pilih Obrolan.

Playground

Dari halaman ini, Anda dapat dengan cepat melakukan iterasi dan bereksperimen dengan kemampuan model.

Untuk bantuan umum terkait penyiapan asisten, sesi obrolan, pengaturan, dan panel, lihat mulai cepat Obrolan.

Memulai sesi obrolan untuk menganalisis gambar atau video

Perintah gambar

Dalam sesi obrolan ini, Anda menginstruksikan asisten untuk membantu memahami gambar yang Anda masukkan.

Untuk memulai, pilih GPT-4 Turbo Anda dengan penyebaran Visi dari menu dropdown.
Di panel Penyetelan asisten, berikan Pesan Sistem untuk memandu asisten. Pesan Sistem default adalah: "Anda adalah asisten AI yang membantu orang menemukan informasi." Anda dapat menyesuaikan Pesan Sistem dengan gambar atau skenario yang Anda unggah.

Catatan

Disarankan untuk memperbarui Pesan Sistem agar spesifik untuk tugas untuk menghindari respons yang tidak membantu dari model.
Simpan perubahan Anda, dan ketika diminta untuk mengonfirmasi pembaruan pesan sistem, pilih Lanjutkan.
Di panel Sesi obrolan, masukkan perintah teks seperti "Jelaskan gambar ini," dan unggah gambar dengan tombol lampiran. Anda dapat menggunakan perintah teks yang berbeda untuk kasus penggunaan Anda. Lalu pilih Kirim.
Amati output yang disediakan. Pertimbangkan untuk mengajukan pertanyaan tindak lanjut yang terkait dengan analisis gambar Anda untuk mempelajari lebih lanjut.

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Azure OpenAI, Anda dapat menghapus sumber daya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya apa pun yang terkait dengannya.

Gunakan artikel ini untuk mulai menggunakan REST API Azure OpenAI untuk menyebarkan dan menggunakan GPT-4 Turbo dengan model Visi.

Prasyarat

Langganan Azure. Buat akun gratis.
Python 3.8 atau versi yang lebih baru.
Pustaka Python berikut: requests, json.
Sumber daya Azure OpenAI Service dengan GPT-4 Turbo dengan model Vision disebarkan. Lihat ketersediaan model Pratinjau GPT-4 dan GPT-4 Turbo untuk wilayah yang tersedia. Untuk informasi selengkapnya tentang pembuatan sumber daya, lihat panduan penyebaran sumber daya.

Catatan

Saat ini tidak didukung untuk menonaktifkan pemfilteran konten untuk GPT-4 Turbo dengan model Visi.

Mengambil kunci dan titik akhir

Agar berhasil memanggil API Azure OpenAI, Anda memerlukan informasi berikut tentang sumber daya Azure OpenAI Anda:

Variabel	Nama	Nilai
Endpoint	`api_base`	Nilai titik akhir terletak di bawah Kunci dan Titik Akhir untuk sumber daya Anda di portal Azure. Anda juga dapat menemukan titik akhir melalui halaman Penyebaran di Azure AI Studio. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
Kunci	`api_key`	Nilai kunci juga terletak di bawah Kunci dan Titik Akhir untuk sumber daya Anda di portal Azure. Azure menghasilkan dua kunci untuk sumber daya Anda. Anda dapat menggunakan salah satu nilai.

Buka sumber daya Anda di portal Azure. Pada panel navigasi, pilih Kunci dan Titik Akhir di bawah Manajemen Sumber Daya. Salin nilai Titik akhir dan nilai kunci akses. Anda dapat menggunakan nilai KEY 1 atau KEY 2 . Memiliki dua kunci memungkinkan Anda memutar dan meregenerasi kunci dengan aman tanpa menyebabkan gangguan layanan.

Membuat aplikasi Python baru

Buat file Python baru bernama quickstart.py. Buka file baru di editor atau IDE pilihan Anda.

Ganti konten quickstart.py dengan kode berikut.

# 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)

Lakukan perubahan berikut:
1. Masukkan URL dan kunci titik akhir Anda di bidang yang sesuai.
2. Masukkan GPT-4 Turbo Anda dengan nama penyebaran Visi di bidang yang sesuai.
3. Ubah nilai "image" bidang menjadi URL gambar Anda.
  
  Tip
  
  Anda juga dapat menggunakan data gambar dasar 64 yang dikodekan alih-alih URL. Untuk informasi selengkapnya, lihat panduan cara penggunaan GPT-4 Turbo with Vision.
Jalankan aplikasi dengan python perintah:
```
python quickstart.py
```

Membersihkan sumber daya

Gunakan artikel ini untuk mulai menggunakan Azure OpenAI Python SDK untuk menyebarkan dan menggunakan GPT-4 Turbo dengan model Visi.

Kode sumber pustaka | Paket (PyPi) |

Prasyarat

Langganan Azure. Buat akun gratis.
Python 3.8 atau versi yang lebih baru.
Pustaka Python berikut: os
Sumber daya Azure OpenAI Service dengan GPT-4 Turbo dengan model Vision disebarkan. Lihat ketersediaan model Pratinjau GPT-4 dan GPT-4 Turbo untuk wilayah yang tersedia. Untuk informasi selengkapnya tentang pembuatan sumber daya, lihat panduan penyebaran sumber daya.

Penyiapan

Instal pustaka klien OpenAI Python dengan:

pip install openai

Catatan

Pustaka ini dikelola oleh OpenAI. Lihat riwayat rilis untuk melacak pembaruan terbaru ke pustaka.

Mengambil kunci dan titik akhir

Agar berhasil melakukan panggilan terhadap Azure OpenAI, Anda memerlukan titik akhir dan kunci.

Nama variabel	Nilai
`ENDPOINT`	Titik akhir layanan dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Azure. Atau, Anda dapat menemukan titik akhir melalui halaman Penyebaran di Azure AI Studio. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
`API-KEY`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Anda dapat menggunakan `KEY1` atau `KEY2`.

Buka sumber daya Anda di portal Azure. Bagian Kunci & Titik Akhir dapat ditemukan di bagian Manajemen Sumber Daya. Salin titik akhir dan kunci akses Anda karena keduanya diperlukan untuk mengautentikasi panggilan API Anda. Anda dapat menggunakan KEY1 atau KEY2. Selalu miliki dua kunci untuk memungkinkan Anda memutar dan meregenerasi kunci dengan aman tanpa menyebabkan gangguan layanan.

Variabel lingkungan

Buat dan tetapkan variabel lingkungan persisten untuk kunci dan titik akhir Anda.

Penting

Jika Anda menggunakan kunci API, simpan dengan aman di tempat lain, seperti di Azure Key Vault. Jangan sertakan kunci API langsung dalam kode Anda, dan jangan pernah mempostingnya secara publik.

Untuk informasi selengkapnya tentang keamanan layanan AI, lihat Mengautentikasi permintaan ke layanan Azure AI.

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')

export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE"
export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE"

Membuat aplikasi Python baru

Buat file Python baru bernama quickstart.py. Buka file baru di editor atau IDE pilihan Anda.

Ganti konten quickstart.py dengan kode berikut.

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)

Lakukan perubahan berikut:
1. Masukkan nama GPT-4 Turbo Anda dengan penyebaran Visi di bidang yang sesuai.
2. Ubah nilai "url" bidang menjadi URL gambar Anda.
  
  Tip
  
  Anda juga dapat menggunakan data gambar dasar 64 yang dikodekan alih-alih URL. Untuk informasi selengkapnya, lihat panduan cara penggunaan GPT-4 Turbo with Vision.
Jalankan aplikasi dengan python perintah:
```
python quickstart.py
```

Membersihkan sumber daya

Gunakan artikel ini untuk mulai menggunakan OpenAI JavaScript SDK untuk menyebarkan dan menggunakan GPT-4 Turbo dengan model Visi.

SDK ini disediakan oleh OpenAI dengan jenis spesifik Azure yang disediakan oleh Azure.

Dokumentasi referensi | Kode sumber pustaka | Paket (npm) | Sampel

Prasyarat

Langganan Azure - buat langganan gratis
Versi LTS dari Node.js
Azure CLI yang digunakan untuk autentikasi tanpa kata sandi di lingkungan pengembangan lokal, buat konteks yang diperlukan dengan masuk dengan Azure CLI.
Sumber daya Azure OpenAI yang dibuat di wilayah yang didukung (lihat Ketersediaan wilayah). Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Catatan

Pustaka ini dikelola oleh OpenAI. Lihat riwayat rilis untuk melacak pembaruan terbaru ke pustaka.

Mengambil kunci dan titik akhir

Agar berhasil melakukan panggilan terhadap Azure OpenAI, Anda memerlukan titik akhir dan kunci.

Nama variabel	Nilai
`ENDPOINT`	Titik akhir layanan dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Azure. Atau, Anda dapat menemukan titik akhir melalui halaman Penyebaran di Azure AI Studio. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
`API-KEY`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Anda dapat menggunakan `KEY1` atau `KEY2`.

Variabel lingkungan

Buat dan tetapkan variabel lingkungan persisten untuk kunci dan titik akhir Anda.

Penting

Jika Anda menggunakan kunci API, simpan dengan aman di tempat lain, seperti di Azure Key Vault. Jangan sertakan kunci API langsung dalam kode Anda, dan jangan pernah mempostingnya secara publik.

Untuk informasi selengkapnya tentang keamanan layanan AI, lihat Mengautentikasi permintaan ke layanan Azure AI.

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')

export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE"
export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE"

Membuat aplikasi Node

Di jendela konsol (seperti cmd, PowerShell, atau Bash), buat direktori baru untuk aplikasi Anda, dan buka direktori tersebut. Kemudian jalankan npm init perintah untuk membuat aplikasi simpul dengan file package.json .

npm init

Memasang pustaka klien

Instal pustaka klien dengan:

npm install openai @azure/identity

File package.json aplikasi Anda akan diperbarui dengan dependensi.

Membuat aplikasi JavaScript baru untuk perintah gambar

Pilih gambar dari azure-samples/cognitive-services-sample-data-files dan atur URL untuk gambar dalam variabel lingkungan.

Microsoft Entra ID
Kunci API

Ganti konten quickstart.js dengan kode berikut.

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);
});

Lakukan perubahan berikut:
1. Masukkan nama GPT-4 Turbo Anda dengan penyebaran Visi di bidang yang sesuai.
2. Ubah nilai "url" bidang menjadi URL gambar Anda.
  
  Tip
  
  Anda juga dapat menggunakan data gambar dasar 64 yang dikodekan alih-alih URL. Untuk informasi selengkapnya, lihat panduan cara penggunaan GPT-4 Turbo with Vision.
Jalankan aplikasi menggunakan perintah berikut:
```
node quickstart.js
```

Ganti konten quickstart.js dengan kode berikut.

const { AzureOpenAI } = require("openai");

// You will need to set these environment variables or edit the following values
const endpoint = process.env["AZURE_OPENAI_ENDPOINT"] || "<endpoint>";
const apiKey = process.env["AZURE_OPENAI_API_KEY"] || "<api key>";
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";

function getClient() {
  return new AzureOpenAI({
    endpoint,
    apiKey,
    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);
});

Lakukan perubahan berikut:
1. Masukkan nama GPT-4 Turbo Anda dengan penyebaran Visi di bidang yang sesuai.
2. Ubah nilai "url" bidang menjadi URL gambar Anda.
  
  Tip
  
  Anda juga dapat menggunakan data gambar dasar 64 yang dikodekan alih-alih URL. Untuk informasi selengkapnya, lihat panduan cara penggunaan GPT-4 Turbo with Vision.
Jalankan aplikasi menggunakan perintah berikut:
```
node quickstart.js
```

Membersihkan sumber daya

Gunakan artikel ini untuk mulai menggunakan OpenAI JavaScript SDK untuk menyebarkan dan menggunakan GPT-4 Turbo dengan model Visi.

SDK ini disediakan oleh OpenAI dengan jenis spesifik Azure yang disediakan oleh Azure.

Dokumentasi referensi | Kode sumber pustaka | Paket (npm) | Sampel

Prasyarat

Langganan Azure - buat langganan gratis
Versi LTS dari Node.js
TypeScript
Azure CLI yang digunakan untuk autentikasi tanpa kata sandi di lingkungan pengembangan lokal, buat konteks yang diperlukan dengan masuk dengan Azure CLI.
Sumber daya Azure OpenAI yang dibuat di wilayah yang didukung (lihat Ketersediaan wilayah). Untuk informasi selengkapnya, lihat Membuat sumber daya dan menyebarkan model dengan Azure OpenAI.

Catatan

Pustaka ini dikelola oleh OpenAI. Lihat riwayat rilis untuk melacak pembaruan terbaru ke pustaka.

Mengambil kunci dan titik akhir

Agar berhasil melakukan panggilan terhadap Azure OpenAI, Anda memerlukan titik akhir dan kunci.

Nama variabel	Nilai
`ENDPOINT`	Titik akhir layanan dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Azure. Atau, Anda dapat menemukan titik akhir melalui halaman Penyebaran di Azure AI Studio. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
`API-KEY`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Anda dapat menggunakan `KEY1` atau `KEY2`.

Variabel lingkungan

Buat dan tetapkan variabel lingkungan persisten untuk kunci dan titik akhir Anda.

Penting

Jika Anda menggunakan kunci API, simpan dengan aman di tempat lain, seperti di Azure Key Vault. Jangan sertakan kunci API langsung dalam kode Anda, dan jangan pernah mempostingnya secara publik.

Untuk informasi selengkapnya tentang keamanan layanan AI, lihat Mengautentikasi permintaan ke layanan Azure AI.

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')

export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE"
export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE"

Membuat aplikasi Node

npm init

Memasang pustaka klien

Instal pustaka klien dengan:

npm install openai @azure/identity

File package.json aplikasi Anda akan diperbarui dengan dependensi.

Membuat aplikasi JavaScript baru untuk perintah gambar

Pilih gambar dari azure-samples/cognitive-services-sample-data-files dan atur URL untuk gambar dalam variabel lingkungan.

Microsoft Entra ID
Kunci API

Buat quickstart.ts dan tempelkan kode berikut.

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);
});

Lakukan perubahan berikut:
1. Masukkan nama GPT-4 Turbo Anda dengan penyebaran Visi di bidang yang sesuai.
2. Ubah nilai "url" bidang menjadi URL gambar Anda.
  
  Tip
  
  Anda juga dapat menggunakan data gambar dasar 64 yang dikodekan alih-alih URL. Untuk informasi selengkapnya, lihat panduan cara penggunaan GPT-4 Turbo with Vision.
Bangun aplikasi dengan perintah berikut:
```
tsc
```
Jalankan aplikasi menggunakan perintah berikut:
```
node quickstart.js
```

Buat quickstart.ts dan tempelkan kode berikut.

import { AzureOpenAI } from "openai";
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 apiKey = process.env["AZURE_OPENAI_API_KEY"] || "<api key>";
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";

function getClient(): AzureOpenAI {
  return new AzureOpenAI({
    endpoint,
    apiKey,
    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);
});

Lakukan perubahan berikut:
1. Masukkan nama GPT-4 Turbo Anda dengan penyebaran Visi di bidang yang sesuai.
2. Ubah nilai "url" bidang menjadi URL gambar Anda.
  
  Tip
  
  Anda juga dapat menggunakan data gambar dasar 64 yang dikodekan alih-alih URL. Untuk informasi selengkapnya, lihat panduan cara penggunaan GPT-4 Turbo with Vision.
Bangun aplikasi dengan perintah berikut:
```
tsc
```
Jalankan aplikasi menggunakan perintah berikut:
```
node quickstart.js
```

Membersihkan sumber daya

Gunakan artikel ini untuk mulai menggunakan Azure OpenAI .NET SDK untuk menyebarkan dan menggunakan GPT-4 Turbo dengan model Visi.

Prasyarat

Langganan Azure. Anda dapat membuatnya secara gratis.
The .NET 8.0 SDK
Sumber daya Azure OpenAI Service dengan GPT-4 Turbo dengan model Vision disebarkan. Lihat ketersediaan model Pratinjau GPT-4 dan GPT-4 Turbo untuk wilayah yang tersedia. Untuk informasi selengkapnya tentang pembuatan sumber daya, lihat panduan penyebaran sumber daya.

Penyiapan

Mengambil kunci dan titik akhir

Agar berhasil melakukan panggilan terhadap Azure OpenAI, Anda memerlukan titik akhir dan kunci.

Nama variabel	Nilai
`AZURE_OPENAI_ENDPOINT`	Titik akhir layanan dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Azure. Atau, Anda dapat menemukan titik akhir melalui halaman Penyebaran di Azure AI Studio. Contoh titik akhir adalah: `https://docs-test-001.openai.azure.com/`.
`AZURE_OPENAI_API_KEY`	Nilai ini dapat ditemukan di bagian Kunci & Titik Akhir saat memeriksa sumber daya Anda dari portal Microsoft Azure. Anda dapat menggunakan `KEY1` atau `KEY2`.

Buka sumber daya Anda di portal Azure. Titik Akhir dan Kunci dapat ditemukan di bagian Manajemen Sumber Daya. Salin titik akhir dan kunci akses Anda karena Anda memerlukan keduanya untuk mengautentikasi panggilan API Anda. Anda dapat menggunakan KEY1 atau KEY2. Selalu miliki dua kunci untuk memungkinkan Anda memutar dan meregenerasi kunci dengan aman tanpa menyebabkan gangguan layanan.

Membuat aplikasi .NET

Buat aplikasi .NET menggunakan dotnet new perintah :
```
dotnet new console -n OpenAISpeech
```
Ubah ke direktori aplikasi baru:
```
cd OpenAISpeech
```

Memasang pustaka klien

Azure.OpenAI Instal pustaka klien:

dotnet add package Azure.AI.OpenAI

Autentikasi tanpa kata sandi disarankan

Autentikasi tanpa kata sandi lebih aman daripada alternatif berbasis kunci dan merupakan pendekatan yang direkomendasikan untuk menyambungkan ke layanan Azure. Jika Anda memilih untuk menggunakan autentikasi Tanpa Kata Sandi, Anda harus menyelesaikan hal berikut:

Tambahkan paket Azure.Identity.
```
dotnet add package Azure.Identity
```
Tetapkan peran ke Cognitive Services User akun pengguna Anda. Ini dapat dilakukan di portal Azure pada sumber daya OpenAI Anda di bawah Kontrol akses (IAM)>Tambahkan penetapan peran.
Masuk ke Azure menggunakan Visual Studio atau Azure CLI melalui az login.

Memperbarui kode aplikasi

Ganti konten program.cs dengan kode berikut dan perbarui nilai tempat penampung dengan nilai Anda sendiri.

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}");

Penting

Untuk produksi, simpan, dan akses kredensial Anda menggunakan metode aman, seperti Azure Key Vault. Untuk informasi selengkapnya tentang keamanan kredensial, lihat Keamanan layanan Azure AI.

Jalankan aplikasi menggunakan dotnet run perintah atau tombol jalankan di bagian atas Visual Studio:
```
dotnet run
```

Aplikasi ini menghasilkan file audio di lokasi yang Anda tentukan untuk variabel tersebut speechFilePath . Putar file di perangkat Anda untuk mendengar audio yang dihasilkan.

Membersihkan sumber daya

Langkah berikutnya

Pelajari selengkapnya tentang API ini di GPT-4 Turbo dengan panduan cara Visi
GPT-4 Turbo dengan tanya jawab umum tentang Visi
GPT-4 Turbo dengan referensi Vision API

Bagikan melalui

Mulai cepat: Menggunakan gambar di obrolan AI Anda

Prasyarat

Buka Azure OpenAI Studio

Playground

Memulai sesi obrolan untuk menganalisis gambar atau video

Membersihkan sumber daya

Prasyarat

Mengambil kunci dan titik akhir

Membuat aplikasi Python baru

Membersihkan sumber daya

Prasyarat

Penyiapan

Mengambil kunci dan titik akhir

Variabel lingkungan

Membuat aplikasi Python baru

Membersihkan sumber daya

Prasyarat

Mengambil kunci dan titik akhir

Variabel lingkungan

Membuat aplikasi Node

Memasang pustaka klien

Membuat aplikasi JavaScript baru untuk perintah gambar

Membersihkan sumber daya

Prasyarat

Mengambil kunci dan titik akhir

Variabel lingkungan

Membuat aplikasi Node

Memasang pustaka klien

Membuat aplikasi JavaScript baru untuk perintah gambar

Membersihkan sumber daya

Prasyarat

Penyiapan

Mengambil kunci dan titik akhir

Membuat aplikasi .NET

Memasang pustaka klien

Autentikasi tanpa kata sandi disarankan

Memperbarui kode aplikasi

Membersihkan sumber daya

Langkah berikutnya

Saran dan Komentar

Sumber Daya Tambahan: