Azure reference k rozhraní REST API OpenAI a obrázku OpenAI (2025-04-01-preview)

Tento článek dokumentuje operace rozhraní REST API pro generování obrázků a odvozování roviny zvuku (speech) pro Azure OpenAI ve 2025-04-01-preview vydané verzi. Informace o dokončování chatu, vkládání, asistentech, odpovědích, vektorových úložištích a všech ostatních operacích najdete v oficiálním Azure referenčních informacích k rozhraní REST API OpenAI.

Specifikace rozhraní API

Správa a interakce s modely a zdroji Azure OpenAI je rozdělena do tří hlavních API povrchů:

• Úroveň řízení
• Datová rovina – authoring
• Datová rovina – inference

Každá API-plocha/specifikace zahrnuje jinou sadu schopností Azure OpenAI. Každé API má svou vlastní jedinečnou sadu preview a stable/generally dostupných (GA) API verzí. Předběžná vydání v současnosti obvykle následují měsíční rytmus.

Important

Nyní je k dispozici nové API pro preview inference. Více informací najdete v našem přívodci životním cyklem API.

API	Nejnovější preview verze	Nejnovější vydání GA	Specifications	Description
Řídicí rovina	2025-07-01-preview	2025-06-01	Soubory specifikace	API řídicí roviny se používá pro operace jako je vytváření zdrojů, nasazování modelů a další vyšší úrovně správy zdrojů. Řídicí rovina také řídí, co je možné dělat s funkcemi jako Azure Resource Manager, Bicep, Terraform a Azure CLI.
Datová rovina	v1 preview	v1	Soubory specifikace	API datové roviny řídí inference a tvorbu.

Autentizace

Azure OpenAI poskytuje dvě metody autentizace. Můžete použít buď API Keys, nebo Microsoft Entra ID.

• Autentizace API klíče: Pro tento typ autentizace musí všechny API požadavky obsahovat API klíč v HTTP hlavičce api-key . Quickstart poskytuje návod, jak s tímto typem autentizace hovorit.

• Microsoft Entra ID autentizace: API volání můžete autentizovat pomocí Microsoft Entra tokenu. Autentizační tokeny jsou zahrnuty v požadavku jako hlavička Authorization . Poskytnutý token musí být předcházen Bearer, například Bearer YOUR_AUTH_TOKEN. Můžete si přečíst náš návod na autentizaci pomocí Microsoft Entra ID.

Verze REST API

API služeb jsou verzována pomocí parametru api-version dotazu. Všechny verze se řídí datovou strukturou YYYY-MM-DD. Příklad:

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

Inference v datové rovině

Zbytek tohoto článku popisuje operace s obrázky a zvukem ve 2025-04-01-preview verzi Preview specifikace odvozování roviny dat OpenAI ve Azure verzi Preview.

Informace o operacích image a zvuku ga najdete v referenčních informacích k image GA a zvukovému rozhraní REST API.

Přepisy - Vytvořit

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

Přepisuje zvuk do vstupního jazyka.

Parametry identifikátoru URI

Název	V	Povinné	Typ	Description
koncový bod	cesta	Ano	řetězec URL	Podporováno Azure koncových zařízeních OpenAI (například protokol a hostitelské jméno: https://aoairesource.openai.azure.com. Nahraďte "aoairesource" názvem vašeho zdroje Azure OpenAI). https://{název_prostředku}.openai.azure.com
ID nasazení	cesta	Ano	řetězec
verze rozhraní API	dotaz	Ano	řetězec

Hlavička požadavku

Použijte buď tokenovou autentizaci, nebo API klíč. Doporučuje se autentizace pomocí tokenové autentizace a je bezpečnější.

Název	Povinné	Typ	Description
Authorization	Pravdivé	řetězec	Příklad:Authorization: Bearer {Azure_OpenAI_Auth_Token} Pro vytvoření autentizačního tokenu pomocí Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com Typ: oauth2 Autorizační URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize Rozsah: https://ai.azure.com/.default
API klíč	Pravdivé	řetězec	Tady zadejte klíč rozhraní API Azure OpenAI.

Tělo žádosti

Typ obsahu: vícedílné/formulářové data

Název	Typ	Description	Povinné	Výchozí
model	řetězec	ID modelu, který použít. Možnosti jsou gpt-4o-transcribe, gpt-4o-mini-transcribe, gpt-4o-mini-transcribe-2025-12-15, whisper-1, a gpt-4o-transcribe-diarize.	Ano
soubor	řetězec	Zvukový soubor je objektem přepisu.	Ano
jazyk	řetězec	Jazyk vstupního zvuku. Dodávání vstupního jazyka ve formátu ISO-639-1 zlepšuje přesnost a latenci.	No
požádat	řetězec	Volitelný text, který řídí styl modelu nebo pokračuje v předchozím audio segmentu. Výzva by měla odpovídat zvukovému jazyku.	No
formát_odpovědi	audioResponseFormat	Definuje formát výstupu.	No
Teplota	number	Vzorkovací teplota mezi 0 a 1. Vyšší hodnoty jako 0,8 udělají výstup náhodnějším, zatímco nižší hodnoty jako 0,2 ho udělají více zaměřeným a deterministickým efektem. Pokud je nastaveno na 0, model používá logaritmickou pravděpodobnost k automatickému zvýšení teploty, dokud nejsou dosaženy určité prahové hodnoty.	No	0
timestamp_granularities[]	pole	Časové granularity pro tento přepis je potřeba vyplnit. response_format musí být nastaven verbose_json tak, aby používal časové granularity. Podporují se obě tyto možnosti: word, nebo segment. Poznámka: Pro časová razítka segmentu není žádná dodatečná latence, ale generování časových razítek slov způsobuje dodatečnou latenci.	No	['segment']

Responses

Kód stavu: 200

Popis: OK

Typ obsahu	Type	Description
application/json	objekt
prostý text	řetězec	Přepis textu ve výstupním formátu (když response_format byl jeden z text, vtt nebo srt).

Příklady

Příklad

Získává přepsán text a související metadata z poskytnutých mluvených zvukových dat.

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

Odpovědi: Stavový kód: 200

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

Příklad

Získává přepsán text a související metadata z poskytnutých mluvených zvukových dat.

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

Odpovědi: Stavový kód: 200

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

Překlady - Vytvořit

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

Přepisuje a překládá vstupní audio do anglického textu.

Parametry identifikátoru URI

Název	V	Povinné	Typ	Description
koncový bod	cesta	Ano	řetězec URL	Podporováno Azure koncových zařízeních OpenAI (například protokol a hostitelské jméno: https://aoairesource.openai.azure.com. Nahraďte "aoairesource" názvem vašeho zdroje Azure OpenAI). https://{název_prostředku}.openai.azure.com
ID nasazení	cesta	Ano	řetězec
verze rozhraní API	dotaz	Ano	řetězec

Hlavička požadavku

Použijte buď tokenovou autentizaci, nebo API klíč. Doporučuje se autentizace pomocí tokenové autentizace a je bezpečnější.

Název	Povinné	Typ	Description
Authorization	Pravdivé	řetězec	Příklad:Authorization: Bearer {Azure_OpenAI_Auth_Token} Pro vytvoření autentizačního tokenu pomocí Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com Typ: oauth2 Autorizační URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize Rozsah: https://ai.azure.com/.default
API klíč	Pravdivé	řetězec	Tady zadejte klíč rozhraní API Azure OpenAI.

Tělo žádosti

Typ obsahu: vícedílné/formulářové data

Název	Typ	Description	Povinné	Výchozí
soubor	řetězec	Zvukový soubor k překladu.	Ano
požádat	řetězec	Volitelný text, který řídí styl modelu nebo pokračuje v předchozím audio segmentu. Zadání by mělo být v angličtině.	No
formát_odpovědi	audioResponseFormat	Definuje formát výstupu.	No
Teplota	number	Vzorkovací teplota mezi 0 a 1. Vyšší hodnoty jako 0,8 udělají výstup náhodnějším, zatímco nižší hodnoty jako 0,2 ho udělají více zaměřeným a deterministickým efektem. Pokud je nastaveno na 0, model používá logaritmickou pravděpodobnost k automatickému zvýšení teploty, dokud nejsou dosaženy určité prahové hodnoty.	No	0

Responses

Kód stavu: 200

Popis: OK

Typ obsahu	Type	Description
application/json	objekt
prostý text	řetězec	Přepisoval text ve výstupním formátu (když response_format byl text, VTT nebo srt).

Příklady

Příklad

Získává anglicky přepisovaný text a související metadata z poskytnutých mluvených zvukových dat.

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

Odpovědi: Stavový kód: 200

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

Příklad

Získává anglicky přepisovaný text a související metadata z poskytnutých mluvených zvukových dat.

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

Odpovědi: Stavový kód: 200

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

Projev - Tvoř

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

Generuje zvuk ze vstupního textu.

Parametry identifikátoru URI

Název	V	Povinné	Typ	Description
koncový bod	cesta	Ano	řetězec URL	Podporováno Azure koncových zařízeních OpenAI (například protokol a hostitelské jméno: https://aoairesource.openai.azure.com. Nahraďte "aoairesource" názvem vašeho zdroje Azure OpenAI). https://{název_prostředku}.openai.azure.com
ID nasazení	cesta	Ano	řetězec
verze rozhraní API	dotaz	Ano	řetězec

Hlavička požadavku

Použijte buď tokenovou autentizaci, nebo API klíč. Doporučuje se autentizace pomocí tokenové autentizace a je bezpečnější.

Název	Povinné	Typ	Description
Authorization	Pravdivé	řetězec	Příklad:Authorization: Bearer {Azure_OpenAI_Auth_Token} Pro vytvoření autentizačního tokenu pomocí Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com Typ: oauth2 Autorizační URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize Rozsah: https://ai.azure.com/.default
API klíč	Pravdivé	řetězec	Tady zadejte klíč rozhraní API Azure OpenAI.

Tělo žádosti

Typ obsahu: vícedílné/formulářové data

Název	Typ	Description	Povinné	Výchozí
vstup	řetězec	Text, pro který je třeba syntetizovat zvuk. Maximální délka je 4 096 znaků.	Ano
formát_odpovědi	výčet	Formát pro syntézu zvuku. Možné hodnoty: mp3, opus, aac, , flac, wavpcm	No
Rychlost	number	Rychlost syntetizovaného zvuku. Vyberte hodnotu z 0.25 do .4.0 1.0 je výchozí.	No	1.0
voice	výčet	Hlas pro syntézu řeči. Možné hodnoty: alloy, echo, fable, , onyx, novashimmer	Ano

Responses

Kód stavu: 200

Popis: OK

Typ obsahu	Type	Description
application/octet-stream	řetězec

Příklady

Příklad

Syntetizuje zvuk z poskytnutého textu.

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

Odpovědi: Stavový kód: 200

{
  "body": "101010101"
}

Generace obrázků – Vytvořit

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

Generuje dávku obrázků z textového popisku při nasazení daného modelu generování obrázků

Parametry identifikátoru URI

Název	V	Povinné	Typ	Description
koncový bod	cesta	Ano	řetězec URL	Podporováno Azure koncových zařízeních OpenAI (například protokol a hostitelské jméno: https://aoairesource.openai.azure.com. Nahraďte "aoairesource" názvem vašeho zdroje Azure OpenAI). https://{název_prostředku}.openai.azure.com
ID nasazení	cesta	Ano	řetězec
verze rozhraní API	dotaz	Ano	řetězec

Hlavička požadavku

Použijte buď tokenovou autentizaci, nebo API klíč. Doporučuje se autentizace pomocí tokenové autentizace a je bezpečnější.

Název	Povinné	Typ	Description
Authorization	Pravdivé	řetězec	Příklad:Authorization: Bearer {Azure_OpenAI_Auth_Token} Pro vytvoření autentizačního tokenu pomocí Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com Typ: oauth2 Autorizační URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize Rozsah: https://ai.azure.com/.default
API klíč	Pravdivé	řetězec	Tady zadejte klíč rozhraní API Azure OpenAI.

Tělo žádosti

Typ obsahu: application/json

Název	Typ	Description	Povinné	Výchozí
na pozadí	imageBackground	Umožňuje nastavit průhlednost pozadí generovaných obrázků. Tento parametr je podporován pouze pro modely řady gpt-image-1.	No	auto
n	integer	Počet obrázků k generování. Pro dall-e-3 je podporováno pouze n=1.	No	1
komprese_výstupu	integer	Úroveň komprese (0-100%) pro generované snímky. Tento parametr je podporován pouze pro modely řady GPT-Image-1 s formátem jpeg výstupu.	No	100
formát_výstupu	imagesOutputFormat	Formát souboru, ve kterém jsou generované obrázky vráceny. Podporováno pouze pro modely série GPT-Image-1.	No	png
požádat	řetězec	Textový popis požadovaného obrázku/obrázků. Maximální délka je 32 000 znaků pro sérii GPT-Image-1 a 4000 znaků pro dall-e-3	Ano
částečné_obrázky	integer	Počet částečných obrazů, které je třeba vygenerovat. Tento parametr se používá pro streamované odezvy, které vracejí částečné obrazy. Hodnota musí být mezi 0 a 3. Při nastavení na 0 bude odezva jediný obrázek odeslaný v jedné streamovací události. Všimněte si, že finální obraz může být odeslán dříve, než je generován plný počet částečných snímků, pokud je celý obraz generován rychleji.	0
datový proud	boolean	Upravte obrázek v režimu streamování.	ne	false
kvalita	imageQuality	Kvalita obrázku, který bude generován.	No	auto
formát_odpovědi	imagesResponseFormat	Formát, ve kterém jsou generované obrázky vráceny. Tento parametr není podporován u gpt-image-1modelů série -series, které vždy vrátí obrázky kódované v base64. Možné hodnoty: url, . b64_json	No	Adresu url
size	imageSize	Velikost generovaných obrázků.	No	auto
styl	imageStyle	Styl generovaných obrázků. Podporováno pouze pro dall-e-3.	No	Živé
uživatel	řetězec	Jedinečný identifikátor reprezentující vašeho koncového uživatele, který může pomoci sledovat a odhalovat zneužití.	No

Responses

Kód stavu: 200

Popis: Ok

Typ obsahu	Type	Description
application/json	generateImagesResponse

Stavový kód: výchozí

Popis: Došlo k chybě.

Typ obsahu	Type	Description
application/json	dalleErrorResponse

Příklady

Příklad

Vytváří obrázky na základě zadání.

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

Odpovědi: Stavový kód: 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
          }
        }
      }
    ]
  }
}

Generace obrázků - Edit

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

Upravuje obrázek z textového popisku na daném nasazení modelu GPT-image-1

Parametry identifikátoru URI

Název	V	Povinné	Typ	Description
koncový bod	cesta	Ano	řetězec URL	Podporováno Azure koncových zařízeních OpenAI (například protokol a hostitelské jméno: https://aoairesource.openai.azure.com. Nahraďte "aoairesource" názvem vašeho zdroje Azure OpenAI). https://{název_prostředku}.openai.azure.com
ID nasazení	cesta	Ano	řetězec
verze rozhraní API	dotaz	Ano	řetězec

Hlavička požadavku

Použijte buď tokenovou autentizaci, nebo API klíč. Doporučuje se autentizace pomocí tokenové autentizace a je bezpečnější.

Název	Povinné	Typ	Description
Authorization	Pravdivé	řetězec	Příklad:Authorization: Bearer {Azure_OpenAI_Auth_Token} Pro vytvoření autentizačního tokenu pomocí Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com Typ: oauth2 Autorizační URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize Rozsah: https://ai.azure.com/.default
API klíč	Pravdivé	řetězec	Tady zadejte klíč rozhraní API Azure OpenAI.

Tělo žádosti

Typ obsahu: vícedílné/formulářové data

Název	Typ	Description	Povinné	Výchozí
bitová kopie	řetězec nebo pole	Obrázek(obrázky) k úpravě. Musí to být podporovaný soubor obrázků nebo pole obrázků. Každý obrázek by měl být png, tedy jpg soubor menší než 50MB.	Ano
input_fidelity	řetězec	Kontrolujte, kolik úsilí model vynaloží, aby odpovídal stylu a rysům, zejména rysům obličeje, vstupních obrázků. Tento parametr je podporován pouze pro modely řady gpt-image-1. Podpěry high a low.	ne	low.
maska	řetězec	Další obrázek, jehož plně průhledné oblasti (např. kde alfa je nula) ukazují, kde by měl být obrázek upraven. Pokud je poskytnuto více obrázků, maska se aplikuje na první obrázek. Musí to být platný PNG soubor, menší než 4MB a mít stejné rozměry jako obrázek.	No
n	integer	Počet obrázků k generování. Musí to být mezi 1 a 10.	No	1
požádat	řetězec	Textový popis požadovaného obrázku/obrázků. Maximální délka je 32 000 znaků.	Ano
kvalita	imageQuality	Kvalita obrázku, který bude generován.	No	auto
částečné_obrázky	Počet částečných obrazů, které je třeba vygenerovat. Tento parametr se používá pro streamované odezvy, které vracejí částečné obrazy. Hodnota musí být mezi 0 a 3. Při nastavení na 0 bude odezva jediný obrázek odeslaný v jedné streamovací události. Všimněte si, že finální obraz může být odeslán dříve, než je generován plný počet částečných snímků, pokud je celý obraz generován rychleji.
datový proud	boolean	Upravte obrázek v režimu streamování.	ne	false
formát_odpovědi	imagesResponseFormat	Formát, ve kterém jsou generované obrázky vráceny.	No	Adresu url
size	imageSize	Velikost generovaných obrázků.	No	auto
uživatel	řetězec	Jedinečný identifikátor reprezentující vašeho koncového uživatele, který může pomoci sledovat a odhalovat zneužití.	No

Responses

Kód stavu: 200

Popis: Ok

Typ obsahu	Type	Description
application/json	generateImagesResponse

Stavový kód: výchozí

Popis: Došlo k chybě.

Typ obsahu	Type	Description
application/json	dalleErrorResponse

Components

Definice schématu používané chatem, dokončováním, vkládáním, odpověďmi a dalšími textovými operacemi najdete v referenčních informacích k rozhraní REST API Azure OpenAI. Následující schémata podporují operace obrázků a zvuku na této stránce.

innerErrorCode

Chybové kódy pro vnitřní objekt chyby.

Vlastnictví	Value
Description	Chybové kódy pro vnitřní objekt chyby.
Type	řetězec
Hodnoty	ResponsibleAIPolicyViolation

dalleErrorResponse

Název	Typ	Description	Povinné	Výchozí
chyba	dalleError		No

dalleError

Název	Typ	Description	Povinné	Výchozí
inner_error	dalleInnerError	Vnitřní chyba s dalšími detaily.	No
param	řetězec		No
typ	řetězec		No

dalleInnerError

Vnitřní chyba s dalšími detaily.

Název	Typ	Description	Povinné	Výchozí
kód	innerErrorCode	Chybové kódy pro vnitřní objekt chyby.	No
content_filter_results	dalleFilterResults	Informace o kategorii filtrování obsahu (nenávist, sexuální, násilí self_harm), zda byla zjištěna, stejně jako o závažnosti (very_low, nízká, střední, vysoká škála, která určuje intenzitu a riziko škodlivého obsahu) a zda byl obsah filtrován či nikoliv. Informace o obsahu jailbreaku a vulgarismu, zda byly detekovány a zda byly filtrovány či nikoliv. A informace o zákaznickém blokovaném seznamu, jestli byl filtrován a jaké je ID.	No
revidovaný_příkaz	řetězec	Prompt, který byl použit k vygenerování obrázku, pokud byla nějaká reakce v promptu.	No

výsledek závažnosti obsahu filtru

Název	Typ	Description	Povinné	Výchozí
Filtrované	boolean		Ano
severity	řetězec		No

Výsledek detekce filtru obsahu

Název	Typ	Description	Povinné	Výchozí
Zjištěna	boolean		No
Filtrované	boolean		Ano

contentFilterDetailedResults

Filtrování obsahu obsahuje detailní ID filtrů obsahu pro filtrované segmenty.

Název	Typ	Description	Povinné	Výchozí
Podrobnosti	pole		No
Filtrované	boolean		Ano

dalleFilterResults

Informace o kategorii filtrování obsahu (nenávist, sexuální, násilí self_harm), zda byla zjištěna, stejně jako o závažnosti (very_low, nízká, střední, vysoká škála, která určuje intenzitu a riziko škodlivého obsahu) a zda byl obsah filtrován či nikoliv. Informace o obsahu jailbreaku a vulgarismu, zda byly detekovány a zda byly filtrovány či nikoliv. A informace o zákaznickém blokovaném seznamu, jestli byl filtrován a jaké je ID.

Název	Typ	Description	Povinné	Výchozí
custom_blocklists	contentFilterDetailedResults	Filtrování obsahu obsahuje detailní ID filtrů obsahu pro filtrované segmenty.	No
Nenávidět	výsledek závažnosti filtrování obsahu		No
Jailbreak	výsledek detekovaného filtru obsahu		No
Rouhání	výsledek detekovaného filtru obsahu		No
self_harm	výsledek závažnosti filtrování obsahu		No
Sexuální	výsledek závažnosti filtrování obsahu		No
Násilí	výsledek závažnosti filtrování obsahu		No

formát zvukové odpovědi

Definuje formát výstupu.

Vlastnictví	Value
Description	Definuje formát výstupu.
Type	řetězec
Hodnoty	json text srt verbose_json vtt

kvalita obrázku

Kvalita obrázku, který bude generován.

Vlastnictví	Value
Description	Kvalita obrázku, který bude generován.
Type	řetězec
Default	auto
Hodnoty	auto high medium low hd standard

imagesResponseFormat

Formát, ve kterém jsou generované obrázky vráceny.

Vlastnictví	Value
Description	Formát, ve kterém jsou generované obrázky vráceny.
Type	řetězec
Default	Adresu url
Hodnoty	url b64_json

imagesOutputFormat

Formát souboru, ve kterém jsou generované obrázky vráceny. Podporováno pouze u sériových modelů.

Vlastnictví	Value
Description	Formát souboru, ve kterém jsou generované obrázky vráceny. Podporováno pouze pro modely série GPT-Image-1.
Type	řetězec
Default	png
Hodnoty	png jpeg

imageSize

Velikost generovaných obrázků.

Vlastnictví	Value
Description	Velikost generovaných obrázků.
Type	řetězec
Default	auto
Hodnoty	auto 1792x1024 1024x1792 1024x1024 1024x1536 1536x1024

imageStyle

Styl generovaných obrázků. Podporováno pouze pro dall-e-3.

Vlastnictví	Value
Description	Styl generovaných obrázků. Podporováno pouze pro dall-e-3.
Type	řetězec
Default	Živé
Hodnoty	vivid natural

imageBackground

Umožňuje nastavit průhlednost pozadí generovaného obrázku. Tento parametr je podporován pouze pro modely řady gpt-image-1.

Vlastnictví	Value
Description	Umožňuje nastavit průhlednost pozadí generovaného obrázku. Tento parametr je podporován pouze pro modely řady gpt-image-1.
Type	řetězec
Default	auto
Hodnoty	transparent opaque auto

generateImagesResponse

Název	Typ	Description	Povinné	Výchozí
Vytvořen	integer	Unixové časové razítko, kdy byla operace vytvořena.	Ano
data	pole	Výsledná data operace, pokud jsou úspěšná	Ano
využití	imageGenerationsUsage	Představuje podrobnosti o využití tokenu pro požadavky na generování obrázků. Pouze pro modely série GPT-Image-1.	No

imageGenerationsUsage

Představuje podrobnosti o využití tokenu pro požadavky na generování obrázků. Pouze pro modely série GPT-Image-1.

Název	Typ	Description	Povinné	Výchozí
input_tokens	integer	Počet vstupních tokenů.	No
input_tokens_details	objekt	Podrobný rozpis vstupních tokenů.	No
└image_tokens	integer	Počet obrazových tokenů.	No
└text_tokens	integer	Počet textových tokenů.	No
output_tokens	integer	Počet výstupních tokenů.	No
total_tokens	integer	Celkový počet použitých žetonů.	No

Další kroky

Seznamte se s modely a vyladěním pomocí rozhraní REST API. Přečtěte si další informace o podobách modelů, které power Azure OpenAI.