Azure riferimento all'API REST audio e all'immagine OpenAI (2025-04-01-preview)

Questo articolo illustra le operazioni dell'API REST di inferenza del piano dati di generazione e audio (voce) per Azure OpenAI nella 2025-04-01-preview versione. Per i completamenti delle chat, incorporamenti, assistenti, risposte, archivi vettoriali e tutte le altre operazioni, vedere il riferimento ufficiale Azure API REST OpenAI.

Specifiche API

La gestione e l'interazione con i modelli e le risorse OpenAI di Azure sono suddivise in tre superfici API principali:

  • Piano di controllo
  • Piano dati - authoring
  • Piano dati - inferenza

Ogni superficie/specifica API racchiude un diverso insieme di funzionalità di Azure OpenAI. Ogni API ha un proprio set unico di versioni di anteprima e di API stabili/generalmente disponibili (GA). Le uscite in anteprima tendono attualmente a seguire un ritmo mensile.

Importante

Ora esiste una nuova API di anteprima per inferenza. Scopri di più nella nostra guida al ciclo di vita delle API.

API Ultima pubblicazione di anteprima Ultima uscita di GA Specifications Description
Piano di controllo 2025-07-01-preview 2025-06-01 File di specifiche L'API del piano di controllo viene utilizzata per operazioni come la creazione di risorse, il deployment dei modelli e altri compiti di gestione delle risorse di livello superiore. Il piano di controllo regola anche cosa è possibile fare con funzionalità come Azure Resource Manager, Bicep, Terraform e interfaccia della riga di comando di Azure.
Piano dati v1 preview v1 File di specifiche L'API del piano dati controlla le operazioni di inferenza e authoring.

Authentication

Azure OpenAI fornisce due metodi di autenticazione. Puoi usare sia API Keys che Microsoft Entra ID.

  • Autenticazione della chiave API: Per questo tipo di autenticazione, tutte le richieste API devono includere la chiave API nell'intestazione api-key HTTP. Il Quickstart fornisce indicazioni su come effettuare chiamate con questo tipo di autenticazione.

  • Microsoft Entra ID: Puoi autenticare una chiamata API usando un token Microsoft Entra. I token di autenticazione sono inclusi in una richiesta come Authorization intestazione. Il token fornito deve essere preceduto da Bearer, ad esempio Bearer YOUR_AUTH_TOKEN. Puoi leggere la nostra guida pratica su autenticare con Microsoft Entra ID.

Versionamento delle API REST

Le API dei servizi sono versionate utilizzando il api-version parametro di query. Tutte le versioni seguono la struttura delle date YYYY-MM-DD. Per esempio:

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

Inferenza del piano dati

Il resto di questo articolo illustra le operazioni di immagine e audio nella versione di 2025-04-01-preview anteprima della specifica di inferenza del piano dati OpenAI Azure.

Per le operazioni relative a immagini e audio ga, vedere le informazioni di riferimento sulle API REST per immagini e audio disponibili a livello generale.

Trascrizioni - Create

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

Trascrive l'audio nella lingua di input.

Parametri dell'URI

Name In Obbligatorio Tipo Description
endpoint path Sì URL stringa Supportato Azure endpoint OpenAI (protocollo e nome host, ad esempio: https://aoairesource.openai.azure.com. Sostituisci "aoairesource" con il nome della tua risorsa Azure OpenAI). https://{nome-risorsa}.openai.azure.com
deployment-id path Sì corda
api-version quesito Sì corda

Intestazione della richiesta

Usa l'autenticazione basata su token o la chiave API. L'autenticazione con token è raccomandata e più sicura.

Name Obbligatorio Tipo Description
Autorizzazione Vero corda Esempio:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Per generare un token di autenticazione usando interfaccia della riga di comando di Azure: az account get-access-token --resource https://cognitiveservices.azure.com

Tipo: oauth2
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Ambito: https://ai.azure.com/.default
api-key Vero corda Fornisci qui la chiave API di Azure OpenAI

Corpo della richiesta

Tipo di contenuto: multipart/form-data

Name Tipo Description Obbligatorio Predefinito
model corda ID del modello da utilizzare. Le opzioni sono gpt-4o-transcribe, gpt-4o-mini-transcribe, gpt-4o-mini-transcribe-2025-12-15, whisper-1, e gpt-4o-transcribe-diarize. Sì
file corda Il file audio oggetto da trascrivere. Sì
Lingua corda Il linguaggio dell'audio in ingresso. Fornire il linguaggio di input in formato ISO-639-1 migliora accuratezza e latenza. No
prompt corda Un testo opzionale per guidare lo stile del modello o continuare un segmento audio precedente. Il prompt dovrebbe corrispondere al linguaggio audio. No
formato_risposta audioResponseFormat Definisce il formato dell'output. No
Temperatura number La temperatura di campionamento, compresa tra 0 e 1. Valori più alti come 0,8 rendono l'output più casuale, mentre valori più bassi come 0,2 lo rendono più focalizzato e deterministico. Se impostato a 0, il modello utilizza la probabilità logaritmica per aumentare automaticamente la temperatura fino a raggiungere certe soglie. No 0
timestamp_granularities[] array Le granularità del timestamp da popolare per questa trascrizione. response_format deve essere impostato verbose_json per utilizzare granularità di timestamp. Una o entrambe queste opzioni sono supportate: word, oppure segment. Nota: Non c'è latenza aggiuntiva per i timestamp dei segmenti, ma generare timestamp di parole comporta latenza aggiuntiva. No ['segment']

Responses

Codice di stato: 200

Descrizione: OK

Tipo di contenuto Type Descrizione
application/json object
testo/puro corda Testo trascritto nel formato di output (quando response_format era uno di text, vtt o srt).

Esempi

Example

Ottiene testo trascritto e metadati associati dai dati audio parlati forniti.

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

Risposte: Codice di stato: 200

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

Example

Ottiene testo trascritto e metadati associati dai dati audio parlati forniti.

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

Risposte: Codice di stato: 200

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

Traduzioni - Create

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

Trascrive e traduce l'audio in ingresso in testo inglese.

Parametri dell'URI

Name In Obbligatorio Tipo Description
endpoint path Sì URL stringa Supportato Azure endpoint OpenAI (protocollo e nome host, ad esempio: https://aoairesource.openai.azure.com. Sostituisci "aoairesource" con il nome della tua risorsa Azure OpenAI). https://{nome-risorsa}.openai.azure.com
deployment-id path Sì corda
api-version quesito Sì corda

Intestazione della richiesta

Usa l'autenticazione basata su token o la chiave API. L'autenticazione con token è raccomandata e più sicura.

Name Obbligatorio Tipo Description
Autorizzazione Vero corda Esempio:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Per generare un token di autenticazione usando interfaccia della riga di comando di Azure: az account get-access-token --resource https://cognitiveservices.azure.com

Tipo: oauth2
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Ambito: https://ai.azure.com/.default
api-key Vero corda Fornisci qui la chiave API di Azure OpenAI

Corpo della richiesta

Tipo di contenuto: multipart/form-data

Name Tipo Description Obbligatorio Predefinito
file corda Il file audio da tradurre. Sì
prompt corda Un testo opzionale per guidare lo stile del modello o continuare un segmento audio precedente. Il prompt dovrebbe essere in inglese. No
formato_risposta audioResponseFormat Definisce il formato dell'output. No
Temperatura number La temperatura di campionamento, compresa tra 0 e 1. Valori più alti come 0,8 rendono l'output più casuale, mentre valori più bassi come 0,2 lo rendono più focalizzato e deterministico. Se impostato a 0, il modello utilizza la probabilità logaritmica per aumentare automaticamente la temperatura fino a raggiungere certe soglie. No 0

Responses

Codice di stato: 200

Descrizione: OK

Tipo di contenuto Type Descrizione
application/json object
testo/puro corda Testo trascritto nel formato di output (quando response_format era uno di testo, vtt o srt).

Esempi

Example

Ottiene testo trascritto in inglese e i metadati associati dai dati audio parlati forniti.

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

Risposte: Codice di stato: 200

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

Example

Ottiene testo trascritto in inglese e i metadati associati dai dati audio parlati forniti.

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

Risposte: Codice di stato: 200

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

Parlato - Crea

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

Genera audio dal testo di input.

Parametri dell'URI

Name In Obbligatorio Tipo Description
endpoint path Sì URL stringa Supportato Azure endpoint OpenAI (protocollo e nome host, ad esempio: https://aoairesource.openai.azure.com. Sostituisci "aoairesource" con il nome della tua risorsa Azure OpenAI). https://{nome-risorsa}.openai.azure.com
deployment-id path Sì corda
api-version quesito Sì corda

Intestazione della richiesta

Usa l'autenticazione basata su token o la chiave API. L'autenticazione con token è raccomandata e più sicura.

Name Obbligatorio Tipo Description
Autorizzazione Vero corda Esempio:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Per generare un token di autenticazione usando interfaccia della riga di comando di Azure: az account get-access-token --resource https://cognitiveservices.azure.com

Tipo: oauth2
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Ambito: https://ai.azure.com/.default
api-key Vero corda Fornisci qui la chiave API di Azure OpenAI

Corpo della richiesta

Tipo di contenuto: multipart/form-data

Name Tipo Description Obbligatorio Predefinito
input corda Il testo per sintetizzare l'audio. La lunghezza massima è di 4.096 caratteri. Sì
formato_risposta enum Il formato in cui sintetizzare l'audio.
Valori possibili: mp3, opus, aac, flac, wav, pcm		 No
speed number La velocità dell'audio sintetizzato. Seleziona un valore da 0.25 a 4.0. 1.0 è la norma predefinita. No 1.0
Voce enum La voce da usare per la sintesi vocale.
Valori possibili: alloy, echo, fable, onyx, nova, shimmer		 Sì

Responses

Codice di stato: 200

Descrizione: OK

Tipo di contenuto Type Descrizione
application/octet-stream corda

Esempi

Example

Sintetizza audio dal testo fornito.

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

Risposte: Codice di stato: 200

{
  "body": "101010101"
}

Generazioni immagini - Create

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

Genera un lotto di immagini da una didascalia testuale su una data distribuzione di modelli di generazione di immagini

Parametri dell'URI

Name In Obbligatorio Tipo Description
endpoint path Sì URL stringa Supportato Azure endpoint OpenAI (protocollo e nome host, ad esempio: https://aoairesource.openai.azure.com. Sostituisci "aoairesource" con il nome della tua risorsa Azure OpenAI). https://{nome-risorsa}.openai.azure.com
deployment-id path Sì corda
api-version quesito Sì corda

Intestazione della richiesta

Usa l'autenticazione basata su token o la chiave API. L'autenticazione con token è raccomandata e più sicura.

Name Obbligatorio Tipo Description
Autorizzazione Vero corda Esempio:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Per generare un token di autenticazione usando interfaccia della riga di comando di Azure: az account get-access-token --resource https://cognitiveservices.azure.com

Tipo: oauth2
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Ambito: https://ai.azure.com/.default
api-key Vero corda Fornisci qui la chiave API di Azure OpenAI

Corpo della richiesta

Content-Type: application/json

Name Tipo Description Obbligatorio Predefinito
sfondo imageBackground Permette di impostare trasparenza per lo sfondo delle immagini generate. Questo parametro è supportato solo per i modelli serie gpt-image-1. No auto
n Intero Il numero di immagini da generare. Per dall-e-3, è supportato solo n=1. No 1
Compressione dell'output Intero Il livello di compressione (0-100%) per le immagini generate. Questo parametro è supportato solo per modelli della serie gpt-image-1 con il formato di uscita jpeg. No 100
formato_di_output imagesOutputFormat Il formato file in cui vengono restituite le immagini generate. Supportato solo per i modelli della serie GPT-image-1. No png
prompt corda Una descrizione testuale dell'immagine desiderata. La lunghezza massima è di 32.000 caratteri per la serie gpt-image-1 e 4.000 caratteri per la dall-e-3 Sì
immagini parziali Intero Il numero di immagini parziali da generare. Questo parametro viene utilizzato per le risposte in streaming che restituiscono immagini parziali. Il valore deve essere compreso tra 0 e 3. Quando impostato a 0, la risposta sarà una singola immagine inviata in un evento di streaming. Si noti che l'immagine finale può essere inviata prima che venga generata l'intero numero di immagini parziali se l'immagine completa viene generata più rapidamente. 0
stream Boolean Modifica l'immagine in modalità streaming. no false
qualità imageQuality La qualità dell'immagine che verrà generata. No auto
formato_risposta imagesResponseFormat Il formato in cui vengono restituite le immagini generate. Questo parametro non è supportato per gpt-image-1i modelli in serie che restituiscono sempre immagini codificate in base64.
Valori possibili: url, b64_json.		 No Url
size imageSize La dimensione delle immagini generate. No auto
Stile imageStyle Lo stile delle immagini generate. Supportato solo per DALL-E-3. No vivid
user corda Un identificatore unico che rappresenta il tuo utente finale, che può aiutare a monitorare e rilevare abusi. No

Responses

Codice di stato: 200

Descrizione: Ok

Tipo di contenuto Type Descrizione
application/json generateImagesResponse

Codice di stato: predefinito

Descrizione: Si è verificato un errore.

Tipo di contenuto Type Descrizione
application/json dalleErrorResponse

Esempi

Example

Crea immagini con un 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"
}

Risposte: Codice di stato: 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
          }
        }
      }
    ]
  }
}

Generazioni immagini - Modifica

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

Modifica un'immagine da una didascalia di testo su un dato deployment di modello gpt-image-1

Parametri dell'URI

Name In Obbligatorio Tipo Description
endpoint path Sì URL stringa Supportato Azure endpoint OpenAI (protocollo e nome host, ad esempio: https://aoairesource.openai.azure.com. Sostituisci "aoairesource" con il nome della tua risorsa Azure OpenAI). https://{nome-risorsa}.openai.azure.com
deployment-id path Sì corda
api-version quesito Sì corda

Intestazione della richiesta

Usa l'autenticazione basata su token o la chiave API. L'autenticazione con token è raccomandata e più sicura.

Name Obbligatorio Tipo Description
Autorizzazione Vero corda Esempio:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Per generare un token di autenticazione usando interfaccia della riga di comando di Azure: az account get-access-token --resource https://cognitiveservices.azure.com

Tipo: oauth2
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Ambito: https://ai.azure.com/.default
api-key Vero corda Fornisci qui la chiave API di Azure OpenAI

Corpo della richiesta

Tipo di contenuto: multipart/form-data

Name Tipo Description Obbligatorio Predefinito
immagine stringa o array L'immagine o le immagini da modificare. Deve essere un file immagine supportato o un array di immagini. Ogni immagine dovrebbe essere un file png o jpg inferiore a 50MB. Sì
fedeltà dell'input corda Controlla quanto sforzo il modello applicherà per adattarsi allo stile e alle caratteristiche, soprattutto ai tratti facciali, delle immagini di input. Questo parametro è supportato solo per i modelli serie gpt-image-1. Supporti high e low. no low.
mask corda Un'immagine aggiuntiva le cui aree completamente trasparenti (ad esempio, dove alfa è zero) indica dove l'immagine dovrebbe essere modificata. Se sono fornite più immagini, la maschera verrà applicata alla prima immagine. Deve essere un file PNG valido, inferiore a 4MB, e avere le stesse dimensioni dell'immagine. No
n Intero Il numero di immagini da generare. Deve essere tra 1 e 10. No 1
prompt corda Una descrizione testuale dell'immagine desiderata. La lunghezza massima è di 32000 caratteri. Sì
qualità imageQuality La qualità dell'immagine che verrà generata. No auto
immagini parziali Il numero di immagini parziali da generare. Questo parametro viene utilizzato per le risposte in streaming che restituiscono immagini parziali. Il valore deve essere compreso tra 0 e 3. Quando impostato a 0, la risposta sarà una singola immagine inviata in un evento di streaming. Si noti che l'immagine finale può essere inviata prima che venga generata l'intero numero di immagini parziali se l'immagine completa viene generata più rapidamente.
stream Boolean Modifica l'immagine in modalità streaming. no false
formato_risposta imagesResponseFormat Il formato in cui vengono restituite le immagini generate. No Url
size imageSize La dimensione delle immagini generate. No auto
user corda Un identificatore unico che rappresenta il tuo utente finale, che può aiutare a monitorare e rilevare abusi. No

Responses

Codice di stato: 200

Descrizione: Ok

Tipo di contenuto Type Descrizione
application/json generateImagesResponse

Codice di stato: predefinito

Descrizione: Si è verificato un errore.

Tipo di contenuto Type Descrizione
application/json dalleErrorResponse

Components

Per le definizioni di schema usate da chat, completamenti, incorporamenti, risposte e altre operazioni di testo, vedere le informazioni di riferimento sull'API REST OpenAI Azure. Gli schemi seguenti supportano le operazioni di immagine e audio in questa pagina.

innerErrorCode

Codici di errore per l'oggetto di errore interno.

Proprietà Value
Descrizione Codici di errore per l'oggetto di errore interno.
Type corda
Valori ResponsibleAIPolicyViolation

dalleErrorResponse

Name Tipo Description Obbligatorio Predefinito
Errore dalleError No

dalleError

Name Tipo Description Obbligatorio Predefinito
inner_error dalleInnerError Errore interiore con ulteriori dettagli. No
param corda No
type corda No

dalleInnerError

Errore interiore con ulteriori dettagli.

Name Tipo Description Obbligatorio Predefinito
codice innerErrorCode Codici di errore per l'oggetto di errore interno. No
content_filter_results dalleFilterResults Informazioni sulla categoria di filtraggio dei contenuti (odio, sessuale, violenza, self_harm), se è stata rilevata, nonché sul livello di gravità (scala very_low, bassa, media, alta che determina l'intensità e il livello di rischio dei contenuti dannosi) e se è stata filtrata o meno. Informazioni sui contenuti e le parolacce del jailbreak, se sono stati rilevati e se sono stati filtrati o meno. E informazioni sulla lista dei clienti bloccati, se è stata filtrata e il suo ID. No
testo_rivisto corda Il prompt usato per generare l'immagine, se c'era stata una revisione del prompt. No

contentFilterSeverityResult

Name Tipo Description Obbligatorio Predefinito
filtered Boolean Sì
Gravità corda No

contentFilterDetectedResult

Name Tipo Description Obbligatorio Predefinito
detected Boolean No
filtered Boolean Sì

contentFilterDetailedResults

Il filtraggio dei contenuti risulta con un dettaglio degli ID dei filtri di contenuto per i segmenti filtrati.

Name Tipo Description Obbligatorio Predefinito
details array No
filtered Boolean Sì

dalleFilterResults

Informazioni sulla categoria di filtraggio dei contenuti (odio, sessuale, violenza, self_harm), se è stata rilevata, nonché sul livello di gravità (scala very_low, bassa, media, alta che determina l'intensità e il livello di rischio dei contenuti dannosi) e se è stata filtrata o meno. Informazioni sui contenuti e le parolacce del jailbreak, se sono stati rilevati e se sono stati filtrati o meno. E informazioni sulla lista dei clienti bloccati, se è stata filtrata e il suo ID.

Name Tipo Description Obbligatorio Predefinito
custom_blocklists contentFilterDetailedResults Il filtraggio dei contenuti risulta con un dettaglio degli ID dei filtri di contenuto per i segmenti filtrati. No
hate contentFilterSeverityResult No
jailbreak contentFilterDetectedResult No
profanity contentFilterDetectedResult No
self_harm contentFilterSeverityResult No
sexual contentFilterSeverityResult No
violence contentFilterSeverityResult No

audioResponseFormat

Definisce il formato dell'output.

Proprietà Value
Descrizione Definisce il formato dell'output.
Type corda
Valori json
text
srt
verbose_json
vtt

imageQuality

La qualità dell'immagine che verrà generata.

Proprietà Value
Descrizione La qualità dell'immagine che verrà generata.
Type corda
Predefinita auto
Valori auto
high
medium
low
hd
standard

imagesResponseFormat

Il formato in cui vengono restituite le immagini generate.

Proprietà Value
Descrizione Il formato in cui vengono restituite le immagini generate.
Type corda
Predefinita Url
Valori url
b64_json

imagesOutputFormat

Il formato file in cui vengono restituite le immagini generate. Supportato solo per i modelli di serie.

Proprietà Value
Descrizione Il formato file in cui vengono restituite le immagini generate. Supportato solo per i modelli della serie GPT-image-1.
Type corda
Predefinita png
Valori png
jpeg

imageSize

La dimensione delle immagini generate.

Proprietà Value
Descrizione La dimensione delle immagini generate.
Type corda
Predefinita auto
Valori auto
1792x1024
1024x1792
1024x1024
1024x1536
1536x1024

imageStyle

Lo stile delle immagini generate. Supportato solo per DALL-E-3.

Proprietà Value
Descrizione Lo stile delle immagini generate. Supportato solo per DALL-E-3.
Type corda
Predefinita vivid
Valori vivid
natural

imageBackground

Permette di impostare trasparenza per lo sfondo dell'immagine o delle immagini generate. Questo parametro è supportato solo per i modelli serie gpt-image-1.

Proprietà Value
Descrizione Permette di impostare trasparenza per lo sfondo dell'immagine o delle immagini generate. Questo parametro è supportato solo per i modelli serie gpt-image-1.
Type corda
Predefinita auto
Valori transparent
opaque
auto

generateImagesResponse

Name Tipo Description Obbligatorio Predefinito
creato Intero Il timestamp di unix quando è stata creata l'operazione. Sì
Dati array I dati di risultato dell'operazione, se riusciti Sì
uso imageGenerationsUsage Rappresenta i dettagli di utilizzo dei token per le richieste di generazione delle immagini. Solo per modelli della serie GPT-image-1. No

imageGenerationsUsage

Rappresenta i dettagli di utilizzo dei token per le richieste di generazione delle immagini. Solo per modelli della serie GPT-image-1.

Name Tipo Description Obbligatorio Predefinito
input_tokens Intero Il numero di token di input. No
input_tokens_details object Una suddivisione dettagliata dei token di input. No
└ image_tokens Intero Il numero di token immagine. No
└ text_tokens Intero Il numero di gettoni di testo. No
output_tokens Intero Il numero di token di output. No
total_tokens Intero Il numero totale di gettoni utilizzati. No

Passaggi successivi

Informazioni sui modelli e sull'ottimizzazione con l'API REST. Scopri di più sui modelli sottostante che alimentano Azure OpenAI.

  • Last updated on