Azure REST API-referens för OpenAI-avbildning och ljud (2025-04-01-preview)

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-key HTTP-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 Authorization header. Den givna token måste föregås av Bearer, till exempel Bearer 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.com

Typ: oauth2
Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Omfattning: 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.com

Typ: oauth2
Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Omfattning: 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.com

Typ: oauth2
Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Omfattning: 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.com

Typ: oauth2
Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Omfattning: 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.com

Typ: oauth2
Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Omfattning: 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 json
text
srt
verbose_json
vtt

bildkvalitet

Bildkvaliteten som kommer att genereras.

Fastighet Value
Beskrivning Bildkvaliteten som kommer att genereras.
Type string
Standardvärde bil
Värden auto
high
medium
low
hd
standard

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 url
b64_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 png
jpeg

imageSize

Storleken på de genererade bilderna.

Fastighet Value
Beskrivning Storleken på de genererade bilderna.
Type string
Standardvärde bil
Värden auto
1792x1024
1024x1792
1024x1024
1024x1536
1536x1024

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 vivid
natural

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 transparent
opaque
auto

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.