Azure referensi REST API gambar dan audio OpenAI (pratinjau 2025-04-01)

Artikel ini mencakup operasi REST API inferensi sarana data pembuatan gambar dan audio (ucapan) untuk Azure OpenAI dalam 2025-04-01-preview rilis. Untuk penyelesaian obrolan, penyematan, asisten, respons, penyimpanan vektor, dan semua operasi lainnya, lihat referensi resmi Azure OpenAI REST API.

Spesifikasi API

Mengelola dan berinteraksi dengan model dan sumber daya Azure OpenAI dibagi menjadi tiga permukaan API utama:

  • Pesawat Kontrol
  • Bidang data - penulisan
  • Bidang data - inferensi

Setiap permukaan/spesifikasi API merangkum serangkaian kemampuan Azure OpenAI yang berbeda. Setiap API memiliki serangkaian rilis API pratinjau dan stabil/tersedia umum (GA) yang unik. Rilis pratinjau saat ini cenderung mengikuti irama bulanan.

Important

Sekarang ada API inferensi pratinjau baru. Pelajari lebih lanjut di panduan siklus hidup API kami.

API Rilis pratinjau terbaru Rilis GA terbaru Specifications Description
Pesawat kontrol 2025-07-01-preview 2025-06-01 File spesifikasi teknis API sarana kontrol digunakan untuk operasi seperti membuat sumber daya, penyebaran model, dan tugas manajemen sumber daya tingkat tinggi lainnya. Sarana kontrol juga mengatur apa yang mungkin dilakukan dengan kemampuan seperti Azure Resource Manager, Bicep, Terraform, dan Azure CLI.
Bidang data v1 preview v1 File spesifikasi teknis API bidang data mengontrol operasi inferensi dan penurunan.

Authentication

Azure OpenAI menyediakan dua metode untuk autentikasi. Anda dapat menggunakan Kunci API atau Microsoft Entra ID.

  • Autentikasi Kunci API: Untuk jenis autentikasi ini, semua permintaan API harus menyertakan Kunci API di api-key header HTTP. Mulai Cepat memberikan panduan tentang cara melakukan panggilan dengan jenis autentikasi ini.

  • Microsoft Entra ID autentikasi: Anda dapat mengautentikasi panggilan API menggunakan token Microsoft Entra. Token autentikasi disertakan dalam permintaan sebagai Authorization header. Token yang diberikan harus didahului oleh Bearer, misalnya Bearer YOUR_AUTH_TOKEN. Anda dapat membaca panduan cara kami tentang autentikasi dengan Microsoft Entra ID.

Penerapan versi REST API

API layanan diversi menggunakan api-version parameter kueri. Semua versi mengikuti struktur tanggal YYYY-MM-DD. Contohnya:

POST https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/chat/completions?api-version=2024-06-01

Inferensi bidang data

Sisa artikel ini mencakup operasi gambar dan audio dalam 2025-04-01-preview rilis pratinjau spesifikasi inferensi bidang data OpenAI Azure.

Untuk operasi gambar dan audio GA, lihat gambar GA dan referensi REST API audio.

Transkripsi - Buat

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/transcriptions?api-version=2025-04-01-preview

Menyalin audio ke dalam bahasa input.

Parameter URI

Nama Dalam Required Tipe Description
titik akhir path Yes string URL Didukung Azure titik akhir OpenAI (protokol dan nama host, misalnya: https://aoairesource.openai.azure.com. Ganti "aoairesource" dengan nama sumber daya Azure OpenAI Anda). https://{your-resource-name}.openai.azure.com
ID penempatan path Yes string
Versi API kueri Yes string

Header Permohonan

Gunakan autentikasi berbasis token atau kunci API. Mengautentikasi dengan autentikasi berbasis token direkomendasikan dan lebih aman.

Nama Required Tipe Description
Authorization Benar string Contoh :Authorization: Bearer {Azure_OpenAI_Auth_Token}

Untuk menghasilkan token auth menggunakan Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Jenis: oauth2
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Ruang lingkup: https://ai.azure.com/.default
kunci API Benar string Berikan kunci API Azure OpenAI di sini

Badan Permintaan

Tipe Konten: multipart/form-data

Nama Tipe Description Required Default
model string ID model yang akan digunakan. Opsinya adalah gpt-4o-transcribe, gpt-4o-mini-transcribe, gpt-4o-mini-transcribe-2025-12-15, whisper-1, dan gpt-4o-transcribe-diarize. Yes
berkas string Objek file audio untuk ditranskripsikan. Yes
bahasa string Bahasa audio input. Memasok bahasa input dalam format ISO-639-1 meningkatkan akurasi dan latensi. No
minta string Teks opsional untuk memandu gaya model atau melanjutkan segmen audio sebelumnya. Perintah harus sesuai dengan bahasa audio. No
response_format audioResponseFormat Menentukan format output. No
suhu number Suhu pengambilan sampel, antara 0 dan 1. Nilai yang lebih tinggi seperti 0,8 akan membuat output lebih acak, sedangkan nilai yang lebih rendah seperti 0,2 akan membuatnya lebih fokus dan deterministik. Jika diatur ke 0, model menggunakan probabilitas log untuk secara otomatis meningkatkan suhu hingga ambang batas tertentu tercapai. No 0
timestamp_granularities[] array Granularitas stempel waktu yang akan diisi untuk transkripsi ini. response_format harus diatur verbose_json untuk menggunakan granularitas stempel waktu. Salah satu atau kedua opsi ini didukung: word, atau segment. Catatan: Tidak ada latensi tambahan untuk stempel waktu segmen, tetapi menghasilkan stempel waktu kata menimbulkan latensi tambahan. No ['segmen']

Responses

Kode Status: 200

Deskripsi: OK

Content-Type Tipe Description
application/json objek
text/plain string Teks yang ditranskripsikan dalam format output (ketika response_format adalah salah satu dari text, vtt atau srt).

Examples

Example

Mendapatkan teks yang ditranskripsi dan metadata terkait dari data audio lisan yang disediakan.

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/transcriptions?api-version=2025-04-01-preview

Tanggapan: Kode Status: 200

{
  "body": {
    "text": "A structured object when requesting json or verbose_json"
  }
}

Example

Mendapatkan teks yang ditranskripsi dan metadata terkait dari data audio lisan yang disediakan.

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/transcriptions?api-version=2025-04-01-preview

"---multipart-boundary\nContent-Disposition: form-data; name=\"file\"; filename=\"file.wav\"\nContent-Type: application/octet-stream\n\nRIFF..audio.data.omitted\n---multipart-boundary--"

Tanggapan: Kode Status: 200

{
  "type": "string",
  "example": "plain text when requesting text, srt, or vtt"
}

Terjemahan - Buat

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/translations?api-version=2025-04-01-preview

Mentranskripsikan dan menerjemahkan audio input ke dalam teks bahasa Inggris.

Parameter URI

Nama Dalam Required Tipe Description
titik akhir path Yes string URL Didukung Azure titik akhir OpenAI (protokol dan nama host, misalnya: https://aoairesource.openai.azure.com. Ganti "aoairesource" dengan nama sumber daya Azure OpenAI Anda). https://{your-resource-name}.openai.azure.com
ID penempatan path Yes string
Versi API kueri Yes string

Header Permohonan

Gunakan autentikasi berbasis token atau kunci API. Mengautentikasi dengan autentikasi berbasis token direkomendasikan dan lebih aman.

Nama Required Tipe Description
Authorization Benar string Contoh :Authorization: Bearer {Azure_OpenAI_Auth_Token}

Untuk menghasilkan token auth menggunakan Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Jenis: oauth2
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Ruang lingkup: https://ai.azure.com/.default
kunci API Benar string Berikan kunci API Azure OpenAI di sini

Badan Permintaan

Tipe Konten: multipart/form-data

Nama Tipe Description Required Default
berkas string File audio yang akan diterjemahkan. Yes
minta string Teks opsional untuk memandu gaya model atau melanjutkan segmen audio sebelumnya. Prompt harus dalam bahasa Inggris. No
response_format audioResponseFormat Menentukan format output. No
suhu number Suhu pengambilan sampel, antara 0 dan 1. Nilai yang lebih tinggi seperti 0,8 akan membuat output lebih acak, sedangkan nilai yang lebih rendah seperti 0,2 akan membuatnya lebih fokus dan deterministik. Jika diatur ke 0, model menggunakan probabilitas log untuk secara otomatis meningkatkan suhu hingga ambang batas tertentu tercapai. No 0

Responses

Kode Status: 200

Deskripsi: OK

Content-Type Tipe Description
application/json objek
text/plain string Teks yang ditranskripsikan dalam format output (ketika response_format adalah salah satu teks, vtt, atau srt).

Examples

Example

Mendapatkan teks yang ditranskripsi dalam bahasa Inggris dan metadata terkait dari data audio lisan yang disediakan.

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/translations?api-version=2025-04-01-preview

"---multipart-boundary\nContent-Disposition: form-data; name=\"file\"; filename=\"file.wav\"\nContent-Type: application/octet-stream\n\nRIFF..audio.data.omitted\n---multipart-boundary--"

Tanggapan: Kode Status: 200

{
  "body": {
    "text": "A structured object when requesting json or verbose_json"
  }
}

Example

Mendapatkan teks yang ditranskripsi dalam bahasa Inggris dan metadata terkait dari data audio lisan yang disediakan.

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/translations?api-version=2025-04-01-preview

"---multipart-boundary\nContent-Disposition: form-data; name=\"file\"; filename=\"file.wav\"\nContent-Type: application/octet-stream\n\nRIFF..audio.data.omitted\n---multipart-boundary--"

Tanggapan: Kode Status: 200

{
  "type": "string",
  "example": "plain text when requesting text, srt, or vtt"
}

Pidato - Buat

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/speech?api-version=2025-04-01-preview

Menghasilkan audio dari teks input.

Parameter URI

Nama Dalam Required Tipe Description
titik akhir path Yes string URL Didukung Azure titik akhir OpenAI (protokol dan nama host, misalnya: https://aoairesource.openai.azure.com. Ganti "aoairesource" dengan nama sumber daya Azure OpenAI Anda). https://{your-resource-name}.openai.azure.com
ID penempatan path Yes string
Versi API kueri Yes string

Header Permohonan

Gunakan autentikasi berbasis token atau kunci API. Mengautentikasi dengan autentikasi berbasis token direkomendasikan dan lebih aman.

Nama Required Tipe Description
Authorization Benar string Contoh :Authorization: Bearer {Azure_OpenAI_Auth_Token}

Untuk menghasilkan token auth menggunakan Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Jenis: oauth2
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Ruang lingkup: https://ai.azure.com/.default
kunci API Benar string Berikan kunci API Azure OpenAI di sini

Badan Permintaan

Tipe Konten: multipart/form-data

Nama Tipe Description Required Default
input string Teks untuk mensintesis audio. Panjang maksimum adalah 4.096 karakter. Yes
response_format enum Format untuk mensintesis audio.
Nilai yang memungkinkan: mp3, , opus, aacflac, wav, ,pcm		 No
Kecepatan number Kecepatan audio yang disintesis. Pilih nilai dari 0.25 ke 4.0. 1.0 adalah default. No 1.0
voice enum Suara yang akan digunakan untuk sintesis ucapan.
Nilai yang memungkinkan: alloy, , echo, fableonyx, nova, ,shimmer		 Yes

Responses

Kode Status: 200

Deskripsi: OK

Content-Type Tipe Description
application/octet-stream string

Examples

Example

Mensintesis audio dari teks yang disediakan.

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/speech?api-version=2025-04-01-preview

{
 "input": "Hi! What are you going to make?",
 "voice": "fable",
 "response_format": "mp3"
}

Tanggapan: Kode Status: 200

{
  "body": "101010101"
}

Pembuatan gambar - Buat

POST https://{endpoint}/openai/deployments/{deployment-id}/images/generations?api-version=2025-04-01-preview

Menghasilkan kumpulan gambar dari keterangan teks pada penyebaran model pembuatan gambar tertentu

Parameter URI

Nama Dalam Required Tipe Description
titik akhir path Yes string URL Didukung Azure titik akhir OpenAI (protokol dan nama host, misalnya: https://aoairesource.openai.azure.com. Ganti "aoairesource" dengan nama sumber daya Azure OpenAI Anda). https://{your-resource-name}.openai.azure.com
ID penempatan path Yes string
Versi API kueri Yes string

Header Permohonan

Gunakan autentikasi berbasis token atau kunci API. Mengautentikasi dengan autentikasi berbasis token direkomendasikan dan lebih aman.

Nama Required Tipe Description
Authorization Benar string Contoh :Authorization: Bearer {Azure_OpenAI_Auth_Token}

Untuk menghasilkan token auth menggunakan Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Jenis: oauth2
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Ruang lingkup: https://ai.azure.com/.default
kunci API Benar string Berikan kunci API Azure OpenAI di sini

Badan Permintaan

Content-Type: application/json

Nama Tipe Description Required Default
latar belakang imageBackground Memungkinkan untuk mengatur transparansi untuk latar belakang gambar yang dihasilkan. Parameter ini hanya didukung untuk model seri gpt-image-1. No auto
n integer Jumlah gambar yang akan dihasilkan. Untuk dall-e-3, hanya n=1 yang didukung. No 1
kompresi keluaran integer Tingkat kompresi (0-100%) untuk gambar yang dihasilkan. Parameter ini hanya didukung untuk model seri gpt-image-1 dengan format output jpeg. No 100
format keluaran imagesOutputFormat Format file tempat gambar yang dihasilkan dikembalikan. Hanya didukung untuk model seri gpt-image-1. No png
minta string Deskripsi teks dari gambar yang diinginkan. Panjang maksimum adalah 32000 karakter untuk seri gpt-image-1 dan 4000 karakter untuk dall-e-3 Yes
gambar sebagian integer Jumlah gambar parsial yang akan dihasilkan. Parameter ini digunakan untuk respons streaming yang mengembalikan gambar parsial. Nilai harus antara 0 dan 3. Saat diatur ke 0, respons akan menjadi satu gambar yang dikirim dalam satu peristiwa streaming. Perhatikan bahwa gambar akhir dapat dikirim sebelum jumlah penuh gambar parsial dihasilkan jika gambar lengkap dihasilkan lebih cepat. 0
aliran Boolean Edit gambar dalam mode streaming. no false
kualitas imageQuality Kualitas gambar yang akan dihasilkan. No auto
response_format imagesResponseFormat Format di mana gambar yang dihasilkan dikembalikan. Parameter ini tidak didukung untuk gpt-image-1model -series yang akan selalu mengembalikan gambar yang dikodekan base64.
Nilai yang mungkin: url, b64_json.		 No Url
size imageSize Ukuran gambar yang dihasilkan. No auto
gaya imageStyle Gaya gambar yang dihasilkan. Hanya didukung untuk dall-e-3. No Jelas
pengguna string Pengidentifikasi unik yang mewakili pengguna akhir Anda, yang dapat membantu memantau dan mendeteksi penyalahgunaan. No

Responses

Kode Status: 200

Deskripsi: Ok

Content-Type Tipe Description
application/json generateImagesResponse

Kode Status: default

Deskripsi: Terjadi kesalahan.

Content-Type Tipe Description
application/json dalleErrorResponse

Examples

Example

Membuat gambar yang diberi perintah.

POST https://{endpoint}/openai/deployments/{deployment-id}/images/generations?api-version=2025-04-01-preview

{
 "prompt": "In the style of WordArt, Microsoft Clippy wearing a cowboy hat.",
 "n": 1,
 "style": "natural",
 "quality": "standard"
}

Tanggapan: Kode Status: 200

{
  "body": {
    "created": 1698342300,
    "data": [
      {
        "revised_prompt": "A vivid, natural representation of Microsoft Clippy wearing a cowboy hat.",
        "prompt_filter_results": {
          "sexual": {
            "severity": "safe",
            "filtered": false
          },
          "violence": {
            "severity": "safe",
            "filtered": false
          },
          "hate": {
            "severity": "safe",
            "filtered": false
          },
          "self_harm": {
            "severity": "safe",
            "filtered": false
          },
          "profanity": {
            "detected": false,
            "filtered": false
          },
          "custom_blocklists": {
            "filtered": false,
            "details": []
          }
        },
        "url": "https://dalletipusw2.blob.core.windows.net/private/images/e5451cc6-b1ad-4747-bd46-b89a3a3b8bc3/generated_00.png?se=2023-10-27T17%3A45%3A09Z&...",
        "content_filter_results": {
          "sexual": {
            "severity": "safe",
            "filtered": false
          },
          "violence": {
            "severity": "safe",
            "filtered": false
          },
          "hate": {
            "severity": "safe",
            "filtered": false
          },
          "self_harm": {
            "severity": "safe",
            "filtered": false
          }
        }
      }
    ]
  }
}

Pembuatan gambar - Sunting

POST https://{endpoint}/openai/deployments/{deployment-id}/images/edits?api-version=2025-04-01-preview

Mengedit gambar dari keterangan teks pada penyebaran model gpt-image-1 tertentu

Parameter URI

Nama Dalam Required Tipe Description
titik akhir path Yes string URL Didukung Azure titik akhir OpenAI (protokol dan nama host, misalnya: https://aoairesource.openai.azure.com. Ganti "aoairesource" dengan nama sumber daya Azure OpenAI Anda). https://{your-resource-name}.openai.azure.com
ID penempatan path Yes string
Versi API kueri Yes string

Header Permohonan

Gunakan autentikasi berbasis token atau kunci API. Mengautentikasi dengan autentikasi berbasis token direkomendasikan dan lebih aman.

Nama Required Tipe Description
Authorization Benar string Contoh :Authorization: Bearer {Azure_OpenAI_Auth_Token}

Untuk menghasilkan token auth menggunakan Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Jenis: oauth2
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Ruang lingkup: https://ai.azure.com/.default
kunci API Benar string Berikan kunci API Azure OpenAI di sini

Badan Permintaan

Tipe Konten: multipart/form-data

Nama Tipe Description Required Default
citra string atau array Gambar yang akan diedit. Harus berupa file gambar yang didukung atau array gambar. Setiap gambar harus berupa file png, atau jpg kurang dari 50MB. Yes
input_fidelity string Kontrol seberapa banyak upaya yang akan dilakukan model untuk mencocokkan gaya dan fitur, terutama fitur wajah, dari gambar input. Parameter ini hanya didukung untuk model seri gpt-image-1. Mendukung high dan low. no low.
masker string Gambar tambahan yang area yang sepenuhnya transparan (misalnya, di mana alfa adalah nol) menunjukkan di mana gambar harus diedit. Jika ada beberapa gambar yang disediakan, topeng akan diterapkan ke gambar pertama. Harus berupa file PNG yang valid, kurang dari 4MB, dan memiliki dimensi yang sama dengan gambar. No
n integer Jumlah gambar yang akan dihasilkan. Harus antara 1 dan 10. No 1
minta string Deskripsi teks dari gambar yang diinginkan. Panjang maksimum adalah 32000 karakter. Yes
kualitas imageQuality Kualitas gambar yang akan dihasilkan. No auto
gambar sebagian Jumlah gambar parsial yang akan dihasilkan. Parameter ini digunakan untuk respons streaming yang mengembalikan gambar parsial. Nilai harus antara 0 dan 3. Saat diatur ke 0, respons akan menjadi satu gambar yang dikirim dalam satu peristiwa streaming. Perhatikan bahwa gambar akhir dapat dikirim sebelum jumlah penuh gambar parsial dihasilkan jika gambar lengkap dihasilkan lebih cepat.
aliran Boolean Edit gambar dalam mode streaming. no false
response_format imagesResponseFormat Format di mana gambar yang dihasilkan dikembalikan. No Url
size imageSize Ukuran gambar yang dihasilkan. No auto
pengguna string Pengidentifikasi unik yang mewakili pengguna akhir Anda, yang dapat membantu memantau dan mendeteksi penyalahgunaan. No

Responses

Kode Status: 200

Deskripsi: Ok

Content-Type Tipe Description
application/json generateImagesResponse

Kode Status: default

Deskripsi: Terjadi kesalahan.

Content-Type Tipe Description
application/json dalleErrorResponse

Components

Untuk definisi skema yang digunakan oleh obrolan, penyelesaian, penyematan, respons, dan operasi teks lainnya, lihat referensi Azure OpenAI REST API. Skema berikut mendukung operasi gambar dan audio di halaman ini.

innerErrorCode

Kode kesalahan untuk objek kesalahan dalam.

Property Nilai
Description Kode kesalahan untuk objek kesalahan dalam.
Tipe string
Nilai ResponsibleAIPolicyViolation

dalleErrorResponse

Nama Tipe Description Required Default
galat dalleError No

dalleError

Nama Tipe Description Required Default
inner_error dalleInnerError Kesalahan batin dengan detail tambahan. No
param string No
jenis string No

dalleInnerError

Kesalahan batin dengan detail tambahan.

Nama Tipe Description Required Default
kode innerErrorCode Kode kesalahan untuk objek kesalahan dalam. No
content_filter_results dalleFilterResults Informasi tentang kategori pemfilteran konten (kebencian, seksual, kekerasan, self_harm), apakah telah terdeteksi, serta tingkat keparahan (skala very_low, rendah, sedang, tinggi yang menentukan intensitas dan tingkat risiko konten berbahaya) dan apakah telah disaring atau belum. Informasi tentang konten jailbreak dan kata-kata kotor, apakah sudah terdeteksi, dan apakah sudah disaring atau belum. Dan informasi tentang daftar blokir pelanggan, jika sudah disaring dan id-nya. No
petunjuk_direvisi string Prompt yang digunakan untuk menghasilkan gambar, jika ada revisi pada prompt. No

HasilTingkatKeparahanPenyaringanKonten

Nama Tipe Description Required Default
filtered Boolean Yes
severity string No

Hasil Deteksi Penyaringan Konten

Nama Tipe Description Required Default
detected Boolean No
filtered Boolean Yes

contentFilterDetailedResults

Hasil pemfilteran konten dengan detail id filter konten untuk segmen yang difilter.

Nama Tipe Description Required Default
Rincian array No
filtered Boolean Yes

dalleFilterResults

Informasi tentang kategori pemfilteran konten (kebencian, seksual, kekerasan, self_harm), apakah telah terdeteksi, serta tingkat keparahan (skala very_low, rendah, sedang, tinggi yang menentukan intensitas dan tingkat risiko konten berbahaya) dan apakah telah disaring atau belum. Informasi tentang konten jailbreak dan kata-kata kotor, apakah sudah terdeteksi, dan apakah sudah disaring atau belum. Dan informasi tentang daftar blokir pelanggan, jika sudah disaring dan id-nya.

Nama Tipe Description Required Default
custom_blocklists contentFilterDetailedResults Hasil pemfilteran konten dengan detail id filter konten untuk segmen yang difilter. No
hate hasil tingkat keparahan penyaring konten No
jailbreak contentFilterDetectedResult No
profanity contentFilterDetectedResult No
self_harm hasil tingkat keparahan penyaring konten No
sexual hasil tingkat keparahan penyaring konten No
violence hasil tingkat keparahan penyaring konten No

audioResponseFormat

Menentukan format output.

Property Nilai
Description Menentukan format output.
Tipe string
Nilai json
text
srt
verbose_json
vtt

imageQuality

Kualitas gambar yang akan dihasilkan.

Property Nilai
Description Kualitas gambar yang akan dihasilkan.
Tipe string
Default auto
Nilai auto
high
medium
low
hd
standard

imagesResponseFormat

Format di mana gambar yang dihasilkan dikembalikan.

Property Nilai
Description Format di mana gambar yang dihasilkan dikembalikan.
Tipe string
Default Url
Nilai url
b64_json

imagesOutputFormat

Format file tempat gambar yang dihasilkan dikembalikan. Hanya didukung untuk model seri.

Property Nilai
Description Format file tempat gambar yang dihasilkan dikembalikan. Hanya didukung untuk model seri gpt-image-1.
Tipe string
Default png
Nilai png
jpeg

imageSize

Ukuran gambar yang dihasilkan.

Property Nilai
Description Ukuran gambar yang dihasilkan.
Tipe string
Default auto
Nilai auto
1792x1024
1024x1792
1024x1024
1024x1536
1536x1024

imageStyle

Gaya gambar yang dihasilkan. Hanya didukung untuk dall-e-3.

Property Nilai
Description Gaya gambar yang dihasilkan. Hanya didukung untuk dall-e-3.
Tipe string
Default Jelas
Nilai vivid
natural

imageBackground

Memungkinkan untuk mengatur transparansi untuk latar belakang gambar yang dihasilkan. Parameter ini hanya didukung untuk model seri gpt-image-1.

Property Nilai
Description Memungkinkan untuk mengatur transparansi untuk latar belakang gambar yang dihasilkan. Parameter ini hanya didukung untuk model seri gpt-image-1.
Tipe string
Default auto
Nilai transparent
opaque
auto

generateImagesResponse

Nama Tipe Description Required Default
Dibuat integer Stempel waktu unix saat operasi dibuat. Yes
data array Data hasil operasi, jika berhasil Yes
penggunaan imageGenerationsUsage Mewakili detail penggunaan token untuk permintaan pembuatan gambar. Hanya untuk model seri gpt-image-1. No

imageGenerationsUsage

Mewakili detail penggunaan token untuk permintaan pembuatan gambar. Hanya untuk model seri gpt-image-1.

Nama Tipe Description Required Default
input_tokens integer Jumlah token input. No
input_tokens_details objek Perincian terperinci dari token input. No
└─ token_gambar integer Jumlah token gambar. No
└─ text_tokens integer Jumlah token teks. No
output_tokens integer Jumlah token keluaran. No
total_tokens integer Jumlah total token yang digunakan. No

Langkah berikutnya

Pelajari tentang model dan penyempurnaan dengan REST API. Pelajari selengkapnya tentang model underlying yang mendukung Azure OpenAI.

  • Last updated on