OpenAI görüntü ve ses REST API başvurusu Azure (2025-04-01-preview)

Bu makalede, sürümdeki openAI 2025-04-01-preview Azure için görüntü oluşturma ve ses (konuşma) veri düzlemi çıkarımı REST API işlemleri belgelenmiştir. Sohbet tamamlamaları, eklemeler, yardımcılar, yanıtlar, vektör depoları ve diğer tüm işlemler için OpenAI REST API başvurusunun resmi Azure bakın.

API belirtimleri

Azure OpenAI modelleri ve kaynaklarıyla yönetmek ve etkileşim üç ana API yüzeyine bölünmüştür:

• Kontrol düzlemi
• Veri düzlemi - yazarlık
• Veri düzlemi - çıkarım

Her API yüzeyi/spesifikasyonu, farklı bir Azure OpenAI yetenekleri setini kapsar. Her API'nin kendine özgü önizleme ve kararlı/genel erişilebilir (GA) API sürümleri vardır. Şu anda ön izleme sürümleri genellikle aylık bir ritm izlemektedir.

Important

Şimdi yeni bir önizleme çıkarımı API'si var. API yaşam döngüsü rehberimizde daha fazla bilgi edinin.

API	En son önizleme sürümü	Son GA sürümü	Specifications	Description
Kontrol düzlemi	2025-07-01-preview	2025-06-01	Belirtim dosyaları	Kontrol düzlemi API, kaynak oluşturma, model dağıtımı ve diğer üst düzey kaynak yönetimi görevleri gibi işlemler için kullanılır. Kontrol düzlemi ayrıca Azure Resource Manager, Bicep, Terraform ve Azure CLI gibi yeteneklerle neler yapılabileceğini de yönetir.
Veri düzlemi	v1 preview	v1	Belirtim dosyaları	Veri düzlemi API, çıkarım ve yazarlık işlemlerini kontrol eder.

Authentication

Azure OpenAI, kimlik doğrulama için iki yöntem sunar. API Anahtarları veya Microsoft Entra ID'si kullanabilirsiniz.

• API Anahtarı Doğrulama: Bu tür kimlik doğrulama için, tüm API talepleri HTTP başlığında API Anahtarını api-key içermelidir. Quickstart, bu tür kimlik doğrulama ile aramaların nasıl yapılacağına dair rehberlik sağlar.

• Microsoft Entra ID kimlik doğrulama: Bir Microsoft Entra token kullanarak API çağrısını kimlik doğrulaması yapabilirsiniz. Kimlik doğrulama tokenları, bir talebe başlık Authorization olarak dahil edilir. Sağlanan belirteç, örneğin , ile gelmelidirBearerBearer YOUR_AUTH_TOKEN. Microsoft Entra ID<doğrulama rehberimizi okuyabilirsiniz>.

REST API sürümleme

Servis API'leri sorgu parametresi kullanılarak api-version versiyonlandırılır. Tüm sürümler YYYY-MM-DD tarih yapısını takip eder. Örneğin:

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

Veri düzlemi çıkarımı

Bu makalenin geri kalanında, Azure OpenAI veri düzlemi çıkarım belirtiminin önizleme sürümündeki görüntü ve ses işlemleri 2025-04-01-preview yer alır.

GA görüntüsü ve ses işlemleri için bkz. GA görüntüsü ve ses REST API başvurusu.

Transkripsiyonlar - Yarat

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

Sesi giriş diline aktarır.

URI Parametreleri

İsim	İçinde	Zorunlu	Türü	Description
endpoint	path	Evet	string URL	OpenAI uç noktaları Azure destekleniyor (örneğin protokol ve ana adı: https://aoairesource.openai.azure.com. "aoairesource" yerine Azure OpenAI kaynak adınızı verin). https://{your-resource-name}.openai.azure.com
dağıtım kimliği	path	Evet	string
API sürümü	soru	Evet	string

İstek Başlığı

Token tabanlı kimlik doğrulama veya API anahtarı kullanın. Token tabanlı kimlik doğrulama önerilir ve daha güvenlidir.

İsim	Zorunlu	Türü	Description
Authorization	True	string	Örnek:Authorization: Bearer {Azure_OpenAI_Auth_Token} Azure CLI kullanarak doğrulama belirteçsi oluşturmak için: az account get-access-token --resource https://cognitiveservices.azure.com Tür: oauth2 Yetkilendirme URL'si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize kapsam: https://ai.azure.com/.default
API anahtarı	True	string	Azure OpenAI API anahtarını buradan paylaşın

İstek Gövdesi

İçerik Türü: çok parçalı form-verisi

İsim	Türü	Description	Zorunlu	Varsayılan
model	string	Kullanılacak modelin kimliği. Seçenekler gpt-4o-transcribe, gpt-4o-mini-transcribe, gpt-4o-mini-transcribe-2025-12-15, whisper-1, ve gpt-4o-transcribe-diarize.	Evet
dosya	string	Ses dosyası nesnesini transkribe etmek için.	Evet
language	string	Giriş sesinin dili. Giriş dilinin ISO-639-1 formatında sağlanması, doğruluk ve gecikmeyi artırır.	No
prompt	string	Modelin stilini yönlendirmek veya önceki bir ses segmentini sürdürmek için isteğe bağlı bir metin. İstem ses diline uymalı.	No
yanıt formatı	audioResponseFormat	Çıktının formatını tanımlar.	No
sıcaklık	number	Örnekleme sıcaklığı, 0 ile 1 arasında. 0.8 gibi daha yüksek değerler çıktıyı daha rastgele yaparken, 0.2 gibi daha düşük değerler daha odaklanmış ve deterministik hale getirir. 0 olarak ayarlandığında, model belirli eşiklere ulaşana kadar sıcaklığı otomatik olarak artırmak için log olasılık kullanır.	No	0
timestamp_granularities[]	Dizi	Bu transkripsiyon için doldurulacak zaman damgası granülerlikleri. response_format zaman damgası granülerliklerini kullanacak şekilde ayarlanmalıdır verbose_json . Bu seçeneklerden biri veya her ikisi desteklenir: word, veya segment. Not: Segment zaman damgaları için ek gecikme yoktur, ancak kelime zaman damgaları oluşturmak ek gecikme sağlar.	No	['segment']

Yanıtlar

Durum Kodu: 200

Açıklama: Tamam

İçerik Türü	Türü	Tanım
uygulama/json	Obje
düz metin	string	Çıktı formatında transkribe edilmiş metin (response_format , textvttsrtveya ).

Examples

Örnek

Verilen konuşulmuş ses verilerinden transkribe metin ve ilgili meta verileri alır.

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

Yanıtlar: Durum Kodu: 200

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

Örnek

Verilen konuşulmuş ses verilerinden transkribe metin ve ilgili meta verileri alır.

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

Yanıtlar: Durum Kodu: 200

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

Çeviriler - Yarat

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

Giriş sesi İngilizce metne transkribe eder ve çevirir.

URI Parametreleri

İsim	İçinde	Zorunlu	Türü	Description
endpoint	path	Evet	string URL	OpenAI uç noktaları Azure destekleniyor (örneğin protokol ve ana adı: https://aoairesource.openai.azure.com. "aoairesource" yerine Azure OpenAI kaynak adınızı verin). https://{your-resource-name}.openai.azure.com
dağıtım kimliği	path	Evet	string
API sürümü	soru	Evet	string

İstek Başlığı

Token tabanlı kimlik doğrulama veya API anahtarı kullanın. Token tabanlı kimlik doğrulama önerilir ve daha güvenlidir.

İsim	Zorunlu	Türü	Description
Authorization	True	string	Örnek:Authorization: Bearer {Azure_OpenAI_Auth_Token} Azure CLI kullanarak doğrulama belirteçsi oluşturmak için: az account get-access-token --resource https://cognitiveservices.azure.com Tür: oauth2 Yetkilendirme URL'si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize kapsam: https://ai.azure.com/.default
API anahtarı	True	string	Azure OpenAI API anahtarını buradan paylaşın

İstek Gövdesi

İçerik Türü: çok parçalı form-verisi

İsim	Türü	Description	Zorunlu	Varsayılan
dosya	string	Çevirilmesi gereken ses dosyası.	Evet
prompt	string	Modelin stilini yönlendirmek veya önceki bir ses segmentini sürdürmek için isteğe bağlı bir metin. Yönlendirme İngilizce olmalı.	No
yanıt formatı	audioResponseFormat	Çıktının formatını tanımlar.	No
sıcaklık	number	Örnekleme sıcaklığı, 0 ile 1 arasında. 0.8 gibi daha yüksek değerler çıktıyı daha rastgele yaparken, 0.2 gibi daha düşük değerler daha odaklanmış ve deterministik hale getirir. 0 olarak ayarlandığında, model belirli eşiklere ulaşana kadar sıcaklığı otomatik olarak artırmak için log olasılık kullanır.	No	0

Yanıtlar

Durum Kodu: 200

Açıklama: Tamam

İçerik Türü	Türü	Tanım
uygulama/json	Obje
düz metin	string	Çıktı formatında transkribe edilmiş metin (response_format metin, vtt veya srt olduğunda).

Examples

Örnek

İngilizce transkribe metni ve ilgili meta verileri sağlanan konuşulan ses verilerinden alır.

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

Yanıtlar: Durum Kodu: 200

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

Örnek

İngilizce transkribe metni ve ilgili meta verileri sağlanan konuşulan ses verilerinden alır.

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

Yanıtlar: Durum Kodu: 200

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

Konuşma - Yaratma

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

Giriş metninden ses üretir.

URI Parametreleri

İsim	İçinde	Zorunlu	Türü	Description
endpoint	path	Evet	string URL	OpenAI uç noktaları Azure destekleniyor (örneğin protokol ve ana adı: https://aoairesource.openai.azure.com. "aoairesource" yerine Azure OpenAI kaynak adınızı verin). https://{your-resource-name}.openai.azure.com
dağıtım kimliği	path	Evet	string
API sürümü	soru	Evet	string

İstek Başlığı

Token tabanlı kimlik doğrulama veya API anahtarı kullanın. Token tabanlı kimlik doğrulama önerilir ve daha güvenlidir.

İsim	Zorunlu	Türü	Description
Authorization	True	string	Örnek:Authorization: Bearer {Azure_OpenAI_Auth_Token} Azure CLI kullanarak doğrulama belirteçsi oluşturmak için: az account get-access-token --resource https://cognitiveservices.azure.com Tür: oauth2 Yetkilendirme URL'si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize kapsam: https://ai.azure.com/.default
API anahtarı	True	string	Azure OpenAI API anahtarını buradan paylaşın

İstek Gövdesi

İçerik Türü: çok parçalı form-verisi

İsim	Türü	Description	Zorunlu	Varsayılan
Giriş	string	Sesi sentezlemek için metin. Maksimum uzunluk 4.096 karakterdir.	Evet
yanıt formatı	enum	Sesi sentezlemek için kullanılan format. Olası değerler: mp3, opus, aac, flacwav, ,pcm	No
speed	number	Sentezlenen sesin hızı. Bir değer seçin '0.25den 'ye.4.0 1.0 varsayılan bir durumdur.	No	1.0
voice	enum	Konuşma sentezi için kullanılan ses. Olası değerler: alloy, echo, fable, onyxnova, ,shimmer	Evet

Yanıtlar

Durum Kodu: 200

Açıklama: Tamam

İçerik Türü	Türü	Tanım
application/octet-stream	string

Examples

Örnek

Verilen metinden sesi sentezler.

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

Yanıtlar: Durum Kodu: 200

{
  "body": "101010101"
}

Görüntü üretimi - Yarat

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

Belirli bir görüntü oluşturma modeli dağıtımında metin başlığından bir dizi görüntü üretir

URI Parametreleri

İsim	İçinde	Zorunlu	Türü	Description
endpoint	path	Evet	string URL	OpenAI uç noktaları Azure destekleniyor (örneğin protokol ve ana adı: https://aoairesource.openai.azure.com. "aoairesource" yerine Azure OpenAI kaynak adınızı verin). https://{your-resource-name}.openai.azure.com
dağıtım kimliği	path	Evet	string
API sürümü	soru	Evet	string

İstek Başlığı

Token tabanlı kimlik doğrulama veya API anahtarı kullanın. Token tabanlı kimlik doğrulama önerilir ve daha güvenlidir.

İsim	Zorunlu	Türü	Description
Authorization	True	string	Örnek:Authorization: Bearer {Azure_OpenAI_Auth_Token} Azure CLI kullanarak doğrulama belirteçsi oluşturmak için: az account get-access-token --resource https://cognitiveservices.azure.com Tür: oauth2 Yetkilendirme URL'si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize kapsam: https://ai.azure.com/.default
API anahtarı	True	string	Azure OpenAI API anahtarını buradan paylaşın

İstek Gövdesi

İçerik Türü: application/json

İsim	Türü	Description	Zorunlu	Varsayılan
arka plan	imageBackground	Oluşturulan görüntülerin arka planı için şeffaflık ayarlamaya izin verir. Bu parametre yalnızca gpt-image-1 serisi modeller için desteklenir.	No	otomatik
n	integer	Üretilecek görüntü sayısı. dall-e-3 için yalnızca n=1 desteklenir.	No	1
çıktı sıkıştırma	integer	Oluşturulan görüntüler için sıkıştırma seviyesi (0-100%). Bu parametre yalnızca jpeg çıkış formatına sahip gpt-image-1 serisi modeller için desteklenir.	No	100
çıkış formatı	imagesOutputFormat	Oluşturulan görüntülerin geri döndüğü dosya formatı. Sadece GPT-image-1 serisi modeller için destekleniyor.	No	png
prompt	string	İstenen görsel(ler)in metin açıklaması. Maksimum uzunluk, gpt-image-1 serisi için 32000 karakter, dall-e-3 için ise 4000 karakterdir	Evet
kısmi_görüntüler	integer	Üretilecek kısmi görüntü sayısı. Bu parametre, kısmi görüntüleri geri getiren akış yanıtları için kullanılır. Değer 0 ile 3 arasında olmalıdır. 0 olarak ayarlandığında, yanıt tek bir akış etkinliğinde gönderilen tek bir görüntü olur. Tam görüntü daha hızlı üretilirse, kısmi görüntü tam sayısı üretilmeden önce nihai görüntü gönderilebilir.	0
veri akışı	boolean	Görüntüyü akış modunda düzenleyin.	hayır	false
nitelik	imageQuality	Üretilecek görüntünün kalitesi.	No	otomatik
yanıt formatı	imagesResponseFormat	Oluşturulan görüntülerin geri dönüş biçimi. Bu parametre, her zaman base64 kodlu görüntüleri döndüren -serisi modeller için desteklenmez gpt-image-1. Olası değerler: url, b64_json.	No	url
size	imageSize	Oluşturulan görüntülerin boyutu.	No	otomatik
Stil	imageStyle	Oluşturulan görüntülerin stili. Sadece dall-e-3 için destekleniyordu.	No	Canlı
user	string	Son kullanıcınızı temsil eden benzersiz bir tanımlayıcı, kötüye kullanımı izlemeye ve tespit etmeye yardımcı olabilir.	No

Yanıtlar

Durum Kodu: 200

Açıklama: Tamam

İçerik Türü	Türü	Tanım
uygulama/json	generateImagesResponse

Durum Kodu: varsayılan

Açıklama: Bir hata meydana geldi.

İçerik Türü	Türü	Tanım
uygulama/json	dalleErrorResponse

Examples

Örnek

Bir prompt verildiğinde görseller oluşturur.

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

Yanıtlar: Durum Kodu: 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
          }
        }
      }
    ]
  }
}

Görüntü üretimleri - Düzenle

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

Belirli bir gpt-image-1 model dağıtımında metin başlığından bir görüntüyü düzenler

URI Parametreleri

İsim	İçinde	Zorunlu	Türü	Description
endpoint	path	Evet	string URL	OpenAI uç noktaları Azure destekleniyor (örneğin protokol ve ana adı: https://aoairesource.openai.azure.com. "aoairesource" yerine Azure OpenAI kaynak adınızı verin). https://{your-resource-name}.openai.azure.com
dağıtım kimliği	path	Evet	string
API sürümü	soru	Evet	string

İstek Başlığı

Token tabanlı kimlik doğrulama veya API anahtarı kullanın. Token tabanlı kimlik doğrulama önerilir ve daha güvenlidir.

İsim	Zorunlu	Türü	Description
Authorization	True	string	Örnek:Authorization: Bearer {Azure_OpenAI_Auth_Token} Azure CLI kullanarak doğrulama belirteçsi oluşturmak için: az account get-access-token --resource https://cognitiveservices.azure.com Tür: oauth2 Yetkilendirme URL'si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize kapsam: https://ai.azure.com/.default
API anahtarı	True	string	Azure OpenAI API anahtarını buradan paylaşın

İstek Gövdesi

İçerik Türü: çok parçalı form-verisi

İsim	Türü	Description	Zorunlu	Varsayılan
image	dizi veya dizi	Düzenlenecek görsel(ler). Desteklenen bir görüntü dosyası veya bir dizi görüntü olmalı. Her resim 50MB'dan küçük bir png veya jpg dosyası olmalıdır.	Evet
input_fidelity	string	Modelin, giriş görüntülerinin stili ve özelliklerine, özellikle yüz özelliklerine uymak için ne kadar çaba göstereceğini kontrol edin. Bu parametre yalnızca gpt-image-1 serisi modeller için desteklenir. Destekler high ve low.	hayır	low.
mask	string	Tam şeffaf alanları (örneğin, alfa sıfır olduğu yer) görüntünün nerede düzenlenmesi gerektiğini gösteren ek bir görüntü. Birden fazla görüntü sağlanırsa, maske ilk görüntüye uygulanır. Geçerli bir PNG dosyası olmalı, 4MB'tan küçük olmalı ve görüntüyle aynı boyutlara sahip olmalıdır.	No
n	integer	Üretilecek görüntü sayısı. 1 ile 10 arasında olmalı.	No	1
prompt	string	İstenen görsel(ler)in metin açıklaması. Maksimum uzunluk 32000 karakterdir.	Evet
nitelik	imageQuality	Üretilecek görüntünün kalitesi.	No	otomatik
kısmi_görüntüler	Üretilecek kısmi görüntü sayısı. Bu parametre, kısmi görüntüleri geri getiren akış yanıtları için kullanılır. Değer 0 ile 3 arasında olmalıdır. 0 olarak ayarlandığında, yanıt tek bir akış etkinliğinde gönderilen tek bir görüntü olur. Tam görüntü daha hızlı üretilirse, kısmi görüntü tam sayısı üretilmeden önce nihai görüntü gönderilebilir.
veri akışı	boolean	Görüntüyü akış modunda düzenleyin.	hayır	false
yanıt formatı	imagesResponseFormat	Oluşturulan görüntülerin geri dönüş biçimi.	No	url
size	imageSize	Oluşturulan görüntülerin boyutu.	No	otomatik
user	string	Son kullanıcınızı temsil eden benzersiz bir tanımlayıcı, kötüye kullanımı izlemeye ve tespit etmeye yardımcı olabilir.	No

Yanıtlar

Durum Kodu: 200

Açıklama: Tamam

İçerik Türü	Türü	Tanım
uygulama/json	generateImagesResponse

Durum Kodu: varsayılan

Açıklama: Bir hata meydana geldi.

İçerik Türü	Türü	Tanım
uygulama/json	dalleErrorResponse

Components

Sohbet, tamamlamalar, eklemeler, yanıtlar ve diğer metin işlemleri tarafından kullanılan şema tanımları için OpenAI REST API başvurusu Azure bakın. Aşağıdaki şemalar bu sayfadaki görüntü ve ses işlemlerini destekler.

innerErrorCode

İç hata nesnesi için hata kodları.

Mülkiyet	Değer
Tanım	İç hata nesnesi için hata kodları.
Türü	string
Değerler	ResponsibleAIPolicyViolation

dalleErrorResponse

İsim	Türü	Description	Zorunlu	Varsayılan
error	dalleError		No

dalleError

İsim	Türü	Description	Zorunlu	Varsayılan
inner_error	dalleInnerError	İç hata ve ek detaylar.	No
param	string		No
type	string		No

dalleInnerError

İç hata ve ek detaylar.

İsim	Türü	Description	Zorunlu	Varsayılan
kod	innerErrorCode	İç hata nesnesi için hata kodları.	No
content_filter_results	dalleFilterResults	İçerik filtreleme kategorisi hakkında bilgiler (nefret, cinsel, şiddet self_harm), tespit edilip edilmediği, şiddet seviyesi (zararlı içeriğin yoğunluğunu ve risk seviyesini belirleyen very_low, düşük, orta, yüksek ölçek) ve filtrelenip filtrelenmediği. Jailbreak içeriği ve küfürler hakkında bilgiler, tespit edilip edilmediği, filtrelenip filtrelenmediği hakkında bilgiler. Ve müşteri engelleme listesi hakkında, filtrelenip filtrelenmişler ve kimliği hakkında bilgiler.	No
düzeltilmiş_yazı	string	Eğer isteğinde herhangi bir değişiklik varsa, görüntü oluşturmak için kullanılan istem kullanıldı.	No

içerik filtresi ciddiyet sonucu

İsim	Türü	Description	Zorunlu	Varsayılan
filtered	boolean		Evet
severity	string		No

içerik filtresi algılandı sonucu

İsim	Türü	Description	Zorunlu	Varsayılan
detected	boolean		No
filtered	boolean		Evet

contentFilterDetailedResults

İçerik filtreleme sonuçları, filtrelenen segmentler için içerik filtre kimliklerinin detayını içerir.

İsim	Türü	Description	Zorunlu	Varsayılan
details	Dizi		No
filtered	boolean		Evet

dalleFiltreSonuçları

İçerik filtreleme kategorisi hakkında bilgiler (nefret, cinsel, şiddet self_harm), tespit edilip edilmediği, şiddet seviyesi (zararlı içeriğin yoğunluğunu ve risk seviyesini belirleyen very_low, düşük, orta, yüksek ölçek) ve filtrelenip filtrelenmediği. Jailbreak içeriği ve küfürler hakkında bilgiler, tespit edilip edilmediği, filtrelenip filtrelenmediği hakkında bilgiler. Ve müşteri engelleme listesi hakkında, filtrelenip filtrelenmişler ve kimliği hakkında bilgiler.

İsim	Türü	Description	Zorunlu	Varsayılan
custom_blocklists	contentFilterDetailedResults	İçerik filtreleme sonuçları, filtrelenen segmentler için içerik filtre kimliklerinin detayını içerir.	No
hate	contentFilterSeverityResult		No
jailbreak	içerik filtresi tespit edilen sonuç		No
profanity	içerik filtresi tespit edilen sonuç		No
self_harm	contentFilterSeverityResult		No
sexual	contentFilterSeverityResult		No
violence	contentFilterSeverityResult		No

audioResponseFormat

Çıktının formatını tanımlar.

Mülkiyet	Değer
Tanım	Çıktının formatını tanımlar.
Türü	string
Değerler	json text srt verbose_json vtt

görüntü kalitesi

Üretilecek görüntünün kalitesi.

Mülkiyet	Değer
Tanım	Üretilecek görüntünün kalitesi.
Türü	string
Varsayılan	otomatik
Değerler	auto high medium low hd standard

imagesResponseFormat

Oluşturulan görüntülerin geri dönüş biçimi.

Mülkiyet	Değer
Tanım	Oluşturulan görüntülerin geri dönüş biçimi.
Türü	string
Varsayılan	url
Değerler	url b64_json

imagesOutputFormat

Oluşturulan görüntülerin geri döndüğü dosya formatı. Sadece seri modeller için destekleniyor.

Mülkiyet	Değer
Tanım	Oluşturulan görüntülerin geri döndüğü dosya formatı. Sadece GPT-image-1 serisi modeller için destekleniyor.
Türü	string
Varsayılan	png
Değerler	png jpeg

imageSize

Oluşturulan görüntülerin boyutu.

Mülkiyet	Değer
Tanım	Oluşturulan görüntülerin boyutu.
Türü	string
Varsayılan	otomatik
Değerler	auto 1792x1024 1024x1792 1024x1024 1024x1536 1536x1024

imageStyle

Oluşturulan görüntülerin stili. Sadece dall-e-3 için destekleniyordu.

Mülkiyet	Değer
Tanım	Oluşturulan görüntülerin stili. Sadece dall-e-3 için destekleniyordu.
Türü	string
Varsayılan	Canlı
Değerler	vivid natural

imageBackground

Oluşturulan görselin arka planı için şeffaflık ayarlanabilir. Bu parametre yalnızca gpt-image-1 serisi modeller için desteklenir.

Mülkiyet	Değer
Tanım	Oluşturulan görselin arka planı için şeffaflık ayarlanabilir. Bu parametre yalnızca gpt-image-1 serisi modeller için desteklenir.
Türü	string
Varsayılan	otomatik
Değerler	transparent opaque auto

generateImagesResponse

İsim	Türü	Description	Zorunlu	Varsayılan
created	integer	İşlemin oluşturulduğu unix zaman damgası.	Evet
veriler	Dizi	İşlemin sonuç verileri, başarılı olursa	Evet
usage	imageGenerationsUsage	Görüntü oluşturma talepleri için token kullanım detaylarını temsil eder. Sadece gpt-image-1 serisi modeller için.	No

imageGenerationsUsage

Görüntü oluşturma talepleri için token kullanım detaylarını temsil eder. Sadece gpt-image-1 serisi modeller için.

İsim	Türü	Description	Zorunlu	Varsayılan
input_tokens	integer	Giriş tokenlarının sayısı.	No
input_tokens_details	Obje	Giriş tokenlarının ayrıntılı bir analizi.	No
└─ resim_jetonları	integer	Görüntü tokenlarının sayısı.	No
└─ metin_tokenleri	integer	Metin tokenlarının sayısı.	No
output_tokens	integer	Çıkış jeton sayısı.	No
total_tokens	integer	Kullanılan toplam jeton sayısı.	No

Sonraki Adımlar

REST API ile modeller ve ince ayarlamalar hakkında bilgi edinin. OpenAI Azure destekleyen underlying modelleri hakkında daha fazla bilgi edinin.