Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Den här artikeln dokumenterar rest-API-åtgärder för bildgenerering och ljud (tal) för Azure OpenAI i versionen2025-04-01-preview. Information om chattavslutningar, inbäddningar, assistenter, svar, vektorlager och alla andra åtgärder finns i den officiella Azure OpenAI REST API-referens.
API-specifikationer
Hantering och interaktion med Azure OpenAI-modeller och resurser är uppdelad över tre huvudsakliga API-ytor:
- Kontrollplan
- Dataplan – författarskap
- Dataplan – inferens
Varje API-yta/specifikation kapslar in en annan uppsättning Azure OpenAI-funktioner. Varje API har sin egen unika uppsättning förhandsvisningar och stabila/allmänt tillgängliga (GA) API-releaser. Förhandsvisningar följer för närvarande en månatlig rytm.
Viktigt!
Det finns nu ett nytt API för förhandsgranskningsinferens. Läs mer i vår guide för API-livscykeln.
| API | Senaste förhandsvisningen | Senaste GA-utgåvan | Specifications | Description |
|---|---|---|---|---|
| Kontrollplan | 2025-07-01-preview |
2025-06-01 |
Spec-filer | Kontrollplanets API används för operationer som att skapa resurser, modellutrullning och andra högre nivåuppgifter inom resurshantering. Kontrollplanet styr också vad som är möjligt att göra med funktioner som Azure Resource Manager, Bicep, Terraform och Azure CLI. |
| Dataplanet | v1 preview |
v1 |
Spec-filer | Data plane API styr inferens- och författaroperationer. |
Authentication
Azure OpenAI erbjuder två metoder för autentisering. Du kan använda antingen API-nycklar eller Microsoft Entra ID.
API-nyckelautentisering: För denna typ av autentisering måste alla API-förfrågningar inkludera API-nyckeln i
api-keyHTTP-headern. Quickstart ger vägledning för hur man gör samtal med denna typ av autentisering.Microsoft Entra ID autentisering: Du kan autentisera ett API-anrop med en Microsoft Entra-token. Autentiseringstoken ingår i en förfrågan som
Authorizationheader. Den givna token måste föregås avBearer, till exempelBearer YOUR_AUTH_TOKEN. Du kan läsa vår guide om autentisera med Microsoft Entra ID.
REST API-versionshantering
Tjänste-API:erna versioneras med hjälp av frågeparametern api-version . Alla versioner följer YYYY-MM-DD datumstrukturen. Ett exempel:
POST https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/chat/completions?api-version=2024-06-01
Dataplansinferens
Resten av den här artikeln beskriver bild- och ljudåtgärderna i 2025-04-01-preview förhandsversionen av Azure OpenAI-dataplanets slutsatsdragningsspecifikation.
Information om GA-avbildnings- och ljudåtgärder finns i referensen för GA-avbildningen och rest-API:et för ljud.
Transkriptioner - Skapa
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/transcriptions?api-version=2025-04-01-preview
Transkriberar ljudet till inmatningsspråket.
URI parametrar
| Name | I | Obligatoriskt | Type | Description |
|---|---|---|---|---|
| slutpunkt | path | Ja | sträng-URL | Stödd Azure OpenAI-endpoints (protokoll och värdnamn, till exempel: https://aoairesource.openai.azure.com. Byt ut "aoairesource" mot ditt Azure OpenAI-resursnamn). https://{your-resource-name}.openai.azure.com |
| driftsättnings-id | path | Ja | string | |
| api-version | Fråga | Ja | string |
Begärandehuvud
Använd antingen tokenbaserad autentisering eller API-nyckel. Autentifikation med tokenbaserad autentisering rekommenderas och är säkrare.
| Name | Obligatoriskt | Type | Description |
|---|---|---|---|
| Authorization | True | string |
Exempel:Authorization: Bearer {Azure_OpenAI_Auth_Token}För att generera en autentiseringstoken med hjälp av Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comTyp: oauth2 Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeOmfattning: https://ai.azure.com/.default |
| API-nyckel | True | string | Tillhandahåll Azure OpenAI API-nyckel här |
Begärandekropp
Innehållstyp: flera delar/formulärdata
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| model | string | ID på modellen att använda. Alternativen är , , , , gpt-4o-transcribeoch gpt-4o-mini-transcribe. gpt-4o-mini-transcribe-2025-12-15whisper-1gpt-4o-transcribe-diarize |
Ja | |
| fil | string | Ljudfilobjektet att transkribera. | Ja | |
| language | string | Språket för inmatningsljudet. Att tillhandahålla inmatningsspråket i ISO-639-1-format förbättrar noggrannhet och latens. | No | |
| prompt | string | En valfri text för att styra modellens stil eller fortsätta ett tidigare ljudsegment. Prompten ska matcha ljudspråket. | No | |
| svarsformat | audioResponseFormat | Definierar formatet på utdatan. | No | |
| Temperatur | number | Provtagningstemperaturen, mellan 0 och 1. Högre värden som 0,8 gör resultatet mer slumpmässigt, medan lägre värden som 0,2 gör det mer fokuserat och deterministiskt. Om den sätts till 0 använder modellen logaritmisk sannolikhet för att automatiskt öka temperaturen tills vissa tröskelvärden nås. | No | 0 |
| timestamp_granularities[] | array | Tidsstämpelns granulariteter för denna transkription.
response_format måste vara inställd verbose_json på att använda tidsstämpelgranulariteter. Antingen eller båda dessa alternativ stöds: word, eller segment. Observera: Det finns ingen extra latens för segmenttidsstämplar, men generering av ordtidsstämplar medför ytterligare latens. |
No | ['segment'] |
Responses
Statuskod: 200
Beskrivning: OK
| Innehållstyp | Type | Beskrivning |
|---|---|---|
| application/json | object | |
| text/plain | string | Transkriberad text i utdataformatet (när response_format var en av text, vtt eller srt). |
Exempel
Example
Får transkriberad text och tillhörande metadata från tillhandahållen talad ljuddata.
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/transcriptions?api-version=2025-04-01-preview
Svar: Statuskod: 200
{
"body": {
"text": "A structured object when requesting json or verbose_json"
}
}
Example
Får transkriberad text och tillhörande metadata från tillhandahållen talad ljuddata.
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--"
Svar: Statuskod: 200
{
"type": "string",
"example": "plain text when requesting text, srt, or vtt"
}
Översättningar - Skapa
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/translations?api-version=2025-04-01-preview
Transkriberar och översätter inmatat ljud till engelsk text.
URI parametrar
| Name | I | Obligatoriskt | Type | Description |
|---|---|---|---|---|
| slutpunkt | path | Ja | sträng-URL | Stödd Azure OpenAI-endpoints (protokoll och värdnamn, till exempel: https://aoairesource.openai.azure.com. Byt ut "aoairesource" mot ditt Azure OpenAI-resursnamn). https://{your-resource-name}.openai.azure.com |
| driftsättnings-id | path | Ja | string | |
| api-version | Fråga | Ja | string |
Begärandehuvud
Använd antingen tokenbaserad autentisering eller API-nyckel. Autentifikation med tokenbaserad autentisering rekommenderas och är säkrare.
| Name | Obligatoriskt | Type | Description |
|---|---|---|---|
| Authorization | True | string |
Exempel:Authorization: Bearer {Azure_OpenAI_Auth_Token}För att generera en autentiseringstoken med hjälp av Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comTyp: oauth2 Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeOmfattning: https://ai.azure.com/.default |
| API-nyckel | True | string | Tillhandahåll Azure OpenAI API-nyckel här |
Begärandekropp
Innehållstyp: flera delar/formulärdata
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| fil | string | Ljudfilen att översätta. | Ja | |
| prompt | string | En valfri text för att styra modellens stil eller fortsätta ett tidigare ljudsegment. Uppgiften ska vara på engelska. | No | |
| svarsformat | audioResponseFormat | Definierar formatet på utdatan. | No | |
| Temperatur | number | Provtagningstemperaturen, mellan 0 och 1. Högre värden som 0,8 gör resultatet mer slumpmässigt, medan lägre värden som 0,2 gör det mer fokuserat och deterministiskt. Om den sätts till 0 använder modellen logaritmisk sannolikhet för att automatiskt öka temperaturen tills vissa tröskelvärden nås. | No | 0 |
Responses
Statuskod: 200
Beskrivning: OK
| Innehållstyp | Type | Beskrivning |
|---|---|---|
| application/json | object | |
| text/plain | string | Transkriberad text i utdataformatet (när response_format var text, vtt eller srt). |
Exempel
Example
Hämtar engelskspråkig transkriberad text och tillhörande metadata från tillhandahållen talad ljuddata.
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--"
Svar: Statuskod: 200
{
"body": {
"text": "A structured object when requesting json or verbose_json"
}
}
Example
Hämtar engelskspråkig transkriberad text och tillhörande metadata från tillhandahållen talad ljuddata.
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--"
Svar: Statuskod: 200
{
"type": "string",
"example": "plain text when requesting text, srt, or vtt"
}
Tal - Skapa
POST https://{endpoint}/openai/deployments/{deployment-id}/audio/speech?api-version=2025-04-01-preview
Genererar ljud från inmatningstexten.
URI parametrar
| Name | I | Obligatoriskt | Type | Description |
|---|---|---|---|---|
| slutpunkt | path | Ja | sträng-URL | Stödd Azure OpenAI-endpoints (protokoll och värdnamn, till exempel: https://aoairesource.openai.azure.com. Byt ut "aoairesource" mot ditt Azure OpenAI-resursnamn). https://{your-resource-name}.openai.azure.com |
| driftsättnings-id | path | Ja | string | |
| api-version | Fråga | Ja | string |
Begärandehuvud
Använd antingen tokenbaserad autentisering eller API-nyckel. Autentifikation med tokenbaserad autentisering rekommenderas och är säkrare.
| Name | Obligatoriskt | Type | Description |
|---|---|---|---|
| Authorization | True | string |
Exempel:Authorization: Bearer {Azure_OpenAI_Auth_Token}För att generera en autentiseringstoken med hjälp av Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comTyp: oauth2 Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeOmfattning: https://ai.azure.com/.default |
| API-nyckel | True | string | Tillhandahåll Azure OpenAI API-nyckel här |
Begärandekropp
Innehållstyp: flera delar/formulärdata
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| input | string | Texten för att syntetisera ljud för. Den maximala längden är 4 096 tecken. | Ja | |
| svarsformat | enum | Formatet för att syntetisera ljudet i. Möjliga värden: mp3, opus, aac, flac, wav, pcm |
No | |
| Hastighet | number | Hastigheten på det syntetiserade ljudet. Välj ett värde från 0.25 till 4.0.
1.0 är standard. |
No | 1.0 |
| Röst | enum | Rösten att använda för talsyntes. Möjliga värden: alloy, echo, fable, onyx, nova, shimmer |
Ja |
Responses
Statuskod: 200
Beskrivning: OK
| Innehållstyp | Type | Beskrivning |
|---|---|---|
| application/octet-stream | string |
Exempel
Example
Syntetiserar ljud från den medföljande texten.
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"
}
Svar: Statuskod: 200
{
"body": "101010101"
}
Bildgenereringar - Skapa
POST https://{endpoint}/openai/deployments/{deployment-id}/images/generations?api-version=2025-04-01-preview
Genererar en batch bilder från en texttext i en given bildgenereringsmodellutplacering
URI parametrar
| Name | I | Obligatoriskt | Type | Description |
|---|---|---|---|---|
| slutpunkt | path | Ja | sträng-URL | Stödd Azure OpenAI-endpoints (protokoll och värdnamn, till exempel: https://aoairesource.openai.azure.com. Byt ut "aoairesource" mot ditt Azure OpenAI-resursnamn). https://{your-resource-name}.openai.azure.com |
| driftsättnings-id | path | Ja | string | |
| api-version | Fråga | Ja | string |
Begärandehuvud
Använd antingen tokenbaserad autentisering eller API-nyckel. Autentifikation med tokenbaserad autentisering rekommenderas och är säkrare.
| Name | Obligatoriskt | Type | Description |
|---|---|---|---|
| Authorization | True | string |
Exempel:Authorization: Bearer {Azure_OpenAI_Auth_Token}För att generera en autentiseringstoken med hjälp av Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comTyp: oauth2 Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeOmfattning: https://ai.azure.com/.default |
| API-nyckel | True | string | Tillhandahåll Azure OpenAI API-nyckel här |
Begärandekropp
Innehållstyp: program/json
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| bakgrund | imageBackground | Tillåter att man kan ställa in transparens för bakgrunden på de genererade bilderna. Denna parameter stöds endast för modeller i GPT-image-1-serien. | No | bil |
| n | integer | Antalet bilder som ska genereras. För dall-e-3 stöds endast n=1. | No | 1 |
| Utdata kompression | integer | Kompressionsnivån (0–100%) för de genererade bilderna. Denna parameter stöds endast för gpt-image-1-seriemodeller med jpeg-utdataformat. | No | 100 |
| output_format | imagesOutputFormat | Filformatet i vilket de genererade bilderna returneras. Stöds endast för GPT-image-1-seriens modeller. | No | png |
| prompt | string | En textbeskrivning av den önskade bilden/bilderna. Maxlängden är 32 000 tecken för GPT-image-1-serien och 4 000 tecken för dall-e-3 | Ja | |
| delbilder | integer | Antalet delvisa bilder som ska genereras. Denna parameter används för strömmande svar som returnerar delvisa bilder. Värdet måste vara mellan 0 och 3. När det sätts till 0 kommer svaret att vara en enda bild som skickas i en strömningshändelse. Observera att den slutgiltiga bilden kan skickas innan hela antalet delvisa bilder genereras om hela bilden genereras snabbare. | 0 | |
| stream | boolean | Redigera bilden i streamingläge. | nej | false |
| kvalitet | imageQuality | Bildkvaliteten som kommer att genereras. | No | bil |
| svarsformat | imagesResponseFormat | Formatet i vilket de genererade bilderna returneras. Denna parameter stöds inte för gpt-image-1-seriemodeller som alltid returnerar base64-kodade bilder.Möjliga värden: url, b64_json. |
No | url |
| size | imageSize | Storleken på de genererade bilderna. | No | bil |
| Stil | imageStyle | Stilen på de genererade bilderna. Stöds endast för DALL-e-3. | No | Levande |
| user | string | En unik identifierare som representerar din slutanvändare, vilket kan hjälpa till att övervaka och upptäcka missbruk. | No |
Responses
Statuskod: 200
Beskrivning: Ok
| Innehållstyp | Type | Beskrivning |
|---|---|---|
| application/json | generateImagesResponse |
Statuskod: standard
Beskrivning: Ett fel uppstod.
| Innehållstyp | Type | Beskrivning |
|---|---|---|
| application/json | dalleErrorResponse |
Exempel
Example
Skapar bilder med en prompt.
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"
}
Svar: Statuskod: 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
}
}
}
]
}
}
Bildgenereringar - Redigera
POST https://{endpoint}/openai/deployments/{deployment-id}/images/edits?api-version=2025-04-01-preview
Redigerar en bild från en texttext på en given gpt-image-1-modelldistribution
URI parametrar
| Name | I | Obligatoriskt | Type | Description |
|---|---|---|---|---|
| slutpunkt | path | Ja | sträng-URL | Stödd Azure OpenAI-endpoints (protokoll och värdnamn, till exempel: https://aoairesource.openai.azure.com. Byt ut "aoairesource" mot ditt Azure OpenAI-resursnamn). https://{your-resource-name}.openai.azure.com |
| driftsättnings-id | path | Ja | string | |
| api-version | Fråga | Ja | string |
Begärandehuvud
Använd antingen tokenbaserad autentisering eller API-nyckel. Autentifikation med tokenbaserad autentisering rekommenderas och är säkrare.
| Name | Obligatoriskt | Type | Description |
|---|---|---|---|
| Authorization | True | string |
Exempel:Authorization: Bearer {Azure_OpenAI_Auth_Token}För att generera en autentiseringstoken med hjälp av Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comTyp: oauth2 Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeOmfattning: https://ai.azure.com/.default |
| API-nyckel | True | string | Tillhandahåll Azure OpenAI API-nyckel här |
Begärandekropp
Innehållstyp: flera delar/formulärdata
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| bild | Sträng eller array | Bilden/bilderna att redigera. Det måste vara en stödd bildfil eller en array av bilder. Varje bild bör vara en png- eller jpg-fil mindre än 50MB. | Ja | |
| input_fidelity | string | Kontrollera hur mycket ansträngning modellen lägger ner för att matcha stilen och dragen, särskilt ansiktsdragen, i inmatade bilder. Denna parameter stöds endast för modeller i GPT-image-1-serien. Stöd high och low. |
nej |
low. |
| mask | string | En extra bild vars helt transparenta områden (t.ex. där alfa är noll) anger var bilden ska redigeras. Om det finns flera bilder som tillhandahålls, appliceras masken på den första bilden. Det måste vara en giltig PNG-fil, mindre än 4MB, och ha samma dimensioner som bilden. | No | |
| n | integer | Antalet bilder som ska genereras. Det måste vara mellan 1 och 10. | No | 1 |
| prompt | string | En textbeskrivning av den önskade bilden/bilderna. Den maximala längden är 32 000 tecken. | Ja | |
| kvalitet | imageQuality | Bildkvaliteten som kommer att genereras. | No | bil |
| delbilder | Antalet delvisa bilder som ska genereras. Denna parameter används för strömmande svar som returnerar delvisa bilder. Värdet måste vara mellan 0 och 3. När det sätts till 0 kommer svaret att vara en enda bild som skickas i en strömningshändelse. Observera att den slutgiltiga bilden kan skickas innan hela antalet delvisa bilder genereras om hela bilden genereras snabbare. | |||
| stream | boolean | Redigera bilden i streamingläge. | nej | false |
| svarsformat | imagesResponseFormat | Formatet i vilket de genererade bilderna returneras. | No | url |
| size | imageSize | Storleken på de genererade bilderna. | No | bil |
| user | string | En unik identifierare som representerar din slutanvändare, vilket kan hjälpa till att övervaka och upptäcka missbruk. | No |
Responses
Statuskod: 200
Beskrivning: Ok
| Innehållstyp | Type | Beskrivning |
|---|---|---|
| application/json | generateImagesResponse |
Statuskod: standard
Beskrivning: Ett fel uppstod.
| Innehållstyp | Type | Beskrivning |
|---|---|---|
| application/json | dalleErrorResponse |
Components
Schemadefinitioner som används av chatt, slutföranden, inbäddningar, svar och andra textåtgärder finns i referensen Azure OpenAI REST API. Följande scheman stöder bild- och ljudåtgärderna på den här sidan.
innerErrorCode
Felkoder för det inre felobjektet.
| Fastighet | Value |
|---|---|
| Beskrivning | Felkoder för det inre felobjektet. |
| Type | string |
| Värden | ResponsibleAIPolicyViolation |
dalleErrorResponse
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| fel | dalleError | No |
dalleError
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| inner_error | dalleInnerError | Inre fel med ytterligare detaljer. | No | |
| Param | string | No | ||
| type | string | No |
dalleInnerError
Inre fel med ytterligare detaljer.
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| kod | innerErrorCode | Felkoder för det inre felobjektet. | No | |
| content_filter_results | dalleFilterResults | Information om innehållsfiltreringskategorin (hat, sexuell, våld, self_harm), om den har upptäckts, samt allvarlighetsgraden (very_low, låg, medel, hög skala som avgör intensiteten och risknivån för skadligt innehåll) och om den har filtrerats eller inte. Information om jailbreak-innehåll och svordomar, om det har upptäckts och om det har filtrerats eller inte. Och information om kundblockeringslistan, om den har filtrerats och dess ID. | No | |
| Omarbetad uppmaning | string | Prompten som användes för att generera bilden, om det fanns någon revidering av prompten. | No |
innehållsfilterallvarlighetsresultat
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| Filtrerade | boolean | Ja | ||
| severity | string | No |
Resultat för innehållsfilter upptäckt
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| Upptäckt | boolean | No | ||
| Filtrerade | boolean | Ja |
contentFilterDetailedResults
Innehållsfiltrering ger en detalj av innehållsfilter-id:n för de filtrerade segmenten.
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| Detaljer | array | No | ||
| Filtrerade | boolean | Ja |
dalleFilterResults
Information om innehållsfiltreringskategorin (hat, sexuell, våld, self_harm), om den har upptäckts, samt allvarlighetsgraden (very_low, låg, medel, hög skala som avgör intensiteten och risknivån för skadligt innehåll) och om den har filtrerats eller inte. Information om jailbreak-innehåll och svordomar, om det har upptäckts och om det har filtrerats eller inte. Och information om kundblockeringslistan, om den har filtrerats och dess ID.
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| custom_blocklists | contentFilterDetailedResults | Innehållsfiltrering ger en detalj av innehållsfilter-id:n för de filtrerade segmenten. | No | |
| Hatar | innehållsfilterAlvarlighetsResultat | No | ||
| Jailbreak | innehållsfilterdetekteratresultat | No | ||
| Svordomar | innehållsfilterdetekteratresultat | No | ||
| self_harm | innehållsfilterAlvarlighetsResultat | No | ||
| Sexuella | innehållsfilterAlvarlighetsResultat | No | ||
| Våld | innehållsfilterAlvarlighetsResultat | No |
audioResponseFormat
Definierar formatet på utdatan.
| Fastighet | Value |
|---|---|
| Beskrivning | Definierar formatet på utdatan. |
| Type | string |
| Värden | jsontextsrtverbose_jsonvtt |
bildkvalitet
Bildkvaliteten som kommer att genereras.
| Fastighet | Value |
|---|---|
| Beskrivning | Bildkvaliteten som kommer att genereras. |
| Type | string |
| Standardvärde | bil |
| Värden | autohighmediumlowhdstandard |
imagesResponseFormat
Formatet i vilket de genererade bilderna returneras.
| Fastighet | Value |
|---|---|
| Beskrivning | Formatet i vilket de genererade bilderna returneras. |
| Type | string |
| Standardvärde | url |
| Värden | urlb64_json |
imagesOutputFormat
Filformatet i vilket de genererade bilderna returneras. Stöds endast för seriemodeller.
| Fastighet | Value |
|---|---|
| Beskrivning | Filformatet i vilket de genererade bilderna returneras. Stöds endast för GPT-image-1-seriens modeller. |
| Type | string |
| Standardvärde | png |
| Värden | pngjpeg |
imageSize
Storleken på de genererade bilderna.
| Fastighet | Value |
|---|---|
| Beskrivning | Storleken på de genererade bilderna. |
| Type | string |
| Standardvärde | bil |
| Värden | auto1792x10241024x17921024x10241024x15361536x1024 |
imageStyle
Stilen på de genererade bilderna. Stöds endast för DALL-e-3.
| Fastighet | Value |
|---|---|
| Beskrivning | Stilen på de genererade bilderna. Stöds endast för DALL-e-3. |
| Type | string |
| Standardvärde | Levande |
| Värden | vividnatural |
imageBackground
Tillåter att ställa in transparens för bakgrunden i den genererade bilden/bilderna. Denna parameter stöds endast för modeller i GPT-image-1-serien.
| Fastighet | Value |
|---|---|
| Beskrivning | Tillåter att ställa in transparens för bakgrunden i den genererade bilden/bilderna. Denna parameter stöds endast för modeller i GPT-image-1-serien. |
| Type | string |
| Standardvärde | bil |
| Värden | transparentopaqueauto |
skapaBildsvar
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| Skapad | integer | Unix-tidsstämpeln när operationen skapades. | Ja | |
| data | array | Resultatdata för operationen, om den lyckas | Ja | |
| användning | imageGenerationsUsage | Representerar tokenanvändningsdetaljer för bildgenereringsförfrågningar. Endast för GPT-image-1-seriens modeller. | No |
imageGenerationsUsage
Representerar tokenanvändningsdetaljer för bildgenereringsförfrågningar. Endast för GPT-image-1-seriens modeller.
| Name | Type | Description | Obligatoriskt | Standardinställning |
|---|---|---|---|---|
| input_tokens | integer | Antalet inmatningstokens. | No | |
| input_tokens_details | object | En detaljerad genomgång av inmatningstokens. | No | |
| └– image_tokens | integer | Antalet bildtokens. | No | |
| └– text_tokens | integer | Antalet texttokens. | No | |
| output_tokens | integer | Antalet utmatningstokens. | No | |
| total_tokens | integer | Det totala antalet använda tokens. | No |
Nästa steg
Lär dig mer om modeller och finjustering med REST-API:et. Läs mer om underlying modeller som driver Azure OpenAI.