Azure Riferimento all'anteprima dell'API REST di OpenAI nei modelli di Microsoft Foundry v1

Questo articolo fornisce informazioni dettagliate sugli endpoint dell'API REST di inferenza per Azure OpenAI.

Inferenza del piano dati

Il resto dell'articolo illustra la nuova versione dell'API di anteprima v1 della specifica di inferenza del piano dati OpenAI Azure. Per altre informazioni, vedere la guida al ciclo di vita dell'API.

Se si sta cercando documentazione sulla versione più recente dell'API GA v1, vedere l'API di inferenza del piano dati con disponibilità generale più recente

Creare il riconoscimento vocale

POST {endpoint}/openai/v1/audio/speech?api-version=preview

Genera l'audio sintesi vocale dal testo di input.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Microsoft Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Tipo di contenuto: multipart/form-data

Nome	TIPO	Descrzione	Obbligatorio	Default
ingresso	corda	Testo per cui generare l'audio. La lunghezza massima è di 4096 caratteri.	Sì
instructions	corda	Controllare la voce dell'audio generato con istruzioni aggiuntive. Non funziona con `tts-1` o `tts-1-hd`.	NO
model	corda	Modello da usare per questa richiesta di sintesi vocale.	Sì
formato_risposta	oggetto	Formati di output audio supportati per la sintesi vocale.	NO
speed	numero	Velocità del parlato per l'audio generato. I valori sono validi nell'intervallo compreso tra 0,25 e 4.0, con 1.0 i valori predefiniti e superiori corrispondenti alla voce più veloce.	NO	1
stream_format	enum	Formato in cui trasmettere l'audio. I formati supportati sono `sse` e `audio`. `sse` non è supportato per `tts-1` o `tts-1-hd`. Valori possibili: `sse`, `audio`	NO
voice	oggetto		Sì

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/octet-stream	corda

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Esempi

Example

Sintetizza l'audio dal testo fornito.

POST {endpoint}/openai/v1/audio/speech?api-version=preview

{
 "input": "Hi! What are you going to make?",
 "voice": "fable",
 "response_format": "mp3",
 "model": "tts-1"
}

Risposte: Codice di stato: 200

{
  "body": "101010101"
}

Creare la trascrizione

POST {endpoint}/openai/v1/audio/transcriptions?api-version=preview

Trascrive l'audio nella lingua di input.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Tipo di contenuto: multipart/form-data

Nome	TIPO	Descrzione	Obbligatorio	Default
chunking_strategy	oggetto		NO
└prefix_padding_ms	numero intero	Quantità di audio da includere prima del riconoscimento vocale rilevato da VAD (in millisecondi).	NO	300
└durata_silenzio_ms	numero intero	Durata del silenzio per rilevare l'arresto vocale (in millisecondi). Con valori più brevi, il modello risponderà più rapidamente, ma potrebbe attivarsi durante le brevi pause dell'utente.	NO	200
└* soglia	numero	Soglia di sensibilità (da 0,0 a 1,0) per il rilevamento delle attività vocali. Una soglia più elevata richiederà un audio più forte per attivare il modello e quindi potrebbe offrire prestazioni migliori in ambienti rumorosi.	NO	0,5
└─ Tipo	enum	Deve essere impostato su `server_vad` per abilitare la suddivisione in blocchi manuale tramite VAD sul lato server. Valori possibili: `server_vad`	NO
documento	corda		Sì
filename	corda	Nome file facoltativo o identificatore descrittivo da associare ai dati audio.	NO
include[]	array	Informazioni aggiuntive da includere nella risposta di trascrizione. `logprobs` restituirà le probabilità di log dei token nella risposta per comprendere la fiducia del modello nella trascrizione. `logprobs` funziona solo con response_format impostato su `json` e solo con i modelli `gpt-4o-transcribe`, `gpt-4o-transcribe-diarize`, `gpt-4o-mini-transcribe`e `gpt-4o-mini-transcribe-2025-12-15`.	NO
language	corda	La lingua dell'audio di input. Specificare il linguaggio di input nel formato ISO-639-1 (ad esempio `en`) migliorerà l'accuratezza e la latenza.	NO
model	corda	Modello da usare per questa richiesta di trascrizione.	NO
prompt	corda	Testo facoltativo per guidare lo stile del modello o continuare un segmento audio precedente. La richiesta deve corrispondere alla lingua audio.	NO
formato_risposta	oggetto		NO
torrente	boolean	Se impostato su true, i dati di risposta del modello verranno trasmessi al client durante la generazione tramite eventi inviati dal server. Nota: lo streaming non è supportato per il `whisper-1` modello e verrà ignorato.	NO	Falso
temperatura	numero	Temperatura di campionamento, compresa tra 0 e 1. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. Se impostato su 0, il modello userà la probabilità di log per aumentare automaticamente la temperatura fino a raggiungere determinate soglie.	NO	0
timestamp_granularities[]	array	Granularità del timestamp da popolare per questa trascrizione. `response_format` deve essere impostato su `verbose_json` per usare le granularità del timestamp. Sono supportate entrambe le opzioni seguenti: `word` o `segment`. Nota: non esiste una latenza aggiuntiva per i timestamp dei segmenti, ma la generazione di timestamp delle parole comporta una latenza aggiuntiva.	NO	['segment']

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureAudioTranscriptionResponse
text/plain	corda

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Esempi

Example

Ottiene il testo trascritto e i metadati associati dai dati dell'audio parlato forniti.

POST {endpoint}/openai/v1/audio/transcriptions?api-version=preview

{
 "file": "<binary audio data>",
 "model": "whisper-1",
 "response_format": "text"
}

Risposte: Codice di stato: 200

{
  "body": "plain text when requesting text, srt, or vtt"
}

Crea traduzione

POST {endpoint}/openai/v1/audio/translations?api-version=preview

Ottiene il testo trascritto in lingua inglese e i metadati associati dai dati dell'audio parlato forniti.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Tipo di contenuto: multipart/form-data

Nome	TIPO	Descrzione	Obbligatorio	Default
documento	corda		Sì
filename	corda	Nome file facoltativo o identificatore descrittivo da associare ai dati audio	NO
model	corda	Modello da utilizzare per questa richiesta di traduzione.	NO
prompt	corda	Testo facoltativo per guidare lo stile del modello o continuare un segmento audio precedente. Il prompt deve essere in inglese.	NO
formato_risposta	oggetto		NO
temperatura	numero	Temperatura di campionamento, compresa tra 0 e 1. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. Se impostato su 0, il modello userà la probabilità di log per aumentare automaticamente la temperatura fino a raggiungere determinate soglie.	NO	0

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureAudioTranslationResponse
text/plain	corda

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Esempi

Example

Ottiene il testo trascritto in lingua inglese e i metadati associati dai dati dell'audio parlato forniti.

POST {endpoint}/openai/v1/audio/translations?api-version=preview

{
 "file": "<binary audio data>",
 "model": "whisper-1",
 "response_format": "text"
}

Risposte: Codice di stato: 200

{
  "body": "plain text when requesting text, srt, or vtt"
}

Creare il completamento della chat

POST {endpoint}/openai/v1/chat/completions?api-version=preview

Crea un completamento della chat.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio	Default
audio	oggetto	Parametri dell'output audio. Obbligatorio quando viene richiesto l'output audio con `modalities: ["audio"]`.	NO
└* formato	enum	Specifica il formato audio di output. Deve essere uno di `wav`, `mp3flac`, ,`opus` o `pcm16`. Valori possibili: `wav`, `aacmp3`, `flac`, , `opuspcm16`	NO
└─ voce	oggetto		NO
data_sources	array	Origini dati da usare per la funzionalità On Your Data, esclusiva per Azure OpenAI.	NO
penalità di frequenza	numero	Numero compreso tra -2.0 e 2.0. I valori positivi penalizzano i nuovi token in base alla frequenza esistente nel testo fino a quel momento, riducendo la probabilità che il modello ripeta testualmente la stessa riga.	NO	0
function_call	enum	Specificare una determinata funzione tramite `{"name": "my_function"}` impone al modello di chiamare tale funzione. Valori possibili: `none`, `auto`	NO
functions	array	Deprecato e sostituito da `tools`. Un elenco di funzioni per cui il modello può generare input JSON.	NO
bias del logit	oggetto	Modificare la probabilità che i token specificati vengano visualizzati nel completamento. Accetta un oggetto JSON che esegue il mapping dei token (specificato dal relativo ID token nel tokenizer) con un valore di distorsione associato compreso tra -100 e 100. Matematicamente, la distorsione viene aggiunta ai logits generati dal modello prima del campionamento. L'effetto esatto varia per modello, ma i valori compresi tra -1 e 1 devono diminuire o aumentare la probabilità di selezione; i valori come -100 o 100 devono comportare un divieto o una selezione esclusiva del token pertinente.	NO	None
logprobs	boolean	Indica se restituire o non restituire le probabilità di log dei token di output. Se true, restituisce le probabilità di log di ogni token di output restituito in `content` di `message`.	NO	Falso
max_completion_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per un completamento, inclusi i token di output visibili e i token di ragionamento.	NO
numero massimo di token	numero intero	Numero massimo di token che possono essere generati al momento del completamento della chat. Questo valore può essere usato per controllare i costi per il testo generato tramite API. Questo valore è ora deprecato a favore di `max_completion_tokens`e non è compatibile con i modelli di serie o1.	NO
messages	array	Elenco di messaggi che comprendono la conversazione effettuata finora. A seconda del modello usato, sono supportati diversi tipi di messaggio (modalità), ad esempio testo, immagini e audio.	Sì
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
modalities	oggetto	Tipi di output che si desidera generare il modello. La maggior parte dei modelli è in grado di generare testo, in base all'impostazione predefinita: `["text"]` Il modello `gpt-4o-audio-preview` può essere usato anche per generare audio. Per far sì che questo modello generi risposte sia di testo che audio, è possibile usare: `["text", "audio"]`	NO
model	corda	Identificatore di distribuzione del modello da usare per la richiesta di completamento della chat.	Sì
n	numero intero	Quante opzioni di completamento della chat generare per ogni messaggio di input. Tenere presente che verranno addebitati i costi in base al numero di token generati in tutte le scelte. Mantenere `n` come `1` per ridurre al minimo i costi.	NO	1
chiamate_parallele_agli_strumenti	oggetto	Indica se abilitare o meno la chiamata di funzioni parallele durante l'uso dello strumento.	NO
stima	oggetto	Rappresentazione di base dell'output stimato da un modello.	NO
└─ Tipo	OpenAI.ChatOutputPredictionType		NO
penalità_di_presenza	numero	Numero compreso tra -2.0 e 2.0. I valori positivi penalizzano i nuovi token in base al fatto che vengano visualizzati o meno nel testo fino a questo momento, aumentando la probabilità del modello di parlare di nuovi argomenti.	NO	0
sforzo di ragionamento	oggetto	Solo modelli di serie o Vincola il lavoro sul ragionamento per i modelli di ragionamento. I valori attualmente supportati sono `low`, `medium` e `high`. La riduzione del lavoro di ragionamento può tradursi in risposte più veloci e in un minor numero di token usati per il ragionamento in una risposta.	NO
formato_risposta	oggetto		NO
└─ Tipo	enum	Valori possibili: `text`, `json_object`, `json_schema`	NO
seed	numero intero	Questa funzionalità è in versione beta. Se specificato, il nostro sistema esegue un'operazione ottimale per campionare in modo deterministico, in modo che le richieste ripetute con gli stessi `seed` e gli stessi parametri restituiscano lo stesso risultato. Il determinismo non è garantito ed è necessario fare riferimento al parametro di risposta `system_fingerprint` per monitorare le modifiche nel back-end.	NO
fermare	oggetto	Non supportato con i modelli `o3` di ragionamento più recenti e `o4-mini`. Fino a 4 sequenze in cui l'API smetterà di generare altri token. Il testo restituito non conterrà la sequenza di interruzione.	NO
store	boolean	Indica se archiviare o meno l'output di questa richiesta di completamento della chat per l'uso nei prodotti di valutazione o di modellazione del modello.	NO	Falso
torrente	boolean	Se impostato su true, i dati di risposta del modello verranno trasmessi al client durante la generazione tramite eventi inviati dal server.	NO	Falso
stream_options	oggetto	Opzioni per la risposta in streaming. Impostare questa opzione solo quando si imposta `stream: true`.	NO
└─ uso_includi	boolean	Se impostato, un blocco aggiuntivo verrà trasmesso prima del messaggio `data: [DONE]`. Il campo `usage` di questo blocco mostra le statistiche di utilizzo dei token per l'intera richiesta e il campo `choices` sarà sempre una matrice vuota. Tutti gli altri blocchi includeranno anche un campo `usage`, ma con un valore null. NOTA: Se il flusso viene interrotto, è possibile che non si riceva il blocco di utilizzo finale che contiene l'utilizzo totale del token per la richiesta.	NO
temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	NO	1
tool_choice	OpenAI.ChatCompletionToolChoiceOption	Controlla quale strumento (se presente) viene chiamato dal modello. `none` indica che il modello non chiamerà alcuno strumento e genera invece un messaggio. `auto` indica che il modello può scegliere tra la generazione di un messaggio o la chiamata di uno o più strumenti. `required` indica che il modello deve chiamare uno o più strumenti. Se si specifica uno strumento specifico tramite `{"type": "function", "function": {"name": "my_function"}}` impone al modello di chiamare tale strumento. `none` è l'impostazione predefinita quando non sono presenti strumenti. `auto` è l'impostazione predefinita quando sono presenti strumenti.	NO
strumenti	array	Elenco di strumenti che il modello può chiamare. Attualmente, solo le funzioni sono supportate come strumento. Usare questa opzione per fornire un elenco di funzioni per cui il modello può generare input JSON. Sono supportate al massimo 128 funzioni.	NO
top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	NO	1
utente	corda	Identificatore univoco che rappresenta l’utente finale, che consente di monitorare e rilevare un abuso.	NO
user_security_context	AzureUserSecurityContext	Il contesto di sicurezza utente contiene diversi parametri che descrivono l'applicazione stessa e l'utente finale che interagisce con l'applicazione. Questi campi sono utili al team delle operazioni per la sicurezza per analizzare e mitigare gli incidenti di sicurezza fornendo un approccio esaustivo alla protezione delle applicazioni IA. Altre informazioni sulla protezione delle applicazioni di intelligenza artificiale tramite Microsoft Defender for Cloud.	NO

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureCreateChatCompletionResponse
text/event-stream	AzureCreateChatCompletionStreamResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Esempi

Example

Crea un completamento per i prompt forniti, i parametri e il modello scelto.

POST {endpoint}/openai/v1/chat/completions?api-version=preview

{
 "model": "gpt-4o-mini",
 "messages": [
  {
   "role": "system",
   "content": "you are a helpful assistant that talks like a pirate"
  },
  {
   "role": "user",
   "content": "can you tell me how to care for a parrot?"
  }
 ]
}

Risposte: Codice di stato: 200

{
  "body": {
    "id": "chatcmpl-7R1nGnsXO8n4oi9UPz2f3UHdgAYMn",
    "created": 1686676106,
    "choices": [
      {
        "index": 0,
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": "Ahoy matey! So ye be wantin' to care for a fine squawkin' parrot, eh?..."
        }
      }
    ],
    "usage": {
      "completion_tokens": 557,
      "prompt_tokens": 33,
      "total_tokens": 590
    }
  }
}

Creare incorporazione

POST {endpoint}/openai/v1/embeddings?api-version=preview

Crea un vettore di incorporamento che rappresenta il testo di input.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio
dimensions	numero intero	Numero di dimensioni che devono essere presenti negli incorporamenti di output risultanti. Supportato solo in `text-embedding-3` e modelli successivi.	NO
encoding_format	enum	Formato in cui restituire gli incorporamenti. Può essere `float` o `base64`. Valori possibili: `float`, `base64`	NO
ingresso	stringa o matrice		Sì
model	corda	Modello da usare per la richiesta di incorporamento.	Sì
utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.CreateEmbeddingResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Esempi

Example

Restituisce gli incorporamenti per un prompt specificato.

POST {endpoint}/openai/v1/embeddings?api-version=preview

{
 "model": "text-embedding-ada-002",
 "input": [
  "this is a test"
 ]
}

Risposte: Codice di stato: 200

{
  "body": {
    "data": [
      {
        "index": 0,
        "embedding": [
          -0.012838088,
          -0.007421397,
          -0.017617522,
          -0.028278312,
          -0.018666342,
          0.01737855,
          -0.01821495,
          -0.006950092,
          -0.009937238,
          -0.038580645,
          0.010674067,
          0.02412286,
          -0.013647936,
          0.013189907,
          0.0021125758,
          0.012406612,
          0.020790534,
          0.00074595667,
          0.008397198,
          -0.00535031,
          0.008968075,
          0.014351576,
          -0.014086051,
          0.015055214,
          -0.022211088,
          -0.025198232,
          0.0065186154,
          -0.036350243,
          0.009180495,
          -0.009698266,
          0.009446018,
          -0.008463579,
          -0.0040426035,
          -0.03443847,
          -0.00091273896,
          -0.0019217303,
          0.002349888,
          -0.021560553,
          0.016515596,
          -0.015572986,
          0.0038666942,
          -8.432463e-05,
          0.0032178196,
          -0.020365695,
          -0.009631885,
          -0.007647093,
          0.0033837722,
          -0.026764825,
          -0.010501476,
          0.020219658,
          0.024640633,
          -0.0066912062,
          -0.036456455,
          -0.0040923897,
          -0.013966565,
          0.017816665,
          0.005366905,
          0.022835068,
          0.0103488,
          -0.0010811808,
          -0.028942121,
          0.0074280356,
          -0.017033368,
          0.0074877786,
          0.021640211,
          0.002499245,
          0.013316032,
          0.0021524043,
          0.010129742,
          0.0054731146,
          0.03143805,
          0.014856071,
          0.0023366117,
          -0.0008243692,
          0.022781964,
          0.003038591,
          -0.017617522,
          0.0013309394,
          0.0022154662,
          0.00097414135,
          0.012041516,
          -0.027906578,
          -0.023817508,
          0.013302756,
          -0.003003741,
          -0.006890349,
          0.0016744611
        ]
      }
    ],
    "usage": {
      "prompt_tokens": 4,
      "total_tokens": 4
    }
  }
}

Elenco valutazioni

GET {endpoint}/openai/v1/evals?api-version=preview

Elencare le valutazioni per un project.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.
dopo	query	NO	corda	Identificatore per l'ultima valutazione della richiesta di paginazione precedente.
limit	query	NO	numero intero	Limite per il numero di valori da restituire in una singola risposta di impaginazione.
order	query	NO	corda Valori possibili: `asc`, `desc`	Ordina le valutazioni in base al timestamp. Usare `asc` per l'ordine crescente o `desc` per l'ordine decrescente.
ordina per	query	NO	corda Valori possibili: `created_at`, `updated_at`	Le valutazioni possono essere ordinate in base all'ora di creazione o all'ultima ora di aggiornamento. Usare `created_at` per l'ora di creazione o `updated_at` per l'ora dell'ultimo aggiornamento.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.EvalList

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Createeval

POST {endpoint}/openai/v1/evals?api-version=preview

Creare la struttura di una valutazione che può essere usata per testare le prestazioni di un modello.

Una valutazione è un set di criteri di test e un'origine dati. Dopo aver creato una valutazione, è possibile eseguirla in modelli e parametri del modello diversi. Sono supportati diversi tipi di classificatori e origini dati.

NOTA: questa Azure'API OpenAI è in anteprima e soggetta a modifiche.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio
configurazione_sorgente_dati	oggetto		Sì
└─ Tipo	OpenAI.EvalDataSourceConfigType		NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
nome	corda	Nome della valutazione.	NO
statusCode	enum	Valori possibili: `201`	Sì
criteri_di_test	array	Elenco di classificatori per tutte le esecuzioni di valutazione in questo gruppo. I classificatori possono fare riferimento alle variabili nell'origine dati usando la notazione con parentesi graffe doppie, ad esempio `{{item.variable_name}}`. Per fare riferimento all'output del modello, usare lo spazio dei nomi `sample` (ad esempio, `{{sample.output_text}}`).	Sì

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.Eval

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Ottieni valutazione

GET {endpoint}/openai/v1/evals/{eval_id}?api-version=preview

Recupera una valutazione in base al relativo ID. Recupera una valutazione in base al relativo ID.

NOTA: questa Azure'API OpenAI è in anteprima e soggetta a modifiche.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.
eval_id	path	Sì	corda

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.Eval

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Aggiorna valutazione

POST {endpoint}/openai/v1/evals/{eval_id}?api-version=preview

Aggiornare le proprietà selezionabili e modificabili di una valutazione specificata.

NOTA: questa Azure'API OpenAI è in anteprima e soggetta a modifiche.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.
eval_id	path	Sì	corda

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio	Default
metadata	OpenAI.MetadataPropertyForRequest	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
nome	corda		NO

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.Eval

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Elimina valutazione

DELETE {endpoint}/openai/v1/evals/{eval_id}?api-version=preview

Eliminare una valutazione specificata.

NOTA: questa Azure'API OpenAI è in anteprima e soggetta a modifiche.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.
eval_id	path	Sì	corda

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	oggetto

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Ottenere le esecuzioni di valutazione

GET {endpoint}/openai/v1/evals/{eval_id}/runs?api-version=preview

Recuperare un elenco di esecuzioni per una valutazione specificata.

NOTA: questa Azure'API OpenAI è in anteprima e soggetta a modifiche.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.
eval_id	path	Sì	corda
dopo	query	NO	corda
limit	query	NO	numero intero
order	query	NO	corda Valori possibili: `asc`, `desc`
stato	query	NO	corda Valori possibili: `queued`, `in_progresscompleted`, , `canceled`,`failed`

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.EvalRunList

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Creare l'esecuzione di valutazione

POST {endpoint}/openai/v1/evals/{eval_id}/runs?api-version=preview

Creare una nuova esecuzione di valutazione, iniziando il processo di valutazione.

NOTA: questa Azure'API OpenAI è in anteprima e soggetta a modifiche.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.
eval_id	path	Sì	corda

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio
fonte_dati	oggetto		Sì
└─ Tipo	OpenAI.EvalRunDataSourceType		NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
nome	corda	Nome della corsa.	NO

Responses

Codice di stato: 201

Descrizione: la richiesta è riuscita e di conseguenza è stata creata una nuova risorsa.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.EvalRun

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Ottenere l'esecuzione della valutazione

GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}?api-version=preview

Recuperare una valutazione specifica eseguita in base al relativo ID.

NOTA: questa Azure'API OpenAI è in anteprima e soggetta a modifiche.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.
eval_id	path	Sì	corda
run_id	path	Sì	corda

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.EvalRun

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Annulla esecuzione valutazione

POST {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}?api-version=preview

Annullare un'esecuzione di valutazione specifica in base al relativo ID.

NOTA: questa Azure'API OpenAI è in anteprima e soggetta a modifiche.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.
eval_id	path	Sì	corda
run_id	path	Sì	corda

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.EvalRun

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Deleteevalrun

DELETE {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}?api-version=preview

Eliminare una valutazione specifica eseguita in base al relativo ID.

NOTA: questa Azure'API OpenAI è in anteprima e soggetta a modifiche.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.
eval_id	path	Sì	corda
run_id	path	Sì	corda

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	oggetto

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Ottenere gli elementi di output dell'esecuzione della valutazione

GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}/output_items?api-version=preview

Ottenere un elenco di elementi di output per un'esecuzione di valutazione specificata.

NOTA: questa Azure'API OpenAI è in anteprima e soggetta a modifiche.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.
eval_id	path	Sì	corda
run_id	path	Sì	corda
dopo	query	NO	corda
limit	query	NO	numero intero
stato	query	NO	corda Valori possibili: `fail`, `pass`
order	query	NO	corda Valori possibili: `asc`, `desc`

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.EvalRunOutputItemList

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Ottenere l'elemento di output dell'esecuzione della valutazione

GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}/output_items/{output_item_id}?api-version=preview

Recuperare un elemento di output specifico da una valutazione eseguita in base al relativo ID.

NOTA: questa Azure'API OpenAI è in anteprima e soggetta a modifiche.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
aoai-evals	intestazione	Sì	corda Valori possibili: `preview`	Abilita access alle Eval AOAI, una funzionalità di anteprima. Questa funzionalità richiede che l'intestazione 'aoai-evals' sia impostata su 'preview'.
eval_id	path	Sì	corda
run_id	path	Sì	corda
output_item_id	path	Sì	corda

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.EvalRunOutputItem

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Crea un file

POST {endpoint}/openai/v1/files?api-version=preview

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Tipo di contenuto: multipart/form-data

Nome	TIPO	Descrzione	Obbligatorio
scade dopo	oggetto		Sì
Ancoraggio └*	AzureFileExpiryAnchor		NO
└─ secondi	numero intero		NO
documento	corda		Sì
purpose	enum	Scopo previsto del file caricato. Uno dei seguenti: - `assistants`: usato nell'API Assistenti - `batch`: usato nell'API Batch - `fine-tune`: usato per l'ottimizzazione - `evals`: usato per set di dati di valutazione Valori possibili: `assistants`, `batch`, `fine-tune`, `evals`	Sì

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureOpenAIFile

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Esempi

Example

POST {endpoint}/openai/v1/files?api-version=preview

Elencare file

GET {endpoint}/openai/v1/files?api-version=preview

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
purpose	query	NO	corda

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureListFilesResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Recuperare il file

GET {endpoint}/openai/v1/files/{file_id}?api-version=preview

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del file	path	Sì	corda	ID del file da utilizzare per questa richiesta.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureOpenAIFile

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Elimina file

DELETE {endpoint}/openai/v1/files/{file_id}?api-version=preview

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del file	path	Sì	corda	ID del file da utilizzare per questa richiesta.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.DeleteFileResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Scaricare il file

GET {endpoint}/openai/v1/files/{file_id}/content?api-version=preview

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del file	path	Sì	corda	ID del file da utilizzare per questa richiesta.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/octet-stream	corda

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Rungrader

POST {endpoint}/openai/v1/fine_tuning/alpha/graders/run?api-version=preview

Eseguire un classificatore.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio
cernitore	oggetto	Oggetto StringCheckGrader che esegue un confronto di stringhe tra input e riferimento usando un'operazione specificata.	Sì
└' calculate_output	corda	Formula per calcolare l'output in base ai risultati del classificatore.	NO
└' evaluation_metric	enum	Metrica di valutazione da usare. Uno di `fuzzy_match`, `bleu`, `gleu`, `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5` o `rouge_l`. Valori possibili: `fuzzy_match`, `bleu`, `gleumeteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5rouge_l`	NO
└️ voti	oggetto		NO
└' image_tag	corda	Tag immagine da usare per lo script Python.	NO
└ Input	array	Testo di input. Ciò può includere stringhe di modello.	NO
└─ Modello	corda	Modello da utilizzare per la valutazione.	NO
└> nome	corda	Nome del grader.	NO
└─ Operazione	enum	Operazione di controllo della stringa da eseguire. Uno tra `eq`, `ne`, `like` o `ilike`. Valori possibili: `eq`, `ne`, `like`, `ilike`	NO
└* intervallo	array	La gamma del punteggio. Il valore predefinito è `[0, 1]`.	NO
Riferimento	corda	Testo che viene valutato.	NO
└sampling_params		Parametri di campionamento per il modello.	NO
└─ sorgente	corda	Codice sorgente dello script Python.	NO
└─ Tipo	enum	Il tipo di oggetto, che è sempre `multi`. Valori possibili: `multi`	NO
oggetto		Elemento del set di dati fornito al classificatore. Verrà usato per popolare il `item` namespace.	NO
model_sample	corda	Esempio di modello da valutare. Questo valore verrà usato per popolare lo spazio dei nomi `sample`. La `output_json` variabile verrà popolata se l'esempio di modello è una stringa JSON valida.	Sì

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.RunGraderResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Convalida classificatore

POST {endpoint}/openai/v1/fine_tuning/alpha/graders/validate?api-version=preview

Convalidare un classificatore.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio
cernitore	oggetto	Oggetto StringCheckGrader che esegue un confronto di stringhe tra input e riferimento usando un'operazione specificata.	Sì
└' calculate_output	corda	Formula per calcolare l'output in base ai risultati del classificatore.	NO
└' evaluation_metric	enum	Metrica di valutazione da usare. Uno di `fuzzy_match`, `bleu`, `gleu`, `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5` o `rouge_l`. Valori possibili: `fuzzy_match`, `bleu`, `gleumeteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5rouge_l`	NO
└️ voti	oggetto		NO
└' image_tag	corda	Tag immagine da usare per lo script Python.	NO
└ Input	array	Testo di input. Ciò può includere stringhe di modello.	NO
└─ Modello	corda	Modello da utilizzare per la valutazione.	NO
└> nome	corda	Nome del grader.	NO
└─ Operazione	enum	Operazione di controllo della stringa da eseguire. Uno tra `eq`, `ne`, `like` o `ilike`. Valori possibili: `eq`, `ne`, `like`, `ilike`	NO
└* intervallo	array	La gamma del punteggio. Il valore predefinito è `[0, 1]`.	NO
Riferimento	corda	Testo che viene valutato.	NO
└sampling_params		Parametri di campionamento per il modello.	NO
└─ sorgente	corda	Codice sorgente dello script Python.	NO
└─ Tipo	enum	Il tipo di oggetto, che è sempre `multi`. Valori possibili: `multi`	NO

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.ValidateGraderResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Creare un processo di ottimizzazione

POST {endpoint}/openai/v1/fine_tuning/jobs?api-version=preview

Crea un processo di ottimizzazione che inizia il processo di creazione di un nuovo modello da un set di dati specificato.

La risposta include i dettagli del processo accodato, inclusi lo stato del processo e il nome dei modelli ottimizzati al termine.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio	Default
iperparametri	oggetto	Iperparametri usati per il processo di ottimizzazione. Questo valore è ora deprecato a favore di `method`e deve essere passato sotto il parametro `method`.	NO
└' batch_size	enum	Valori possibili: `auto`	NO
└' learning_rate_multiplier	enum	Valori possibili: `auto`	NO
└' n_epochs	enum	Valori possibili: `auto`	NO
integrazioni	array	Elenco di integrazioni da abilitare per il processo di ottimizzazione.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
method	OpenAI.FineTuneMethod	Metodo utilizzato per l'ottimizzazione.	NO
model	string (vedere modelli validi di seguito)	Nome del modello da ottimizzare.	Sì
seed	numero intero	Il seme controlla la riproducibilità del lavoro. Il passaggio degli stessi parametri di inizializzazione e processo dovrebbe produrre gli stessi risultati, ma in rari casi può differire. Se non viene specificato un valore di inizializzazione, ne verrà generato uno automaticamente.	NO
suffix	corda	Stringa di un massimo di 64 caratteri che verrà aggiunta al nome del modello ottimizzato. Ad esempio, un `suffix` oggetto "custom-model-name" produrrebbe un nome di modello come `ft:gpt-4o-mini:openai:custom-model-name:7p4lURel`.	NO	None
file di allenamento	corda	ID di un file caricato contenente i dati di training. Il set di dati deve essere formattato come file JSONL. Inoltre, è necessario caricare il file con lo scopo `fine-tune`. Il contenuto del file deve variare a seconda che il modello usi la chat, il formato dei completamenti o se il metodo di ottimizzazione usa il formato delle preferenze.	Sì
file_di_validazione	corda	ID di un file caricato contenente i dati di convalida. Se si fornisce questo file, i dati vengono usati per generare periodicamente metriche di convalida durante l’ottimizzazione. Queste metriche possono essere visualizzate nel file dei risultati di ottimizzazione. Gli stessi dati non devono essere presenti sia nei file di training sia nei file di convalida. Il set di dati deve essere formattato come file JSONL. È necessario caricare il file con lo scopo `fine-tune`.	NO

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.FineTuningJob

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Elencare i processi di ottimizzazione impaginati

GET {endpoint}/openai/v1/fine_tuning/jobs?api-version=preview

Elencare i processi di ottimizzazione dell'organizzazione

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
dopo	query	NO	corda	Identificatore dell'ultimo processo della richiesta di paginazione precedente.
limit	query	NO	numero intero	Numero di processi di ottimizzazione da recuperare.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.ListPaginatedFineTuningJobsResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Recuperare il processo di ottimizzazione

GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}?api-version=preview

Ottenere informazioni su un processo di ottimizzazione.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
id_lavoro_affinamento	path	Sì	corda	ID del processo di ottimizzazione.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.FineTuningJob

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Annullare il processo di ottimizzazione

POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/cancel?api-version=preview

Annullare immediatamente un processo di ottimizzazione.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
id_lavoro_affinamento	path	Sì	corda	ID del processo di ottimizzazione da annullare.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.FineTuningJob

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Elencare i checkpoint dei processi di ottimizzazione

GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/checkpoints?api-version=preview

Elencare i checkpoint per un processo di ottimizzazione.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
id_lavoro_affinamento	path	Sì	corda	ID del processo di ottimizzazione per cui ottenere i checkpoint.
dopo	query	NO	corda	Identificatore dell'ultimo ID del checkpoint della richiesta di paginazione precedente.
limit	query	NO	numero intero	Numero di checkpoint da recuperare.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.ListFineTuningJobCheckpointsResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Elencare gli eventi di ottimizzazione

GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/events?api-version=preview

Ottenere gli aggiornamenti dello stato per un processo di ottimizzazione.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
id_lavoro_affinamento	path	Sì	corda	ID del processo di ottimizzazione per cui ottenere gli eventi.
dopo	query	NO	corda	Identificatore dell'ultimo evento della richiesta di paginazione precedente.
limit	query	NO	numero intero	Numero di eventi da recuperare.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.ListFineTuningJobEventsResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Sospendere il processo di ottimizzazione

POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/pause?api-version=preview

Sospendere un processo di ottimizzazione.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
id_lavoro_affinamento	path	Sì	corda	ID del processo di ottimizzazione da sospendere.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.FineTuningJob

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Riprendere il processo di ottimizzazione

POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/resume?api-version=preview

Riprendere un processo di ottimizzazione sospeso.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
id_lavoro_affinamento	path	Sì	corda	ID del processo di ottimizzazione da riprendere.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.FineTuningJob

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Creare la modifica dell'immagine

POST {endpoint}/openai/v1/images/edits?api-version=preview

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Tipo di contenuto: multipart/form-data

Nome	TIPO	Descrzione	Obbligatorio	Default
sfondo	enum	Consente di impostare la trasparenza per lo sfondo delle immagini generate. Questo parametro è supportato solo per i modelli della serie `gpt-image-1`. Deve essere uno di `transparent`o `opaqueauto` (valore predefinito). Quando `auto` viene usato, il modello determinerà automaticamente lo sfondo migliore per l'immagine. Se `transparent`, il formato di output deve supportare la trasparenza, quindi deve essere impostato su `png` (valore predefinito) o `webp`. Valori possibili: `transparent`, `opaque`, `auto`	NO
image	stringa o matrice		Sì
mask	corda		NO
model	corda	Distribuzione del modello da usare per l'operazione di modifica dell'immagine.	Sì
n	numero intero	Numero di immagini da generare. Deve essere compreso tra 1 e 10.	NO	1
Compressione dell'output	numero intero	Livello di compressione (0-100%) per le immagini generate. Questo parametro è supportato solo per i modelli `gpt-image-1`-series con il formato di output `webp` o `jpeg`, e il valore predefinito è 100.	NO	100
formato_di_output	enum	Formato in cui vengono restituite le immagini generate. Questo parametro è supportato solo per i modelli della serie `gpt-image-1`. Deve essere uno di `png`, `jpeg`o `webp`. Il valore predefinito è `png`. Valori possibili: `png`, `jpeg`, `webp`	NO
prompt	corda	Descrizione testuale delle immagini desiderate. La lunghezza massima è di 1000 caratteri per `dall-e-2`, e di 32000 caratteri per i modelli di serie `gpt-image-1`.	Sì
qualità	enum	La qualità dell'immagine che verrà generata. `high`, `medium` e `low` sono supportati solo per `gpt-image-1` i modelli serie. `dall-e-2` supporta solo la qualità `standard`. Il valore predefinito è `auto`. Valori possibili: `standard`, `lowmedium`, , `high`,`auto`	NO
formato_risposta	enum	Formato in cui vengono restituite le immagini generate. Deve essere `url` o `b64_json`. Gli URL sono validi solo per 60 minuti dopo la generazione dell'immagine. Questo parametro è supportato solo per `dall-e-2`, perché `gpt-image-1`i modelli -series restituiscono sempre immagini con codifica Base64. Valori possibili: `url`, `b64_json`	NO
size	enum	Dimensioni delle immagini generate. Deve essere uno di `1024x1024`, `1536x1024` (orizzontale), `1024x1536` (verticale) o `auto` (valore predefinito) per `gpt-image-1`-series modelli e uno di `256x256`, `512x512` o `1024x1024` per `dall-e-2`. Valori possibili: `256x256`, `512x5121024x1024`, `1536x1024`, , `1024x1536auto`	NO
utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureImagesResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Crea immagine

POST {endpoint}/openai/v1/images/generations?api-version=preview

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio	Default
sfondo	enum	Consente di impostare la trasparenza per lo sfondo delle immagini generate. Questo parametro è supportato solo per i modelli della serie `gpt-image-1`. Deve essere uno di `transparent`o `opaqueauto` (valore predefinito). Quando `auto` viene usato, il modello determinerà automaticamente lo sfondo migliore per l'immagine. Se `transparent`, il formato di output deve supportare la trasparenza, quindi deve essere impostato su `png` (valore predefinito) o `webp`. Valori possibili: `transparent`, `opaque`, `auto`	NO
model	corda	Distribuzione del modello da utilizzare per generare immagini.	Sì
moderation	enum	Controllare il livello di moderazione del contenuto per le immagini generate dai modelli della serie `gpt-image-1`. Deve essere uno tra `low` per un filtro meno restrittivo o `auto` (valore predefinito). Valori possibili: `low`, `auto`	NO
n	numero intero	Numero di immagini da generare. Deve essere compreso tra 1 e 10. Solo per `dall-e-3` è supportato `n=1`.	NO	1
Compressione dell'output	numero intero	Livello di compressione (0-100%) per le immagini generate. Questo parametro è supportato solo per i modelli `gpt-image-1`-series con il formato di output `webp` o `jpeg`, e il valore predefinito è 100.	NO	100
formato_di_output	enum	Formato in cui vengono restituite le immagini generate. Questo parametro è supportato solo per i modelli della serie `gpt-image-1`. Deve essere uno di `png`, `jpeg`o `webp`. Valori possibili: `png`, `jpeg`, `webp`	NO
prompt	corda	Descrizione testuale delle immagini desiderate. La lunghezza massima è di 32000 caratteri per `gpt-image-1`i modelli di serie, 1000 caratteri per `dall-e-2` e 4000 caratteri per `dall-e-3`.	Sì
qualità	enum	La qualità dell'immagine che verrà generata. - `auto` (valore predefinito) selezionerà automaticamente la migliore qualità per il modello specificato. - `high`, `medium` e `low` sono supportati per i modelli della serie `gpt-image-1`. - `hd` e `standard` sono supportati per `dall-e-3`. - `standard` è l'unica opzione per `dall-e-2`. Valori possibili: `standard`, `hdlow`, `medium`, , `highauto`	NO
formato_risposta	enum	Formato in cui vengono restituite le immagini generate con `dall-e-2` e `dall-e-3` . Deve essere `url` o `b64_json`. Gli URL sono validi solo per 60 minuti dopo la generazione dell'immagine. Questo parametro non è supportato per `gpt-image-1`i modelli di serie che restituiranno sempre immagini con codifica Base64. Valori possibili: `url`, `b64_json`	NO
size	enum	Dimensioni delle immagini generate. Deve essere uno di `1024x1024`, `1536x1024` (orizzontale), `1024x1536` (verticale) o `auto` (valore predefinito) per i modelli della serie `gpt-image-1`, uno di `256x256`, `512x512` o `1024x1024` per `dall-e-2`, e uno di `1024x1024`, `1792x1024` o `1024x1792` per `dall-e-3`. Valori possibili: `auto`, `1024x1024`, `1536x10241024x1536`, `256x256`, `512x512`, , `1792x10241024x1792`	NO
style	enum	Stile delle immagini generate. Questo parametro è supportato solo per `dall-e-3`. Deve essere `vivid` o `natural`. Vivid fa sì che il modello si appoggi verso la generazione di immagini iper-reali e drammatiche. Naturale permette al modello di creare immagini più naturali e meno iper-reali. Valori possibili: `vivid`, `natural`	NO
utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureImagesResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Esempi

Example

Crea immagini in base a un prompt.

POST {endpoint}/openai/v1/images/generations?api-version=preview

{
 "model": "dall-e-3",
 "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
          }
        }
      }
    ]
  }
}

Ottenere l'elenco dei modelli

GET {endpoint}/openai/v1/models?api-version=preview

Elenca i modelli attualmente disponibili e fornisce informazioni di base su ognuno di essi, ad esempio il proprietario e la disponibilità.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.ListModelsResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Recuperare il modello

GET {endpoint}/openai/v1/models/{model}?api-version=preview

Recupera un'istanza del modello, fornendo informazioni di base sul modello, ad esempio il proprietario e le autorizzazioni.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
model	path	Sì	corda	ID del modello da utilizzare per questa richiesta.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.Model

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Creare una risposta

POST {endpoint}/openai/v1/responses?api-version=preview

Crea una risposta del modello.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio	Default
sfondo	boolean	Indica se eseguire la risposta del modello in background.	NO	Falso
includi	array	Specificare dati di output aggiuntivi da includere nella risposta del modello. I valori attualmente supportati sono: - `code_interpreter_call.outputs`: includono i risultati dell'esecuzione di Python negli elementi di chiamata dello strumento interprete di codice. - `computer_call_output.output.image_url`: includere gli URL delle immagini provenienti dall'output della chiamata computer. - `file_search_call.results`: includere i risultati della ricerca della chiamata allo strumento di ricerca file. - `message.input_image.image_url`: includere gli URL dell'immagine dal messaggio di input. - `message.output_text.logprobs`: includere logprob con messaggi di assistente. - `reasoning.encrypted_content`: Includere una versione crittografata dei token di ragionamento negli output degli elementi di ragionamento. Ciò consente di usare gli elementi di ragionamento nelle conversazioni a più turni quando si usa l'API Risposte senza stato (ad esempio quando il `store` parametro è impostato su `false`o quando un'organizzazione viene registrata nel programma di conservazione dei dati zero).	NO
ingresso	stringa o matrice		NO
instructions	corda	Messaggio di sistema (o sviluppatore) inserito nel contesto del modello. Quando si usa insieme a `previous_response_id`, le istruzioni di una risposta precedente non saranno trasferite alla risposta successiva. In questo modo è semplice scambiare messaggi di sistema (o sviluppatore) in nuove risposte.	NO
max_output_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per una risposta, inclusi token di output visibili e token di motivazione	NO
max_tool_calls	numero intero	Numero massimo di chiamate totali agli strumenti predefiniti che possono essere elaborati in una risposta. Questo numero massimo si applica a tutte le chiamate di strumenti predefinite, non a ogni singolo strumento. Eventuali altri tentativi di chiamare uno strumento da parte del modello verranno ignorati.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
model	corda	Il modello di distribuzione da utilizzare per la creazione di questa risposta.	Sì
chiamate_parallele_agli_strumenti	boolean	Indica se consentire al modello di eseguire chiamate degli strumenti in parallelo.	NO	Vero
previous_response_id	corda	ID univoco della risposta precedente al modello. Usare questa opzione per creare conversazioni a più turni.	NO
prompt	oggetto	Riferimento a un modello di richiesta e alle relative variabili.	NO
└* id	corda	Identificatore univoco del modello di richiesta da utilizzare.	NO
** └─ Variabili	OpenAI.ResponsePromptVariables	Mappa facoltativa di valori da sostituire con le variabili nel prompt. I valori di sostituzione possono essere stringhe o altri tipi di input di risposta, ad esempio immagini o file.	NO
└─ versione	corda	Versione facoltativa del modello di richiesta.	NO
reasoning	oggetto	Solo modelli di serie o Opzioni di configurazione per i modelli di ragionamento.	NO
└* sforzo	Sforzo di Ragionamento OpenAI	Solo modelli di serie o Vincola il lavoro sul ragionamento per i modelli di ragionamento. I valori attualmente supportati sono `low`, `medium` e `high`. La riduzione del lavoro di ragionamento può tradursi in risposte più veloci e in un minor numero di token usati per il ragionamento in una risposta.	NO
└─ genera_sommario	enum	Deprecato: usare `summary` invece. Riepilogo del ragionamento eseguito dal modello. Ciò può essere utile per eseguire il debug e comprendere il processo di ragionamento del modello. Uno tra `auto`, `concise` e `detailed`. Valori possibili: `auto`, `concise`, `detailed`	NO
└─ Riepilogo	enum	Riepilogo del ragionamento eseguito dal modello. Ciò può essere utile per eseguire il debug e comprendere il processo di ragionamento del modello. Uno tra `auto`, `concise` e `detailed`. Valori possibili: `auto`, `concise`, `detailed`	NO
store	boolean	Indica se archiviare la risposta del modello generata per il recupero successivo tramite API.	NO	Vero
torrente	boolean	Se impostato su true, i dati di risposta del modello verranno trasmessi al client durante la generazione tramite eventi inviati dal server.	NO	Falso
temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	NO	1
Testo	oggetto	Opzioni di configurazione per una risposta di testo dal modello. Può essere un testo normale o dati JSON strutturati.	NO
└* formato	OpenAI.ResponseTextFormatConfiguration		NO
tool_choice	oggetto	Controlla quale strumento (se presente) viene chiamato dal modello. `none` indica che il modello non chiamerà alcuno strumento e genera invece un messaggio. `auto` indica che il modello può scegliere tra la generazione di un messaggio o la chiamata di uno o più strumenti. `required` indica che il modello deve chiamare uno o più strumenti.	NO
└─ Tipo	OpenAI.ToolChoiceObjectType	Indica che il modello deve usare uno strumento predefinito per generare una risposta.	NO
strumenti	array	Una matrice di strumenti che il modello può chiamare durante la generazione di una risposta. Tu può specificare quale strumento usare impostando il `tool_choice` parametro . Le due categorie di strumenti che è possibile fornire al modello sono: - Strumenti predefiniti: strumenti forniti da OpenAI che estendono le funzionalità del modello, ad esempio la ricerca di file. - Chiamate di funzione (strumenti personalizzati): funzioni definite dall'utente, consentendo al modello di chiamare il proprio codice.	NO
top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	NO	1
truncation	enum	Strategia di troncamento da usare per la risposta del modello. - `auto`: se il contesto di questa risposta e quelli precedenti supera le dimensioni della finestra di contesto del modello, il modello tronca la risposta per adattarsi alla finestra di contesto eliminando gli elementi di input al centro della conversazione. - `disabled` (impostazione predefinita): se una risposta del modello supererà le dimensioni della finestra di contesto per un modello, la richiesta avrà esito negativo con un errore 400. Valori possibili: `auto`, `disabled`	NO
utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureResponse
text/event-stream	OpenAI.ResponseStreamEvent

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Esempi

Example

Creare una risposta al modello

POST {endpoint}/openai/v1/responses?api-version=preview

Ottenere la risposta

GET {endpoint}/openai/v1/responses/{response_id}?api-version=preview

Recupera una risposta del modello con l'ID specificato.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
response_id	path	Sì	corda
include[]	query	NO	array

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Eliminare la risposta

DELETE {endpoint}/openai/v1/responses/{response_id}?api-version=preview

Elimina una risposta in base all'ID.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
response_id	path	Sì	corda

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	oggetto

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Elencare gli elementi di input

GET {endpoint}/openai/v1/responses/{response_id}/input_items?api-version=preview

Restituisce un elenco di elementi di input per una determinata risposta.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
response_id	path	Sì	corda
limit	query	NO	numero intero	Limite al numero di oggetti da restituire. Il limite può variare tra 1 e 100 e il valore predefinito è 20.
order	query	NO	corda Valori possibili: `asc`, `desc`	Ordinare l'ordinamento in base al `created_at` timestamp degli oggetti. `asc` per l'ordine crescente e`desc` per l'ordine decrescente.
dopo	query	NO	corda	Cursore da usare nell'impaginazione. `after` è un ID oggetto che definisce la posizione nell'elenco. Ad esempio, se si effettua una richiesta di elenco e si ricevono 100 oggetti, che terminano con obj_foo, la chiamata successiva può includere after=obj_foo per recuperare la pagina successiva dell'elenco.
before	query	NO	corda	Cursore da usare nell'impaginazione. `before` è un ID oggetto che definisce la posizione nell'elenco. Ad esempio, se si effettua una richiesta di elenco e si ricevono 100 oggetti, terminando con obj_foo, la chiamata successiva può includere before=obj_foo per recuperare la pagina precedente dell'elenco.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.ResponseItemList

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Elencare archivi vettoriali

GET {endpoint}/openai/v1/vector_stores?api-version=preview

Restituisce un elenco di archivi vettoriali.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
limit	query	NO	numero intero	Limite al numero di oggetti da restituire. Il limite può variare tra 1 e 100 e il valore predefinito è 20.
order	query	NO	corda Valori possibili: `asc`, `desc`	Ordinare l'ordinamento in base al `created_at` timestamp degli oggetti. `asc` per l'ordine crescente e`desc` per l'ordine decrescente.
dopo	query	NO	corda	Cursore da usare nell'impaginazione. `after` è un ID oggetto che definisce la posizione nell'elenco. Ad esempio, se si effettua una richiesta di elenco e si ricevono 100 oggetti, che terminano con obj_foo, la chiamata successiva può includere after=obj_foo per recuperare la pagina successiva dell'elenco.
before	query	NO	corda	Cursore da usare nell'impaginazione. `before` è un ID oggetto che definisce la posizione nell'elenco. Ad esempio, se si effettua una richiesta di elenco e si ricevono 100 oggetti, terminando con obj_foo, la chiamata successiva può includere before=obj_foo per recuperare la pagina precedente dell'elenco.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.ListVectorStoresResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Creare un archivio vettoriale

POST {endpoint}/openai/v1/vector_stores?api-version=preview

Crea un archivio vettoriale.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio
chunking_strategy	oggetto	Strategia predefinita. Attualmente, questa strategia usa un `max_chunk_size_tokens` di `800` e `chunk_overlap_tokens` di `400`.	NO
└─ statico	OpenAI.StaticChunkingStrategy		NO
└─ Tipo	enum	Sempre `static`. Valori possibili: `static`	NO
scade dopo	OpenAI.VectorStoreExpirationAfter	I criteri di scadenza per un archivio vettoriale.	NO
identificatori_di_file	array	Elenco di ID file che devono essere usati dall'archivio vettoriale. Utile per strumenti come `file_search` in grado di access file.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
nome	corda	Il nome dell’archivio vettoriale.	NO

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.VectorStoreObject

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Esempi

File di esempio non trovato: ./examples/vector_stores.json

Ottieni - Archivio vettoriale

GET {endpoint}/openai/v1/vector_stores/{vector_store_id}?api-version=preview

Recupera un archivio vettoriale.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda	ID dell'archivio vettoriale da recuperare.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.VectorStoreObject

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Modificare l'archivio vettoriale

POST {endpoint}/openai/v1/vector_stores/{vector_store_id}?api-version=preview

Modifica un archivio vettoriale.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda	ID dell'archivio vettoriale da modificare.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio
scade dopo	oggetto	I criteri di scadenza per un archivio vettoriale.	NO
Ancoraggio └*	enum	Timestamp di ancoraggio dopo il quale si applicano i criteri di scadenza. Ancoraggi supportati: `last_active_at`. Valori possibili: `last_active_at`	NO
└* giorni	numero intero	Numero di giorni dopo l'ora di ancoraggio in cui scadrà l'archivio vettoriale.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
nome	corda	Il nome dell’archivio vettoriale.	NO

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.VectorStoreObject

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Elimina archivio vettoriale

DELETE {endpoint}/openai/v1/vector_stores/{vector_store_id}?api-version=preview

Elimina un archivio vettoriale.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda	ID dell'archivio vettoriale da eliminare.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.DeleteVectorStoreResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Crea - Batch file archivio vettoriale

POST {endpoint}/openai/v1/vector_stores/{vector_store_id}/file_batches?api-version=preview

Crea una batch di file dell’archivio vettoriale.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda	ID dell'archivio vettoriale per il quale creare un batch di file.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio
attributes	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri, valori booleani o numeri.	NO
chunking_strategy	OpenAI.ChunkingStrategyRequestParam	Strategia di suddivisione in blocchi usata per suddividere i file. Se non impostato, userà la strategia di `auto`.	NO
identificatori_di_file	array	Elenco di ID file che devono essere usati dall'archivio vettoriale. Utile per strumenti come `file_search` in grado di access file.	Sì

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.VectorStoreFileBatchObject

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Ottieni il batch di file dell'archivio vettoriale

GET {endpoint}/openai/v1/vector_stores/{vector_store_id}/file_batches/{batch_id}?api-version=preview

Recupera un batch di file dell’archivio vettoriale.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda	ID dell'archivio vettoriale a cui appartiene il batch di file.
batch_id	path	Sì	corda	ID del batch di file in fase di recupero.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.VectorStoreFileBatchObject

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Annulla il batch file dell'archivio vettoriale

POST {endpoint}/openai/v1/vector_stores/{vector_store_id}/file_batches/{batch_id}/cancel?api-version=preview

Annulla un batch di file dell’archivio vettoriale. In questo modo si tenta di annullare il prima possibile l'elaborazione dei file in questo batch.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda	ID dell'archivio vettoriale a cui appartiene il batch di file.
batch_id	path	Sì	corda	ID del lotto di file da annullare.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.VectorStoreFileBatchObject

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Elencare i file nel batch dell'archivio vettoriale

GET {endpoint}/openai/v1/vector_stores/{vector_store_id}/file_batches/{batch_id}/files?api-version=preview

Restituisce un elenco di file dell’archivio di vettori in un batch.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda	ID dell'archivio vettoriale a cui appartiene il batch di file.
batch_id	path	Sì	corda	ID del batch di file a cui appartengono i file.
limit	query	NO	numero intero	Limite al numero di oggetti da restituire. Il limite può variare tra 1 e 100 e il valore predefinito è 20.
order	query	NO	corda Valori possibili: `asc`, `desc`	Ordinare l'ordinamento in base al `created_at` timestamp degli oggetti. `asc` per l'ordine crescente e`desc` per l'ordine decrescente.
dopo	query	NO	corda	Cursore da usare nell'impaginazione. `after` è un ID oggetto che definisce la posizione nell'elenco. Ad esempio, se si effettua una richiesta di elenco e si ricevono 100 oggetti, che terminano con obj_foo, la chiamata successiva può includere after=obj_foo per recuperare la pagina successiva dell'elenco.
before	query	NO	corda	Cursore da usare nell'impaginazione. `before` è un ID oggetto che definisce la posizione nell'elenco. Ad esempio, se si effettua una richiesta di elenco e si ricevono 100 oggetti, terminando con obj_foo, la chiamata successiva può includere before=obj_foo per recuperare la pagina precedente dell'elenco.
filtro	query	NO		Filtrare in base allo stato del file. Uno di `in_progress`, `completed`, `failed`, `cancelled`.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.ListVectorStoreFilesResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Elenca - File dell’archivio di vettori

GET {endpoint}/openai/v1/vector_stores/{vector_store_id}/files?api-version=preview

Restituisce un elenco di file dell’archivio di vettori.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda	ID dell'archivio vettoriale a cui appartengono i file.
limit	query	NO	numero intero	Limite al numero di oggetti da restituire. Il limite può variare tra 1 e 100 e il valore predefinito è 20.
order	query	NO	corda Valori possibili: `asc`, `desc`	Ordinare l'ordinamento in base al `created_at` timestamp degli oggetti. `asc` per l'ordine crescente e`desc` per l'ordine decrescente.
dopo	query	NO	corda	Cursore da usare nell'impaginazione. `after` è un ID oggetto che definisce la posizione nell'elenco. Ad esempio, se si effettua una richiesta di elenco e si ricevono 100 oggetti, che terminano con obj_foo, la chiamata successiva può includere after=obj_foo per recuperare la pagina successiva dell'elenco.
before	query	NO	corda	Cursore da usare nell'impaginazione. `before` è un ID oggetto che definisce la posizione nell'elenco. Ad esempio, se si effettua una richiesta di elenco e si ricevono 100 oggetti, terminando con obj_foo, la chiamata successiva può includere before=obj_foo per recuperare la pagina precedente dell'elenco.
filtro	query	NO		Filtrare in base allo stato del file. Uno di `in_progress`, `completed`, `failed`, `cancelled`.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.ListVectorStoreFilesResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Crea - File archivio vettoriale

POST {endpoint}/openai/v1/vector_stores/{vector_store_id}/files?api-version=preview

Creare un file dell'archivio vettoriale allegando un file a un archivio vettoriale.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda	ID dell'archivio vettoriale per il quale creare un file.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio
attributes	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri, valori booleani o numeri.	NO
chunking_strategy	OpenAI.ChunkingStrategyRequestParam	Strategia di suddivisione in blocchi usata per suddividere i file. Se non impostato, userà la strategia di `auto`.	NO
ID del file	corda	Un ID file che deve essere usato dall'archivio vettoriale. Utile per strumenti come `file_search` in grado di access file.	Sì

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.VectorStoreFileObject

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Ottieni - File dell’archivio di vettori

GET {endpoint}/openai/v1/vector_stores/{vector_store_id}/files/{file_id}?api-version=preview

Recupera un file dell’archivio vettoriale.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda	ID dell'archivio vettoriale a cui appartiene il file.
ID del file	path	Sì	corda	ID del file da recuperare.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.VectorStoreFileObject

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Aggiornare gli attributi del file dell'archivio vettoriale

POST {endpoint}/openai/v1/vector_stores/{vector_store_id}/files/{file_id}?api-version=preview

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda
ID del file	path	Sì	corda

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio	Default
attributes	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri, valori booleani o numeri.	Sì

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.VectorStoreFileObject

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Elimina file archivio vettoriale

DELETE {endpoint}/openai/v1/vector_stores/{vector_store_id}/files/{file_id}?api-version=preview

Elimina un file dell’archivio vettoriale. Il file verrà rimosso dall'archivio vettoriale, ma il file stesso non verrà eliminato. Per eliminare il file, usare l'endpoint del file di eliminazione.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
ID del negozio vettoriale	path	Sì	corda	ID dell'archivio vettoriale a cui appartiene il file.
ID del file	path	Sì	corda	ID del file da eliminare.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	OpenAI.DeleteVectorStoreFileResponse

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureErrorResponse

Attività di generazione video - Crea

POST {endpoint}/openai/v1/video/generations/jobs?api-version=preview

Crea un nuovo processo di generazione video.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Corpo della richiesta

Content-Type: application/json

Nome	TIPO	Descrzione	Obbligatorio	Default
altezza	numero intero	Altezza del video. Sono supportate le dimensioni seguenti: 480x480, 854x480, 720x720, 1280x720, 1080x1080 e 1920x1080 con orientamento orizzontale e verticale.	Sì
model	corda	Nome dell'implementazione da usare per questa richiesta.	Sì
n_seconds	numero intero	Durata del processo di generazione video. Deve essere compreso tra 1 e 20 secondi.	NO	5
n_variants	numero intero	Numero di video da creare come varianti per questo processo. Deve essere compreso tra 1 e 5. Le dimensioni più piccole consentono più varianti.	NO	1
prompt	corda	Richiesta di questo processo di generazione video.	Sì
Larghezza	numero intero	Larghezza del video. Sono supportate le dimensioni seguenti: 480x480, 854x480, 720x720, 1280x720, 1080x1080 e 1920x1080 con orientamento orizzontale e verticale.	Sì

Corpo della richiesta

Tipo di contenuto: multipart/form-data

Nome	TIPO	Descrzione	Obbligatorio	Default
files	array		Sì
altezza	numero intero	Altezza del video. Sono supportate le dimensioni seguenti: 480x480, 854x480, 720x720, 1280x720, 1080x1080 e 1920x1080 con orientamento orizzontale e verticale.	Sì
inpaint_items	array	Elementi di aggiornamento facoltativi per questo processo di generazione video.	NO
model	corda	Nome dell'implementazione da usare per questa richiesta.	Sì
n_seconds	numero intero	Durata del processo di generazione video. Deve essere compreso tra 1 e 20 secondi.	NO	5
n_variants	numero intero	Numero di video da creare come varianti per questo processo. Deve essere compreso tra 1 e 5. Le dimensioni più piccole consentono più varianti.	NO	1
prompt	corda	Richiesta di questo processo di generazione video.	Sì
Larghezza	numero intero	Larghezza del video. Sono supportate le dimensioni seguenti: 480x480, 854x480, 720x720, 1280x720, 1080x1080 e 1920x1080 con orientamento orizzontale e verticale.	Sì

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	VideoGenerationJob

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureOpenAIVideoGenerationErrorResponse

Esempi

File di esempio non trovato: ./examples/create_video_generation_job_simple.json

Lavori di generazione video - Elenco

GET {endpoint}/openai/v1/video/generations/jobs?api-version=preview

Elenca i processi di generazione video.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
before	query	NO	corda
dopo	query	NO	corda
limit	query	Sì	numero intero
statuses	query	NO	array

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	VideoGenerationJobList

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureOpenAIVideoGenerationErrorResponse

Esempi

File di esempio non trovato: ./examples/get_video_generation_job_list.json

Processi di generazione di video - Ottenere

GET {endpoint}/openai/v1/video/generations/jobs/{job-id}?api-version=preview

Recupera le proprietà di un processo di generazione video.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
job-id	path	Sì	corda	ID del processo di generazione video da usare per la richiesta OpenAI Azure.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	VideoGenerationJob

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureOpenAIVideoGenerationErrorResponse

Esempi

File di esempio non trovato: ./examples/get_video_generation_job.json

Attività di generazione video - Elimina

DELETE {endpoint}/openai/v1/video/generations/jobs/{job-id}?api-version=preview

Elimina un processo di generazione video.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
job-id	path	Sì	corda	ID del processo di generazione video da usare per la richiesta OpenAI Azure.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 204

Descrizione: nessun contenuto da inviare per questa richiesta, ma le intestazioni potrebbero essere utili.

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureOpenAIVideoGenerationErrorResponse

Generazioni di video - Ottenere

GET {endpoint}/openai/v1/video/generations/{generation-id}?api-version=preview

Recupera una generazione di video in base all'ID.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
generation-id	path	Sì	corda	ID della generazione di video da usare per la richiesta OpenAI Azure.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
application/json	VideoGeneration

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureOpenAIVideoGenerationErrorResponse

Esempi

File di esempio non trovato: ./examples/get_video_generation.json

Generazioni di video - Recuperare l'anteprima

GET {endpoint}/openai/v1/video/generations/{generation-id}/content/thumbnail?api-version=preview

Recupera un'anteprima del contenuto video generato.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
generation-id	path	Sì	corda	ID della generazione di video da usare per la richiesta OpenAI Azure.

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
immagine/jpg	corda

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureOpenAIVideoGenerationErrorResponse

Generazioni di video - Recuperare il contenuto video

GET {endpoint}/openai/v1/video/generations/{generation-id}/content/video?api-version=preview

Recupera il contenuto video generato.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
generation-id	path	Sì	corda	ID della generazione di video da usare per la richiesta OpenAI Azure.
qualità	query	NO

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Tipo di contenuto	Tipo	Descrizione
video/mp4	corda

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureOpenAIVideoGenerationErrorResponse

Generazioni di video - Recuperare solo le intestazioni videocontent

HEAD {endpoint}/openai/v1/video/generations/{generation-id}/content/video?api-version=preview

Recupera le intestazioni per il contenuto video generato.

Parametri dell'URI

Nome	In	Obbligatorio	TIPO	Descrzione
endpoint	path	Sì	corda URL.	Azure endpoint OpenAI supportati (protocollo e nome host, ad esempio: `https://aoairesource.openai.azure.com`. Sostituire "aoairesource" con il Azure nome della risorsa OpenAI. https://{nome-risorsa}.openai. azure.com
versione-api	query	NO		Versione esplicita dell'API Foundry Models da usare per questa richiesta. `v1` se non specificato diversamente.
generation-id	path	Sì	corda	ID della generazione di video da usare per la richiesta OpenAI Azure.
qualità	query	NO

Intestazione della richiesta

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

Nome	Obbligatorio	TIPO	Descrzione
Autorizzazione	Vero	corda	Esempio:`Authorization: Bearer {Azure_OpenAI_Auth_Token}` Per generare un token di autenticazione usando Azure CLI: `az account get-access-token --resource https://cognitiveservices.azure.com` Tipo: oauth2 URL autorizzazione: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` Ambito: `https://ai.azure.com/.default`
api-key	Vero	corda	Specificare Azure chiave API OpenAI qui

Responses

Codice di stato: 200

Descrizione: la richiesta ha avuto esito positivo.

Codice di stato: impostazione predefinita

Descrizione: risposta di errore imprevista.

Tipo di contenuto	Tipo	Descrizione
application/json	AzureOpenAIVideoGenerationErrorResponse

Components

AudioTaskLabel

Definisce i descrittori possibili per le risposte alle operazioni audio disponibili.

Proprietà	Value
Descrizione	Definisce i descrittori possibili per le risposte alle operazioni audio disponibili.
Tipo	corda
Valori	`transcribe` `translate`

AudioTranslationSegment

Informazioni estese su un singolo segmento di dati audio tradotti. I segmenti rappresentano in genere circa 5-10 secondi di parlato. I limiti del segmento in genere si verificano tra le parole, ma non necessariamente tra le frasi.

Nome	TIPO	Descrzione	Obbligatorio
avg_logprob	numero	Probabilità media del log associata a questo segmento audio.	Sì
compression_ratio	numero	Rapporto di compressione di questo segmento audio.	Sì
fine	numero	Ora in cui questo segmento è terminato rispetto all'inizio dell'audio tradotto.	Sì
id	numero intero	Indice in base 0 di questo segmento all'interno di una traduzione.	Sì
no_speech_prob	numero	Probabilità di nessun rilevamento vocale all'interno di questo segmento audio.	Sì
seek	numero intero	Posizione di ricerca associata all'elaborazione di questo segmento audio. Le posizioni di ricerca sono espresse come centesimi di secondi. Il modello può elaborare diversi segmenti da una singola posizione di ricerca, quindi mentre la posizione di ricerca non rappresenterà mai un'ora successiva rispetto all'inizio del segmento, l'inizio del segmento può rappresentare un tempo significativamente successivo rispetto alla posizione di ricerca associata del segmento.	Sì
start	numero	Ora di inizio del segmento rispetto all'inizio dell'audio tradotto.	Sì
temperatura	numero	Punteggio della temperatura associato a questo segmento audio.	Sì
Testo	corda	Testo tradotto che faceva parte di questo segmento audio.	Sì
tokens	array	ID token corrispondenti al testo tradotto in questo segmento audio.	Sì

AzureAIFoundryModelsApiVersion

Proprietà	Value
Tipo	corda
Valori	`v1` `preview`

AzureAudioTranscriptionResponse

Informazioni sui risultati per un'operazione che trascrive l'audio parlato in testo scritto.

Nome	TIPO	Descrzione	Obbligatorio
duration	numero	Durata totale dell'audio elaborato per produrre informazioni di trascrizione a corredo.	NO
language	corda	Lingua parlata rilevata nei dati audio trascritti. Questo valore viene espresso come codice di lingua ISO-639-1 di due lettere, ad esempio 'en' o 'fr'.	NO
segments	array	Raccolta di informazioni sulla tempistica, le probabilità e altri dettagli di ogni segmento audio elaborato.	NO
compito	oggetto	Definisce i descrittori possibili per le risposte alle operazioni audio disponibili.	NO
Testo	corda	Testo trascritto per i dati audio forniti.	Sì
words	array	Raccolta di informazioni sulla tempistica di ogni parola elaborata.	NO

AzureAudioTranslationResponse

Informazioni sui risultati per un'operazione che ha convertito l'audio parlato in testo scritto.

Nome	TIPO	Descrzione	Obbligatorio
duration	numero	Durata totale dell'audio elaborato per produrre le informazioni di traduzione associate.	NO
language	corda	Lingua parlata rilevata nei dati audio tradotti. Questo valore viene espresso come codice di lingua ISO-639-1 di due lettere, ad esempio 'en' o 'fr'.	NO
segments	array	Raccolta di informazioni sulla tempistica, le probabilità e altri dettagli di ogni segmento audio elaborato.	NO
compito	oggetto	Definisce i descrittori possibili per le risposte alle operazioni audio disponibili.	NO
Testo	corda	Testo tradotto per i dati audio forniti.	Sì

AzureChatCompletionResponseMessage

Componente del modello di risposta esteso per i messaggi di risposta di completamento della chat nella Azure OpenAI service. Questo modello aggiunge il supporto per il contesto dei messaggi di chat, usato dalla funzionalità On Your Data per finalità, citazioni e altre informazioni correlate alla generazione aumentata di recupero eseguita.

Nome	TIPO	Descrzione	Obbligatorio
annotazioni	array	Annotazioni per il messaggio, se applicabile, come quando si usa lo strumento di ricerca Web.	NO
audio	oggetto	Se viene richiesta la modalità di output audio, questo oggetto contiene dati sulla risposta audio del modello.	NO
└* dati	corda	Byte audio con codifica Base64 generati dal modello, nel formato specificato nella richiesta.	NO
└─ scadenza_a	numero intero	Il timestamp Unix (in secondi) che indica quando questa risposta audio non sarà più accessibile sul server per l'uso nelle conversazioni a più turni.	NO
└* id	corda	Identificatore univoco per questa risposta audio.	NO
└─ trascrizione	corda	Trascrizione dell'audio generato dal modello.	NO
contenuto	corda	Contenuto del messaggio.	Sì
context	oggetto	Proprietà aggiuntiva, aggiunta ai messaggi di risposta di completamento della chat, prodotti dal Azure OpenAI service quando si usa il comportamento dell'estensione. Sono incluse informazioni sull'intento e sul riferimento della funzionalità Sul tuo Dati.	NO
└all_retrieved_documents	oggetto	Informazioni di riepilogo sui documenti recuperati dall'operazione di recupero dei dati.	NO
└chunk_id	corda	ID blocco per la citazione.	NO
└> contenuto	corda	Il contenuto della citazione.	NO
└indice_sorgente_dati	numero intero	Indice dell'origine dati utilizzata per il recupero.	NO
└─ percorso del file	corda	Percorso del file per la citazione.	NO
└─ motivo_filtro	enum	Se applicabile, indica il motivo per cui il documento è stato filtrato. Valori possibili: `score`, `rerank`	NO
└ original_search_score	numero	Punteggio di ricerca originale per il recupero.	NO
└─ punteggio_riordino	numero	Punteggio di rerank per il recupero.	NO
└search_queries	array	Le query di ricerca sono state eseguite per recuperare i documenti.	NO
└> titolo	corda	Titolo della citazione.	NO
└─ URL	corda	L'URL della citazione.	NO
└─ citazioni	array	Citazioni prodotte dal recupero dei dati.	NO
└─ finalità	corda	Finalità rilevata dalla cronologia delle chat, usata per trasportare il contesto di conversazione tra le interazioni	NO
function_call	oggetto	Deprecato e sostituito da `tool_calls`. Nome e argomenti di una funzione che deve essere chiamata, come generati dal modello.	NO
└─ Argomenti	corda		NO
└> nome	corda		NO
reasoning_content	corda	Proprietà di estensione Azure specifica contenente contenuto di ragionamento generato dai modelli supportati.	NO
refusal	corda	Messaggio di rifiuto generato dal modello.	Sì
ruolo	enum	Ruolo dell'autore del messaggio. Valori possibili: `assistant`	Sì
tool_calls	ChatCompletionMessageToolCallsItem	Le chiamate degli strumenti generate dal modello, ad esempio le chiamate di funzioni.	NO

AzureChatCompletionStreamResponseDelta

Modello di risposta esteso per un messaggio di risposta di chat in streaming sul Azure OpenAI service. Questo modello aggiunge il supporto per il contesto dei messaggi di chat, usato dalla funzionalità On Your Data per finalità, citazioni e altre informazioni correlate alla generazione aumentata di recupero eseguita.

Nome	TIPO	Descrzione	Obbligatorio
audio	oggetto		NO
└* dati	corda		NO
└─ scadenza_a	numero intero		NO
└* id	corda		NO
└─ trascrizione	corda		NO
contenuto	corda	Contenuto del messaggio del blocco.	NO
context	oggetto	Proprietà aggiuntiva, aggiunta ai messaggi di risposta di completamento della chat, prodotti dal Azure OpenAI service quando si usa il comportamento dell'estensione. Sono incluse informazioni sull'intento e sul riferimento della funzionalità Sul tuo Dati.	NO
└all_retrieved_documents	oggetto	Informazioni di riepilogo sui documenti recuperati dall'operazione di recupero dei dati.	NO
└chunk_id	corda	ID blocco per la citazione.	NO
└> contenuto	corda	Il contenuto della citazione.	NO
└indice_sorgente_dati	numero intero	Indice dell'origine dati utilizzata per il recupero.	NO
└─ percorso del file	corda	Percorso del file per la citazione.	NO
└─ motivo_filtro	enum	Se applicabile, indica il motivo per cui il documento è stato filtrato. Valori possibili: `score`, `rerank`	NO
└ original_search_score	numero	Punteggio di ricerca originale per il recupero.	NO
└─ punteggio_riordino	numero	Punteggio di rerank per il recupero.	NO
└search_queries	array	Le query di ricerca sono state eseguite per recuperare i documenti.	NO
└> titolo	corda	Titolo della citazione.	NO
└─ URL	corda	L'URL della citazione.	NO
└─ citazioni	array	Citazioni prodotte dal recupero dei dati.	NO
└─ finalità	corda	Finalità rilevata dalla cronologia delle chat, usata per trasportare il contesto di conversazione tra le interazioni	NO
function_call	oggetto	Deprecato e sostituito da `tool_calls`. Nome e argomenti di una funzione che deve essere chiamata, come generati dal modello.	NO
└─ Argomenti	corda		NO
└> nome	corda		NO
reasoning_content	corda	Proprietà di estensione Azure specifica contenente contenuto di ragionamento generato dai modelli supportati.	NO
refusal	corda	Messaggio di rifiuto generato dal modello.	NO
ruolo	oggetto	Ruolo dell'autore di un messaggio	NO
tool_calls	array		NO

AzureChatDataSource

Rappresentazione dei dati di configurazione per una singola origine dati di chat OpenAI Azure. Questa operazione verrà usata da una richiesta di completamento della chat che deve usare Azure estensioni della chat OpenAI per aumentare il comportamento della risposta. L'uso di questa configurazione è compatibile solo con Azure OpenAI.

Discriminare per AzureChatDataSource

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`azure_search`	AzureSearchChatDataSource
`azure_cosmos_db`	AzureCosmosDBChatDataSource
`elasticsearch`	ElasticsearchChatDataSource
`pinecone`	PineconeChatDataSource
`mongo_db`	MongoDBChatDataSource

Nome	TIPO	Descrzione	Obbligatorio	Default
type	oggetto		Sì

AzureChatDataSourceAccessTokenAuthenticationOptions

Nome	TIPO	Descrzione	Obbligatorio	Default
access_token	corda		Sì
type	enum	Valori possibili: `access_token`	Sì

AzureChatDataSourceApiKeyAuthenticationOptions

Nome	TIPO	Descrzione	Obbligatorio	Default
chiave	corda		Sì
type	enum	Valori possibili: `api_key`	Sì

AzureChatDataSourceAuthenticationOptions

Discriminare per AzureChatDataSourceAuthenticationOptions

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`system_assigned_managed_identity`	AzureChatDataSourceSystemAssignedManagedIdentityAuthenticationOptions
`user_assigned_managed_identity`	AzureChatDataSourceUserAssignedManagedIdentityAuthenticationOptions
`access_token`	AzureChatDataSourceAccessTokenAuthenticationOptions
`connection_string`	AzureChatDataSourceConnectionStringAuthenticationOptions
`key_and_key_id`	AzureChatDataSourceKeyAndKeyIdAuthenticationOptions
`encoded_api_key`	AzureChatDataSourceEncodedApiKeyAuthenticationOptions
`username_and_password`	AzureChatDataSourceUsernameAndPasswordAuthenticationOptions

Nome	TIPO	Descrzione	Obbligatorio	Default
type	AzureChatDataSourceAuthenticationOptionsType		Sì

AzureChatDataSourceAuthenticationOptionsType

Proprietà	Value
Tipo	corda
Valori	`api_key` `username_and_password` `connection_string` `key_and_key_id` `encoded_api_key` `access_token` `system_assigned_managed_identity` `user_assigned_managed_identity`

AzureChatDataSourceConnectionStringAuthenticationOptions

Nome	TIPO	Descrzione	Obbligatorio	Default
connection_string	corda		Sì
type	enum	Valori possibili: `connection_string`	Sì

AzureChatDataSourceDeploymentNameVectorizationSource

Rappresenta un'origine di vettorizzazione che effettua chiamate interne al servizio rispetto a una distribuzione del modello di incorporamento OpenAI Azure. A differenza dell'origine di vettorizzazione basata su endpoint, un'origine vettorializzazione basata su nome distribuzione deve far parte della stessa risorsa openAI Azure, ma può essere usata anche nelle reti private.

Nome	TIPO	Descrzione	Obbligatorio
nome_di_distribuzione	corda	Distribuzione del modello di embedding da usare per la vettorizzazione. Questa distribuzione deve esistere all'interno della stessa risorsa OpenAI Azure della distribuzione del modello usata per i completamenti della chat.	Sì
dimensions	numero intero	Numero di dimensioni da richiedere per gli incorporamenti. Supportato solo nei modelli "text-embedding-3" e versioni successive.	NO
type	enum	Identificatore del tipo, sempre "deployment_name" per questo tipo di origine di vettorizzazione. Valori possibili: `deployment_name`	Sì

AzureChatDataSourceEncodedApiKeyAuthenticationOptions

Nome	TIPO	Descrzione	Obbligatorio	Default
encoded_api_key	corda		Sì
type	enum	Valori possibili: `encoded_api_key`	Sì

AzureChatDataSourceEndpointVectorizationSource

Rappresenta un'origine di vettorizzazione che effettua chiamate al servizio pubblico su una distribuzione del modello di incorporamento OpenAI Azure.

Nome	TIPO	Descrzione	Obbligatorio
autenticazione	oggetto		Sì
└access_token	corda		NO
└─ tasto	corda		NO
└─ Tipo	enum	Valori possibili: `access_token`	NO
dimensions	numero intero	Numero di dimensioni da richiedere per gli incorporamenti. Supportato solo nei modelli "text-embedding-3" e versioni successive.	NO
endpoint	corda	Specifica l'URL dell'endpoint della risorsa da cui recuperare gli incorporamenti. Deve essere nel formato di: https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings. Il parametro di query api-version non è consentito.	Sì
type	enum	Identificatore del tipo, sempre "endpoint" per questo tipo di origine di vettorializzazione. Valori possibili: `endpoint`	Sì

AzureChatDataSourceIntegratedVectorizationSource

Rappresenta un'origine di vettorizzazione integrata definita all'interno della risorsa di ricerca di supporto.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Identificatore del tipo, sempre "integrato" per questo tipo di origine di vettorizzazione. Valori possibili: `integrated`	Sì

AzureChatDataSourceKeyAndKeyIdAuthenticationOptions

Nome	TIPO	Descrzione	Obbligatorio
chiave	corda		Sì
key_id	corda		Sì
type	enum	Valori possibili: `key_and_key_id`	Sì

AzureChatDataSourceModelIdVectorizationSource

Rappresenta un'origine di vettorizzazione che effettua chiamate di servizio in base a un ID modello search service. Questo tipo di origine è attualmente supportato solo da Elasticsearch.

Nome	TIPO	Descrzione	Obbligatorio	Default
model_id	corda	ID di compilazione del modello di incorporamento da usare per la vettorializzazione.	Sì
type	enum	Identificatore del tipo, sempre "model_id" per questo tipo di origine di vettorializzazione. Valori possibili: `model_id`	Sì

AzureChatDataSourceSystemAssignedManagedIdentityAuthenticationOptions

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `system_assigned_managed_identity`	Sì

AzureChatDataSourceType

Proprietà	Value
Tipo	corda
Valori	`azure_search` `azure_cosmos_db` `elasticsearch` `pinecone` `mongo_db`

AzureChatDataSourceUserAssignedManagedIdentityAuthenticationOptions

Nome	TIPO	Descrzione	Obbligatorio	Default
managed_identity_resource_id	corda		Sì
type	enum	Valori possibili: `user_assigned_managed_identity`	Sì

AzureChatDataSourceUsernameAndPasswordAuthenticationOptions

Nome	TIPO	Descrzione	Obbligatorio
parola d’ordine	corda		Sì
type	enum	Valori possibili: `username_and_password`	Sì
username	corda		Sì

AzureChatDataSourceVectorizationSource

Rappresentazione di un'origine di vettorizzazione dei dati utilizzabile come risorsa di incapsulamento con un'origine di dati.

Discriminare per AzureChatDataSourceVectorizationSource

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`deployment_name`	AzureChatDataSourceDeploymentNameVectorizationSource
`integrated`	AzureChatDataSourceIntegratedVectorizationSource
`model_id`	AzureChatDataSourceModelIdVectorizationSource

Nome	TIPO	Descrzione	Obbligatorio	Default
type	oggetto		Sì

AzureChatDataSourceVectorizationSourceType

Proprietà	Value
Tipo	corda
Valori	`endpoint` `deployment_name` `model_id` `integrated`

AzureChatMessageContext

Proprietà aggiuntiva, aggiunta ai messaggi di risposta di completamento della chat, prodotti dal Azure OpenAI service quando si usa il comportamento dell'estensione. Sono incluse informazioni sull'intento e sul riferimento della funzionalità Sul tuo Dati.

Nome	TIPO	Descrzione	Obbligatorio
all_retrieved_documents	oggetto	Informazioni di riepilogo sui documenti recuperati dall'operazione di recupero dei dati.	NO
└chunk_id	corda	ID blocco per la citazione.	NO
└> contenuto	corda	Il contenuto della citazione.	NO
└indice_sorgente_dati	numero intero	Indice dell'origine dati utilizzata per il recupero.	NO
└─ percorso del file	corda	Percorso del file per la citazione.	NO
└─ motivo_filtro	enum	Se applicabile, indica il motivo per cui il documento è stato filtrato. Valori possibili: `score`, `rerank`	NO
└ original_search_score	numero	Punteggio di ricerca originale per il recupero.	NO
└─ punteggio_riordino	numero	Punteggio di rerank per il recupero.	NO
└search_queries	array	Le query di ricerca sono state eseguite per recuperare i documenti.	NO
└> titolo	corda	Titolo della citazione.	NO
└─ URL	corda	L'URL della citazione.	NO
citations	array	Citazioni prodotte dal recupero dei dati.	NO
intent	corda	Finalità rilevata dalla cronologia delle chat, usata per trasportare il contesto di conversazione tra le interazioni	NO

AzureContentFilterBlocklistResult

Raccolta di risultati di filtro true/false per gli elenchi di blocchi personalizzati configurati.

Nome	TIPO	Descrzione	Obbligatorio	Default
details	array	Coppie di ID elenco di blocchi singoli e se hanno generato un'azione di filtro.	NO
filtered	boolean	Valore che indica se uno degli elenchi di blocchi dettagliati ha generato un'azione di filtro.	Sì

AzureContentFilterCompletionTextSpan

Rappresentazione di un intervallo di testo di completamento usato da Azure risultati del filtro del contenuto OpenAI.

Nome	TIPO	Descrzione	Obbligatorio	Default
completion_end_offset	numero intero	Offset del primo punto di codice UTF32 escluso dall'intervallo. Questo campo è sempre uguale a completion_start_offset per intervalli vuoti. Questo campo è sempre più grande di completion_start_offset per intervalli non vuoti.	Sì
completion_start_offset	numero intero	Offset del punto di codice UTF32 che inizia l'intervallo.	Sì

AzureContentFilterCompletionTextSpanDetectionResult

Nome	TIPO	Descrzione	Obbligatorio
details	array	Informazioni dettagliate sugli intervalli di testo di completamento rilevati.	Sì
detected	boolean	Indica se la categoria di contenuto etichettata è stata rilevata nel contenuto.	Sì
filtered	boolean	Indica se il rilevamento del contenuto ha generato un'azione di filtro del contenuto.	Sì

AzureContentFilterCustomTopicResult

Raccolta di risultati del filtro true/false per gli argomenti personalizzati configurati.

Nome	TIPO	Descrzione	Obbligatorio	Default
details	array	Coppie di ID singolo argomento e se vengono rilevati.	NO
filtered	boolean	Valore che indica se uno degli argomenti dettagliati ha generato un'azione di filtro.	Sì

AzureContentFilterDetectionResult

Elemento del risultato del filtro contenuto con etichetta che indica se il contenuto è stato rilevato e se il contenuto è stato filtrato.

Nome	TIPO	Descrzione	Obbligatorio	Default
detected	boolean	Indica se la categoria di contenuto etichettata è stata rilevata nel contenuto.	Sì
filtered	boolean	Indica se il rilevamento del contenuto ha generato un'azione di filtro del contenuto.	Sì

AzureContentFilterImagePromptResults

Risultato del filtro dei contenuti per il contenuto della richiesta di input per l'operazione di generazione di immagini.

Nome	TIPO	Descrzione	Obbligatorio
custom_blocklists	oggetto	Raccolta di risultati di filtro true/false per gli elenchi di blocchi personalizzati configurati.	NO
└* dettagli	array	Coppie di ID elenco di blocchi singoli e se hanno generato un'azione di filtro.	NO
└* filtrato	boolean	Valore che indica se uno degli elenchi di blocchi dettagliati ha generato un'azione di filtro.	NO
custom_topics	oggetto	Raccolta di risultati del filtro true/false per gli argomenti personalizzati configurati.	NO
└* dettagli	array	Coppie di ID singolo argomento e se vengono rilevati.	NO
└* filtrato	boolean	Valore che indica se uno degli argomenti dettagliati ha generato un'azione di filtro.	NO
jailbreak	oggetto	Elemento del risultato del filtro contenuto con etichetta che indica se il contenuto è stato rilevato e se il contenuto è stato filtrato.	Sì
└> rilevato	boolean	Indica se la categoria di contenuto etichettata è stata rilevata nel contenuto.	NO
└* filtrato	boolean	Indica se il rilevamento del contenuto ha generato un'azione di filtro del contenuto.	NO
profanity	oggetto	Elemento del risultato del filtro contenuto con etichetta che indica se il contenuto è stato rilevato e se il contenuto è stato filtrato.	NO
└> rilevato	boolean	Indica se la categoria di contenuto etichettata è stata rilevata nel contenuto.	NO
└* filtrato	boolean	Indica se il rilevamento del contenuto ha generato un'azione di filtro del contenuto.	NO

AzureContentFilterImageResponseResults

Risultato di un filtro contenuto per il contenuto della risposta di output di un'operazione di generazione di immagini.

Nome	TIPO	Descrzione	Obbligatorio
hate	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO
self_harm	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO
sexual	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO
violence	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO

AzureContentFilterResultForChoice

Risultato di un filtro contenuto per un singolo elemento di risposta prodotto da un sistema di intelligenza artificiale generativo.

Nome	TIPO	Descrzione	Obbligatorio
custom_blocklists	oggetto	Raccolta di risultati di filtro true/false per gli elenchi di blocchi personalizzati configurati.	NO
└* dettagli	array	Coppie di ID elenco di blocchi singoli e se hanno generato un'azione di filtro.	NO
└* filtrato	boolean	Valore che indica se uno degli elenchi di blocchi dettagliati ha generato un'azione di filtro.	NO
custom_topics	oggetto	Raccolta di risultati del filtro true/false per gli argomenti personalizzati configurati.	NO
└* dettagli	array	Coppie di ID singolo argomento e se vengono rilevati.	NO
└* filtrato	boolean	Valore che indica se uno degli argomenti dettagliati ha generato un'azione di filtro.	NO
Errore	oggetto	Se presente, vengono fornite informazioni dettagliate su un errore che impediva il completamento della valutazione del filtro del contenuto.	NO
└─ codice	numero intero	Codice distinto e leggibile dal computer associato all'errore.	NO
└* messaggio	corda	Messaggio leggibile associato all'errore.	NO
hate	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO
profanity	oggetto	Elemento del risultato del filtro contenuto con etichetta che indica se il contenuto è stato rilevato e se il contenuto è stato filtrato.	NO
└> rilevato	boolean	Indica se la categoria di contenuto etichettata è stata rilevata nel contenuto.	NO
└* filtrato	boolean	Indica se il rilevamento del contenuto ha generato un'azione di filtro del contenuto.	NO
protected_material_code	oggetto	Risultato del rilevamento che descrive una corrispondenza rispetto al codice concesso in licenza o ad altri materiali di origine protetti.	NO
└─ Citazione	oggetto	Se disponibile, i dettagli della citazione che descrivono la licenza associata e la relativa posizione.	NO
└* URL	corda	URL associato alla licenza.	NO
└─ licenza	corda	Nome o identificatore della licenza associata al rilevamento.	NO
└> rilevato	boolean	Indica se la categoria di contenuto etichettata è stata rilevata nel contenuto.	NO
└* filtrato	boolean	Indica se il rilevamento del contenuto ha generato un'azione di filtro del contenuto.	NO
protected_material_text	oggetto	Elemento del risultato del filtro contenuto con etichetta che indica se il contenuto è stato rilevato e se il contenuto è stato filtrato.	NO
└> rilevato	boolean	Indica se la categoria di contenuto etichettata è stata rilevata nel contenuto.	NO
└* filtrato	boolean	Indica se il rilevamento del contenuto ha generato un'azione di filtro del contenuto.	NO
self_harm	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO
sexual	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO
ungrounded_material	AzureContentFilterCompletionTextSpanDetectionResult		NO
violence	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO

AzureContentFilterResultForPrompt

Risultato di un filtro contenuto associato a un singolo elemento del prompt di input in un sistema di intelligenza artificiale generativo.

Nome	TIPO	Descrzione	Obbligatorio
content_filter_results	oggetto	Dettagli della categoria del filtro contenuto per il risultato.	NO
└─ liste_blocchi_personalizzate	oggetto	Raccolta di risultati di filtro true/false per gli elenchi di blocchi personalizzati configurati.	NO
└* dettagli	array	Coppie di ID elenco di blocchi singoli e se hanno generato un'azione di filtro.	NO
└* filtrato	boolean	Valore che indica se uno degli elenchi di blocchi dettagliati ha generato un'azione di filtro.	NO
└' custom_topics	oggetto	Raccolta di risultati del filtro true/false per gli argomenti personalizzati configurati.	NO
└* dettagli	array	Coppie di ID singolo argomento e se vengono rilevati.	NO
└* filtrato	boolean	Valore che indica se uno degli argomenti dettagliati ha generato un'azione di filtro.	NO
└─ Errore	oggetto	Se presente, vengono fornite informazioni dettagliate su un errore che impediva il completamento della valutazione del filtro del contenuto.	NO
└─ codice	numero intero	Codice distinto e leggibile dal computer associato all'errore.	NO
└* messaggio	corda	Messaggio leggibile associato all'errore.	NO
└> odio	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO
└attacco indiretto	oggetto	Elemento del risultato del filtro contenuto con etichetta che indica se il contenuto è stato rilevato e se il contenuto è stato filtrato.	NO
└> rilevato	boolean	Indica se la categoria di contenuto etichettata è stata rilevata nel contenuto.	NO
└* filtrato	boolean	Indica se il rilevamento del contenuto ha generato un'azione di filtro del contenuto.	NO
└* jailbreak	oggetto	Elemento del risultato del filtro contenuto con etichetta che indica se il contenuto è stato rilevato e se il contenuto è stato filtrato.	NO
└> rilevato	boolean	Indica se la categoria di contenuto etichettata è stata rilevata nel contenuto.	NO
└* filtrato	boolean	Indica se il rilevamento del contenuto ha generato un'azione di filtro del contenuto.	NO
└* volgarità	oggetto	Elemento del risultato del filtro contenuto con etichetta che indica se il contenuto è stato rilevato e se il contenuto è stato filtrato.	NO
└> rilevato	boolean	Indica se la categoria di contenuto etichettata è stata rilevata nel contenuto.	NO
└* filtrato	boolean	Indica se il rilevamento del contenuto ha generato un'azione di filtro del contenuto.	NO
└─ autolesionismo	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO
└─ sessuale	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO
└* violenza	oggetto	Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.	NO
└* filtrato	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	NO
└> gravità	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	NO
prompt_index	numero intero	Indice del prompt di input associato alle categorie di risultati del filtro contenuto associato.	NO

AzureContentFilterSeverityResult

Elemento del risultato del filtro contenuto etichettato che indica se il contenuto è stato filtrato e quale livello di gravità qualitativo del contenuto è stato valutato in base alla configurazione del filtro contenuto per la categoria.

Nome	TIPO	Descrzione	Obbligatorio	Default
filtered	boolean	Indica se la gravità del contenuto ha generato un'azione di filtro del contenuto.	Sì
severity	enum	La gravità etichettata del contenuto. Valori possibili: `safe`, `low`, `medium`, `high`	Sì

AzureCosmosDBChatDataSource

Rappresenta una configurazione dell'origine dati che userà una risorsa Azure CosmosDB.

Nome	TIPO	Descrzione	Obbligatorio	Default
parameters	oggetto	Informazioni sui parametri per controllare l'uso dell'origine dati Azure CosmosDB.	Sì
└─ consenti_risultato_parziale	boolean	Se impostato su true, il sistema consentirà l'uso di risultati parziali della ricerca e la richiesta avrà esito negativo se tutte le query parziali hanno esito negativo. Se non specificato, o specificato come false, la richiesta avrà esito negativo se una query di ricerca ha esito negativo.	NO	Falso
Autenticazione	AzureChatDataSourceConnectionStringAuthenticationOptions		NO
└container_name	corda		NO
└─database_name	corda		NO
└─ dipendenza_embedded	AzureChatDataSourceVectorizationSource	Rappresentazione di un'origine di vettorizzazione dei dati utilizzabile come risorsa di incapsulamento con un'origine di dati.	NO
└ fields_mapping	oggetto		NO
└content_fields	array		NO
└─content_fields_separator	corda		NO
└filepath_field	corda		NO
└─ campo_titolo	corda		NO
└url_field	corda		NO
└vector_fields	array		NO
└ in_scope	boolean	Indica se le query devono essere limitate all'uso dei dati indicizzati.	NO
└include_contexts	array	Proprietà del contesto di output da includere nella risposta. Per impostazione predefinita, verranno richieste citazioni e finalità.	NO	['citazioni', 'intento']
└ index_name	corda		NO
└max_search_queries	numero intero	Numero massimo di query riscritte che devono essere inviate al provider di ricerca per un singolo messaggio utente. Per impostazione predefinita, il sistema effettuerà una determinazione automatica.	NO
└* rigidità	numero intero	La rigidità configurata del filtro di pertinenza della ricerca. Una maggiore rigidità aumenterà la precisione, ma diminuirà il richiamo della risposta.	NO
└top_n_documents	numero intero	Il numero configurato di documenti da includere nella query.	NO
type	enum	Identificatore di tipo discriminato, che è sempre "azure_cosmos_db". Valori possibili: `azure_cosmos_db`	Sì

AzureCreateChatCompletionRequest

Modello di richiesta estesa per i completamenti della chat rispetto al Azure OpenAI service. In questo modo è possibile fornire origini dati per la funzionalità On Your Data .

Nome	TIPO	Descrzione	Obbligatorio	Default
audio	oggetto	Parametri dell'output audio. Obbligatorio quando viene richiesto l'output audio con `modalities: ["audio"]`.	NO
└* formato	enum	Specifica il formato audio di output. Deve essere uno di `wav`, `mp3`, `flacopus`, o `pcm16`. Valori possibili: `wav`, `aacmp3`, `flac`, , `opuspcm16`	NO
└─ voce	oggetto		NO
data_sources	array	Origini dati da usare per la funzionalità On Your Data, esclusiva per Azure OpenAI.	NO
penalità di frequenza	numero	Numero compreso tra -2.0 e 2.0. I valori positivi penalizzano i nuovi token in base alla frequenza esistente nel testo fino a quel momento, riducendo la probabilità che il modello ripeta testualmente la stessa riga.	NO	0
function_call	enum	Specificare una determinata funzione tramite `{"name": "my_function"}` impone al modello di chiamare tale funzione. Valori possibili: `none`, `auto`	NO
functions	array	Deprecato e sostituito da `tools`. Un elenco di funzioni per cui il modello può generare input JSON.	NO
bias del logit	oggetto	Modificare la probabilità che i token specificati vengano visualizzati nel completamento. Accetta un oggetto JSON che esegue il mapping dei token (specificato dal relativo ID token nel tokenizer) con un valore di distorsione associato compreso tra -100 e 100. Matematicamente, la distorsione viene aggiunta ai logits generati dal modello prima del campionamento. L'effetto esatto varia per modello, ma i valori compresi tra -1 e 1 devono diminuire o aumentare la probabilità di selezione; i valori come -100 o 100 devono comportare un divieto o una selezione esclusiva del token pertinente.	NO	None
logprobs	boolean	Indica se restituire o non restituire le probabilità di log dei token di output. Se true, restituisce le probabilità di log di ogni token di output restituito in `content` di `message`.	NO	Falso
max_completion_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per un completamento, inclusi i token di output visibili e i token di ragionamento.	NO
numero massimo di token	numero intero	Numero massimo di token che possono essere generati al momento del completamento della chat. Questo valore può essere usato per controllare i costi per il testo generato tramite API. Questo valore è ora deprecato a favore di `max_completion_tokens`e non è compatibile con i modelli di serie o1.	NO
messages	array	Elenco di messaggi che comprendono la conversazione effettuata finora. A seconda del modello usato, sono supportati diversi tipi di messaggio (modalità), ad esempio testo, immagini e audio.	Sì
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
modalities	oggetto	Tipi di output che si desidera generare il modello. La maggior parte dei modelli è in grado di generare testo, in base all'impostazione predefinita: `["text"]` Il modello `gpt-4o-audio-preview` può essere usato anche per generare audio. Per far sì che questo modello generi risposte sia di testo che audio, è possibile usare: `["text", "audio"]`	NO
model	corda	Identificatore di distribuzione del modello da usare per la richiesta di completamento della chat.	Sì
n	numero intero	Quante opzioni di completamento della chat generare per ogni messaggio di input. Tenere presente che verranno addebitati i costi in base al numero di token generati in tutte le scelte. Mantenere `n` come `1` per ridurre al minimo i costi.	NO	1
chiamate_parallele_agli_strumenti	oggetto	Indica se abilitare o meno la chiamata di funzioni parallele durante l'uso dello strumento.	NO
stima	oggetto	Rappresentazione di base dell'output stimato da un modello.	NO
└─ Tipo	OpenAI.ChatOutputPredictionType		NO
penalità_di_presenza	numero	Numero compreso tra -2.0 e 2.0. I valori positivi penalizzano i nuovi token in base al fatto che vengano visualizzati o meno nel testo fino a questo momento, aumentando la probabilità del modello di parlare di nuovi argomenti.	NO	0
sforzo di ragionamento	oggetto	Solo modelli di serie o Vincola il lavoro sul ragionamento per i modelli di ragionamento. I valori attualmente supportati sono `low`, `medium` e `high`. La riduzione del lavoro di ragionamento può tradursi in risposte più veloci e in un minor numero di token usati per il ragionamento in una risposta.	NO
formato_risposta	oggetto		NO
└─ Tipo	enum	Valori possibili: `text`, `json_object`, `json_schema`	NO
seed	numero intero	Questa funzionalità è in versione beta. Se specificato, il nostro sistema esegue un'operazione ottimale per campionare in modo deterministico, in modo che le richieste ripetute con gli stessi `seed` e gli stessi parametri restituiscano lo stesso risultato. Il determinismo non è garantito ed è necessario fare riferimento al parametro di risposta `system_fingerprint` per monitorare le modifiche nel back-end.	NO
fermare	oggetto	Non supportato con i modelli `o3` di ragionamento più recenti e `o4-mini`. Fino a 4 sequenze in cui l'API smetterà di generare altri token. Il testo restituito non conterrà la sequenza di interruzione.	NO
store	boolean	Indica se archiviare o no l'output di questa richiesta di completamento della chat per l'uso nei prodotti di modellazione o di valutazione.	NO	Falso
torrente	boolean	Se impostato su true, i dati di risposta del modello verranno trasmessi al client durante la generazione tramite eventi inviati dal server.	NO	Falso
stream_options	oggetto	Opzioni per la risposta in streaming. Impostare questa opzione solo quando si imposta `stream: true`.	NO
└─ uso_includi	boolean	Se impostato, un blocco aggiuntivo verrà trasmesso prima del messaggio `data: [DONE]`. Il campo `usage` di questo blocco mostra le statistiche di utilizzo dei token per l'intera richiesta e il campo `choices` sarà sempre una matrice vuota. Tutti gli altri blocchi includeranno anche un campo `usage`, ma con un valore null. NOTA: Se il flusso viene interrotto, è possibile che non si riceva il blocco di utilizzo finale che contiene l'utilizzo totale del token per la richiesta.	NO
temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	NO	1
tool_choice	OpenAI.ChatCompletionToolChoiceOption	Controlla quale strumento (se presente) viene chiamato dal modello. `none` indica che il modello non chiamerà alcuno strumento e genera invece un messaggio. `auto` indica che il modello può scegliere tra la generazione di un messaggio o la chiamata di uno o più strumenti. `required` indica che il modello deve chiamare uno o più strumenti. Se si specifica uno strumento specifico tramite `{"type": "function", "function": {"name": "my_function"}}` impone al modello di chiamare tale strumento. `none` è l'impostazione predefinita quando non sono presenti strumenti. `auto` è l'impostazione predefinita quando sono presenti strumenti.	NO
strumenti	array	Elenco di strumenti che il modello può chiamare. Attualmente, solo le funzioni sono supportate come strumento. Usare questa opzione per fornire un elenco di funzioni per cui il modello può generare input JSON. Sono supportate al massimo 128 funzioni.	NO
top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	NO	1
utente	corda	Identificatore univoco che rappresenta l’utente finale, che consente di monitorare e rilevare un abuso.	NO
user_security_context	AzureUserSecurityContext	Il contesto di sicurezza utente contiene diversi parametri che descrivono l'applicazione stessa e l'utente finale che interagisce con l'applicazione. Questi campi sono utili al team delle operazioni per la sicurezza per analizzare e mitigare gli incidenti di sicurezza fornendo un approccio esaustivo alla protezione delle applicazioni IA. Altre informazioni sulla protezione delle applicazioni di intelligenza artificiale tramite Microsoft Defender for Cloud.	NO

AzureCreateChatCompletionResponse

Modello di risposta di completamento della chat di primo livello esteso per il Azure OpenAI service. Questo modello aggiunge annotazioni di filtro del contenuto di intelligenza artificiale responsabile per l'input della richiesta.

Nome	TIPO	Descrzione	Obbligatorio
choices	array		Sì
created	numero intero	Timestamp Unix (in secondi) di quando è stato creato il completamento della chat.	Sì
id	corda	Identificatore univoco per il completamento della chat.	Sì
model	corda	Modello usato per il completamento della chat.	Sì
oggetto	enum	Il tipo di oggetto, che è sempre `chat.completion`. Valori possibili: `chat.completion`	Sì
prompt_filter_results	array	Annotazioni del filtro del contenuto di intelligenza artificiale responsabile associate agli input delle richieste nei completamenti della chat.	NO
system_fingerprint	corda	Questa impronta digitale rappresenta la configurazione back-end con cui viene eseguito il modello. Può essere usata insieme al parametro di richiesta `seed` per comprendere quando sono state apportate modifiche back-end che potrebbero influire sul determinismo.	NO
usage	OpenAI.CompletionUsage	Statistiche di utilizzo per la richiesta di completamento.	NO

AzureCreateChatCompletionStreamResponse

Nome	TIPO	Descrzione	Obbligatorio	Default
choices	array	Elenco di scelte di completamento della chat. Può contenere più elementi se `n` è maggiore di 1. Può anche essere vuoto per l'ultimo blocco se si imposta `stream_options: {"include_usage": true}`.	Sì
content_filter_results	AzureContentFilterResultForChoice	Risultato di un filtro contenuto per un singolo elemento di risposta prodotto da un sistema di intelligenza artificiale generativo.	NO
created	numero intero	Timestamp Unix (in secondi) di quando è stato creato il completamento della chat. Ogni blocco ha lo stesso timestamp.	Sì
delta	AzureChatCompletionStreamResponseDelta	Modello di risposta esteso per un messaggio di risposta di chat in streaming sul Azure OpenAI service. Questo modello aggiunge il supporto per il contesto dei messaggi di chat, usato dalla funzionalità On Your Data per finalità, citazioni e altre informazioni correlate alla generazione aumentata di recupero eseguita.	NO
id	corda	Identificatore univoco per il completamento della chat. Ogni blocco ha lo stesso ID.	Sì
model	corda	Modello per generare il completamento.	Sì
oggetto	enum	Il tipo di oggetto, che è sempre `chat.completion.chunk`. Valori possibili: `chat.completion.chunk`	Sì
system_fingerprint	corda	Questa impronta digitale rappresenta la configurazione back-end con cui viene eseguito il modello. Può essere usata insieme al parametro di richiesta `seed` per comprendere quando sono state apportate modifiche back-end che potrebbero influire sul determinismo.	NO
usage	oggetto	Statistiche di utilizzo per la richiesta di completamento.	NO
└completion_tokens	numero intero	Numero di token nel completamento generato.	NO	0
└─ dettagli_token_completamento	oggetto	Scomposizione dei token usati in un completamento.	NO
└─ token_di_predizione_accettati	numero intero	Quando si usano output stimati, il numero di token della previsione che compaiono nel completamento.	NO	0
└audio_tokens	numero intero	Token dell'input audio generati dal modello.	NO	0
└─ token_di_ragionamento	numero intero	Token generati dal modello per il ragionamento.	NO	0
└rejected_prediction_tokens	numero intero	Quando si usano output stimati, il numero di token della previsione che non compaiono nel completamento. Tuttavia, come i token di ragionamento, questi token vengono ancora conteggiati nel totale dei token di completamento ai fini della fatturazione, dell'output e dei limiti della finestra di contesto.	NO	0
└prompt_tokens	numero intero	Numero di token nel prompt.	NO	0
└prompt_tokens_details	oggetto	Suddivisione dei token usati nel prompt.	NO
└audio_tokens	numero intero	Token di input audio presenti nel prompt.	NO	0
└cached_tokens	numero intero	Token memorizzati nella cache presenti nel prompt.	NO	0
└total_tokens	numero intero	Numero totale di token usati nella richiesta (prompt + completamento).	NO	0

AzureCreateEmbeddingRequest

Nome	TIPO	Descrzione	Obbligatorio
dimensions	numero intero	Numero di dimensioni che devono essere presenti negli incorporamenti di output risultanti. Supportato solo in `text-embedding-3` e modelli successivi.	NO
encoding_format	enum	Formato in cui restituire gli incorporamenti. Può essere `float` o `base64`. Valori possibili: `float`, `base64`	NO
ingresso	stringa o matrice		Sì
model	corda	Modello da usare per la richiesta di incorporamento.	Sì
utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO

AzureCreateFileRequestMultiPart

Nome	TIPO	Descrzione	Obbligatorio
scade dopo	oggetto		Sì
Ancoraggio └*	AzureFileExpiryAnchor		NO
└─ secondi	numero intero		NO
documento	corda		Sì
purpose	enum	Scopo previsto del file caricato. Uno di: - `assistants`: usato nell'API Assistants - `batch`: usato nell'API Batch - `fine-tune`: usato per la messa a punto - `evals`: usato per i set di dati di valutazione. Valori possibili: `assistants`, `batch`, `fine-tune`, `evals`	Sì

AzureCreateImageEditRequestMultiPart

Nome	TIPO	Descrzione	Obbligatorio	Default
sfondo	enum	Consente di impostare la trasparenza per lo sfondo delle immagini generate. Questo parametro è supportato solo per i modelli della serie `gpt-image-1`. Deve essere uno di `transparent`o `opaqueauto` (valore predefinito). Quando `auto` viene usato, il modello determinerà automaticamente lo sfondo migliore per l'immagine. Se `transparent`, il formato di output deve supportare la trasparenza, quindi deve essere impostato su `png` (valore predefinito) o `webp`. Valori possibili: `transparent`, `opaque`, `auto`	NO
image	stringa o matrice		Sì
mask	corda		NO
model	corda	Distribuzione del modello da usare per l'operazione di modifica dell'immagine.	Sì
n	numero intero	Numero di immagini da generare. Deve essere compreso tra 1 e 10.	NO	1
Compressione dell'output	numero intero	Livello di compressione (0-100%) per le immagini generate. Questo parametro è supportato solo per i modelli `gpt-image-1`-series con il formato di output `webp` o `jpeg`, e il valore predefinito è 100.	NO	100
formato_di_output	enum	Formato in cui vengono restituite le immagini generate. Questo parametro è supportato solo per i modelli della serie `gpt-image-1`. Deve essere uno di `png`, `jpeg`o `webp`. Il valore predefinito è `png`. Valori possibili: `png`, `jpeg`, `webp`	NO
prompt	corda	Descrizione testuale delle immagini desiderate. La lunghezza massima è di 1000 caratteri per `dall-e-2`, e di 32000 caratteri per i modelli di serie `gpt-image-1`.	Sì
qualità	enum	La qualità dell'immagine che verrà generata. `high`, `medium` e `low` sono supportati solo per `gpt-image-1` i modelli serie. `dall-e-2` supporta solo la qualità `standard`. Il valore predefinito è `auto`. Valori possibili: `standard`, `lowmedium`, , `high`,`auto`	NO
formato_risposta	enum	Formato in cui vengono restituite le immagini generate. Deve essere `url` o `b64_json`. Gli URL sono validi solo per 60 minuti dopo la generazione dell'immagine. Questo parametro è supportato solo per `dall-e-2`, perché `gpt-image-1`i modelli -series restituiscono sempre immagini con codifica Base64. Valori possibili: `url`, `b64_json`	NO
size	enum	Dimensioni delle immagini generate. Deve essere uno di `1024x1024`, `1536x1024` (orizzontale), `1024x1536` (verticale) o `auto` (valore predefinito) per `gpt-image-1`-series modelli e uno di `256x256`, `512x512` o `1024x1024` per `dall-e-2`. Valori possibili: `256x256`, `512x5121024x1024`, `1536x1024`, , `1024x1536auto`	NO
utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO

AzureCreateImageRequest

Nome	TIPO	Descrzione	Obbligatorio	Default
sfondo	enum	Consente di impostare la trasparenza per lo sfondo delle immagini generate. Questo parametro è supportato solo per i modelli della serie `gpt-image-1`. Deve essere uno di `transparent`o `opaqueauto` (valore predefinito). Quando `auto` viene usato, il modello determinerà automaticamente lo sfondo migliore per l'immagine. Se `transparent`, il formato di output deve supportare la trasparenza, quindi deve essere impostato su `png` (valore predefinito) o `webp`. Valori possibili: `transparent`, `opaque`, `auto`	NO
model	corda	Distribuzione del modello da utilizzare per generare immagini.	Sì
moderation	enum	Controllare il livello di moderazione del contenuto per le immagini generate dai modelli della serie `gpt-image-1`. Deve essere uno tra `low` per un filtro meno restrittivo o `auto` (valore predefinito). Valori possibili: `low`, `auto`	NO
n	numero intero	Numero di immagini da generare. Deve essere compreso tra 1 e 10. Solo per `dall-e-3` è supportato `n=1`.	NO	1
Compressione dell'output	numero intero	Livello di compressione (0-100%) per le immagini generate. Questo parametro è supportato solo per i modelli `gpt-image-1`-series con il formato di output `webp` o `jpeg`, e il valore predefinito è 100.	NO	100
formato_di_output	enum	Formato in cui vengono restituite le immagini generate. Questo parametro è supportato solo per i modelli della serie `gpt-image-1`. Deve essere uno di `png`, `jpeg`o `webp`. Valori possibili: `png`, `jpeg`, `webp`	NO
prompt	corda	Descrizione testuale delle immagini desiderate. La lunghezza massima è di 32000 caratteri per `gpt-image-1`i modelli di serie, 1000 caratteri per `dall-e-2` e 4000 caratteri per `dall-e-3`.	Sì
qualità	enum	La qualità dell'immagine che verrà generata. - `auto` (valore predefinito) selezionerà automaticamente la migliore qualità per il modello specificato. - `high`, `medium` e `low` sono supportati per i modelli della serie `gpt-image-1`. - `hd` e `standard` sono supportati per `dall-e-3`. - `standard` è l'unica opzione per `dall-e-2`. Valori possibili: `standard`, `hdlow`, `medium`, , `highauto`	NO
formato_risposta	enum	Formato in cui vengono restituite le immagini generate con `dall-e-2` e `dall-e-3` . Deve essere `url` o `b64_json`. Gli URL sono validi solo per 60 minuti dopo la generazione dell'immagine. Questo parametro non è supportato per `gpt-image-1`i modelli di serie che restituiranno sempre immagini con codifica Base64. Valori possibili: `url`, `b64_json`	NO
size	enum	Dimensioni delle immagini generate. Deve essere uno di `1024x1024`, `1536x1024` (orizzontale), `1024x1536` (verticale) o `auto` (valore predefinito) per i modelli della serie `gpt-image-1`, uno di `256x256`, `512x512` o `1024x1024` per `dall-e-2`, e uno di `1024x1024`, `1792x1024` o `1024x1792` per `dall-e-3`. Valori possibili: `auto`, `1024x1024`, `1536x10241024x1536`, `256x256`, `512x512`, , `1792x10241024x1792`	NO
style	enum	Stile delle immagini generate. Questo parametro è supportato solo per `dall-e-3`. Deve essere `vivid` o `natural`. Vivid fa sì che il modello si appoggi verso la generazione di immagini iper-reali e drammatiche. Naturale permette al modello di creare immagini più naturali e meno iper-reali. Valori possibili: `vivid`, `natural`	NO
utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO

AzureCreateResponse

Nome	TIPO	Descrzione	Obbligatorio	Default
sfondo	boolean	Indica se eseguire la risposta del modello in background.	NO	Falso
includi	array	Specificare dati di output aggiuntivi da includere nella risposta del modello. I valori attualmente supportati sono: - `code_interpreter_call.outputs`: includono i risultati dell'esecuzione di Python negli elementi di chiamata dello strumento interprete di codice. - `computer_call_output.output.image_url`: includere gli URL delle immagini provenienti dall'output della chiamata computer. - `file_search_call.results`: includere i risultati della ricerca della chiamata allo strumento di ricerca file. - `message.input_image.image_url`: includere gli URL dell'immagine dal messaggio di input. - `message.output_text.logprobs`: includere logprob con messaggi di assistente. - `reasoning.encrypted_content`: Includere una versione crittografata dei token di ragionamento negli output degli elementi di ragionamento. Ciò consente di usare gli elementi di ragionamento nelle conversazioni a più turni quando si usa l'API Risposte senza stato (ad esempio quando il `store` parametro è impostato su `false`o quando un'organizzazione viene registrata nel programma di conservazione dei dati zero).	NO
ingresso	stringa o matrice		NO
instructions	corda	Messaggio di sistema (o sviluppatore) inserito nel contesto del modello. Quando si usa insieme a `previous_response_id`, le istruzioni di una risposta precedente non saranno trasferite alla risposta successiva. In questo modo è semplice scambiare messaggi di sistema (o sviluppatore) in nuove risposte.	NO
max_output_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per una risposta, inclusi token di output visibili e token di motivazione	NO
max_tool_calls	numero intero	Numero massimo di chiamate totali agli strumenti predefiniti che possono essere elaborati in una risposta. Questo numero massimo si applica a tutte le chiamate di strumenti predefinite, non a ogni singolo strumento. Eventuali altri tentativi di chiamare uno strumento da parte del modello verranno ignorati.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
model	corda	Il modello di distribuzione da utilizzare per la creazione di questa risposta.	Sì
chiamate_parallele_agli_strumenti	boolean	Indica se consentire al modello di eseguire chiamate degli strumenti in parallelo.	NO	Vero
previous_response_id	corda	ID univoco della risposta precedente al modello. Usare questa opzione per creare conversazioni a più turni.	NO
prompt	oggetto	Riferimento a un modello di richiesta e alle relative variabili.	NO
└* id	corda	Identificatore univoco del modello di richiesta da utilizzare.	NO
** └─ Variabili	OpenAI.ResponsePromptVariables	Mappa facoltativa di valori da sostituire con le variabili nel prompt. I valori di sostituzione possono essere stringhe o altri tipi di input response, ad esempio immagini o file.	NO
└─ versione	corda	Versione facoltativa del modello di richiesta.	NO
reasoning	oggetto	Solo modelli di serie o Opzioni di configurazione per i modelli di ragionamento.	NO
└* sforzo	Sforzo di Ragionamento OpenAI	Solo modelli di serie o Vincola il lavoro sul ragionamento per i modelli di ragionamento. I valori attualmente supportati sono `low`, `medium` e `high`. La riduzione del lavoro di ragionamento può tradursi in risposte più veloci e in un minor numero di token usati per il ragionamento in una risposta.	NO
└─ genera_sommario	enum	Deprecato: usare `summary` invece. Riepilogo del ragionamento eseguito dal modello. Ciò può essere utile per eseguire il debug e comprendere il processo di ragionamento del modello. Uno tra `auto`, `concise` e `detailed`. Valori possibili: `auto`, `concise`, `detailed`	NO
└─ Riepilogo	enum	Riepilogo del ragionamento eseguito dal modello. Ciò può essere utile per eseguire il debug e comprendere il processo di ragionamento del modello. Uno tra `auto`, `concise` e `detailed`. Valori possibili: `auto`, `concise`, `detailed`	NO
store	boolean	Indica se archiviare la risposta del modello generata per il recupero successivo tramite API.	NO	Vero
torrente	boolean	Se impostato su true, i dati di risposta del modello verranno trasmessi al client durante la generazione tramite eventi inviati dal server.	NO	Falso
temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	NO	1
Testo	oggetto	Opzioni di configurazione per una risposta di testo dal modello. Può essere un testo normale o dati JSON strutturati.	NO
└* formato	OpenAI.ResponseTextFormatConfiguration		NO
tool_choice	oggetto	Controlla quale strumento (se presente) viene chiamato dal modello. `none` indica che il modello non chiamerà alcuno strumento e genera invece un messaggio. `auto` indica che il modello può scegliere tra la generazione di un messaggio o la chiamata di uno o più strumenti. `required` indica che il modello deve chiamare uno o più strumenti.	NO
└─ Tipo	OpenAI.ToolChoiceObjectType	Indica che il modello deve usare uno strumento predefinito per generare una risposta.	NO
strumenti	array	Una matrice di strumenti che il modello può chiamare durante la generazione di una risposta. È possibile specificare lo strumento da usare impostando il `tool_choice` parametro . Le due categorie di strumenti che è possibile fornire al modello sono: - Strumenti predefiniti: strumenti forniti da OpenAI che estendono le funzionalità del modello, ad esempio la ricerca di file. - Chiamate di funzione (strumenti personalizzati): funzioni definite dall'utente, consentendo al modello di chiamare il proprio codice.	NO
top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	NO	1
truncation	enum	Strategia di troncamento da usare per la risposta del modello. - `auto`: se il contesto di questa risposta e quelli precedenti supera le dimensioni della finestra di contesto del modello, il modello tronca la risposta per adattarsi alla finestra di contesto eliminando gli elementi di input al centro della conversazione. - `disabled` (impostazione predefinita): se una risposta del modello supererà le dimensioni della finestra di contesto per un modello, la richiesta avrà esito negativo con un errore 400. Valori possibili: `auto`, `disabled`	NO
utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO

AzureCreateSpeechRequestMultiPart

Rappresentazione delle opzioni di richiesta che controllano il comportamento di un'operazione di sintesi vocale.

Nome	TIPO	Descrzione	Obbligatorio	Default
ingresso	corda	Testo per cui generare l'audio. La lunghezza massima è di 4096 caratteri.	Sì
instructions	corda	Controllare la voce dell'audio generato con istruzioni aggiuntive. Non funziona con `tts-1` o `tts-1-hd`.	NO
model	corda	Modello da usare per questa richiesta di sintesi vocale.	Sì
formato_risposta	oggetto	Formati di output audio supportati per la sintesi vocale.	NO
speed	numero	Velocità del parlato per l'audio generato. I valori sono validi nell'intervallo compreso tra 0,25 e 4.0, con 1.0 i valori predefiniti e superiori corrispondenti alla voce più veloce.	NO	1
stream_format	enum	Formato in cui trasmettere l'audio. I formati supportati sono `sse` e `audio`. `sse` non è supportato per `tts-1` o `tts-1-hd`. Valori possibili: `sse`, `audio`	NO
voice	oggetto		Sì

AzureCreateTranscriptionRequestMultiPart

Informazioni di configurazione per una richiesta di trascrizione audio.

Nome	TIPO	Descrzione	Obbligatorio	Default
chunking_strategy	oggetto		NO
└prefix_padding_ms	numero intero	Quantità di audio da includere prima del riconoscimento vocale rilevato da VAD (in millisecondi).	NO	300
└durata_silenzio_ms	numero intero	Durata del silenzio per rilevare l'arresto vocale (in millisecondi). Con valori più brevi, il modello risponderà più rapidamente, ma potrebbe attivarsi durante le brevi pause dell'utente.	NO	200
└* soglia	numero	Soglia di sensibilità (da 0,0 a 1,0) per il rilevamento delle attività vocali. Una soglia più elevata richiederà un audio più forte per attivare il modello e quindi potrebbe offrire prestazioni migliori in ambienti rumorosi.	NO	0,5
└─ Tipo	enum	Deve essere impostato su `server_vad` per abilitare la suddivisione in blocchi manuale tramite VAD sul lato server. Valori possibili: `server_vad`	NO
documento	corda		Sì
filename	corda	Nome file facoltativo o identificatore descrittivo da associare ai dati audio.	NO
include[]	array	Informazioni aggiuntive da includere nella risposta di trascrizione. `logprobs` restituirà le probabilità di log dei token nella risposta per comprendere la fiducia del modello nella trascrizione. `logprobs` funziona solo con response_format impostato su `json` e solo con i modelli `gpt-4o-transcribe`, `gpt-4o-transcribe-diarize`, `gpt-4o-mini-transcribe`e `gpt-4o-mini-transcribe-2025-12-15`.	NO
language	corda	La lingua dell'audio di input. Specificare il linguaggio di input nel formato ISO-639-1 (ad esempio `en`) migliorerà l'accuratezza e la latenza.	NO
model	corda	Modello da usare per questa richiesta di trascrizione.	NO
prompt	corda	Testo facoltativo per guidare lo stile del modello o continuare un segmento audio precedente. La richiesta deve corrispondere alla lingua audio.	NO
formato_risposta	oggetto		NO
torrente	boolean	Se impostato su true, i dati di risposta del modello verranno trasmessi al client durante la generazione tramite eventi inviati dal server. Nota: lo streaming non è supportato per il `whisper-1` modello e verrà ignorato.	NO	Falso
temperatura	numero	Temperatura di campionamento, compresa tra 0 e 1. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. Se impostato su 0, il modello userà la probabilità di log per aumentare automaticamente la temperatura fino a raggiungere determinate soglie.	NO	0
timestamp_granularities[]	array	Granularità del timestamp da popolare per questa trascrizione. `response_format` deve essere impostato su `verbose_json` per usare le granularità del timestamp. Sono supportate entrambe le opzioni seguenti: `word` o `segment`. Nota: non esiste una latenza aggiuntiva per i timestamp dei segmenti, ma la generazione di timestamp delle parole comporta una latenza aggiuntiva.	NO	['segment']

AzureCreateTranslationRequestMultiPart

Informazioni di configurazione per una richiesta di trascrizione audio.

Nome	TIPO	Descrzione	Obbligatorio	Default
documento	corda		Sì
filename	corda	Nome file facoltativo o identificatore descrittivo da associare ai dati audio	NO
model	corda	Modello da utilizzare per questa richiesta di traduzione.	NO
prompt	corda	Testo facoltativo per guidare lo stile del modello o continuare un segmento audio precedente. Il prompt deve essere in inglese.	NO
formato_risposta	oggetto		NO
temperatura	numero	Temperatura di campionamento, compresa tra 0 e 1. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. Se impostato su 0, il modello userà la probabilità di log per aumentare automaticamente la temperatura fino a raggiungere determinate soglie.	NO	0

AzureErrorResponse

Nome	TIPO	Descrzione	Obbligatorio
Errore	oggetto	Dettagli dell'errore.	NO
└─ codice	corda	Identificatore distinto generato dal computer per l'errore.	NO
└─ errore_interno			NO
└* messaggio	corda	Messaggio leggibile associato all'errore.	NO
└* param	corda	Se applicabile, il parametro di input della richiesta associato all'errore	NO
└─ Tipo	enum	Tipo di oggetto, sempre 'error'. Valori possibili: `error`	NO

AzureEvalAPICompletionsSamplingParams

Nome	TIPO	Obbligatorio
chiamate_parallele_agli_strumenti	boolean	NO
formato_risposta	OpenAI.ResponseTextFormatConfiguration	NO
strumenti	array	NO

AzureEvalAPIModelSamplingParams

Nome	TIPO	Descrzione	Obbligatorio
numero massimo di token	numero intero	Numero massimo di token nell'output generato.	NO
sforzo di ragionamento	enum	Controllare il livello di sforzo di ragionamento applicato durante la generazione. Valori possibili: `low`, `medium`, `high`	NO
seed	numero intero	Valore di inizializzazione per inizializzare la casualità durante il campionamento.	NO
temperatura	numero	Una temperatura più elevata aumenta la casualità negli output.	NO
top_p	numero	Un'alternativa alla temperatura per il campionamento del nucleo; 1.0 include tutti i token.	NO

AzureEvalAPIResponseSamplingParams

Nome	TIPO	Obbligatorio
chiamate_parallele_agli_strumenti	boolean	NO
formato_risposta	OpenAI.ResponseTextFormatConfiguration	NO
strumenti	array	NO

AzureFileExpiryAnchor

Proprietà	Value
Tipo	corda
Valori	`created_at`

AzureFineTuneReinforcementMethod

Nome	TIPO	Descrzione	Obbligatorio
cernitore	oggetto	Oggetto StringCheckGrader che esegue un confronto di stringhe tra input e riferimento usando un'operazione specificata.	Sì
└' calculate_output	corda	Formula per calcolare l'output in base ai risultati del classificatore.	NO
└' evaluation_metric	enum	Metrica di valutazione da usare. Uno di `fuzzy_match`, `bleu`, `gleu`, `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5` o `rouge_l`. Valori possibili: `fuzzy_match`, `bleu`, `gleumeteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5rouge_l`	NO
└️ voti	oggetto		NO
└ Input	array	Testo di input. Ciò può includere stringhe di modello.	NO
└─ Modello	corda	Modello da utilizzare per la valutazione.	NO
└> nome	corda	Nome del grader.	NO
└─ Operazione	enum	Operazione di controllo della stringa da eseguire. Uno tra `eq`, `ne`, `like` o `ilike`. Valori possibili: `eq`, `ne`, `like`, `ilike`	NO
└* intervallo	array	La gamma del punteggio. Il valore predefinito è `[0, 1]`.	NO
Riferimento	corda	Testo che viene valutato.	NO
└sampling_params		Parametri di campionamento per il modello.	NO
└─ Tipo	enum	Il tipo di oggetto, che è sempre `multi`. Valori possibili: `multi`	NO
iperparametri	OpenAI.FineTuneReinforcementHyperparameters	Iperparametri usati per il processo di ottimizzazione per rinforzo.	NO
formato_risposta	oggetto		NO
└ json_schema	oggetto	Schema JSON per il formato di risposta	NO
└─ Tipo	enum	Tipo di formato di risposta. Valori possibili: `json_schema`	NO

AzureImage

Nome	TIPO	Descrzione	Obbligatorio
b64_json	corda	JSON con codifica Base64 dell'immagine generata. Valore predefinito per i modelli `gpt-image-1`-series e presente solo se `response_format` è impostato su `b64_json` per `dall-e-2` e `dall-e-3`.	NO
content_filter_results	AzureContentFilterImageResponseResults	Risultato di un filtro contenuto per il contenuto della risposta di output di un'operazione di generazione di immagini.	Sì
prompt_filter_results	AzureContentFilterImagePromptResults	Risultato del filtro dei contenuti per il contenuto della richiesta di input per l'operazione di generazione di immagini.	Sì
testo_rivisto	corda	Solo per `dall-e-3` il prompt modificato usato per generare l'immagine.	NO
URL.	corda	Quando si usa `dall-e-2` o `dall-e-3`, l'URL dell'immagine generata se `response_format` è impostato su `url` (valore predefinito). Non compatibile con i modelli della serie `gpt-image-1`.	NO

AzureImagesResponse

Nome	TIPO	Descrzione	Obbligatorio
sfondo	enum	Parametro di sfondo utilizzato per la generazione dell'immagine. `transparent` o `opaque`. Valori possibili: `transparent`, `opaque`	NO
created	numero intero	Timestamp Unix (in secondi) di quando è stata creata l'immagine.	Sì
data	array		NO
formato_di_output	enum	Formato di output della generazione dell'immagine. Deve essere `png`, `webp` o `jpeg`. Valori possibili: `png`, `webp`, `jpeg`	NO
qualità	enum	Qualità dell'immagine generata. Deve essere `low`, `medium` o `high`. Valori possibili: `low`, `medium`, `high`	NO
size	enum	Dimensioni dell'immagine generata. Deve essere `1024x1024`, `1024x1536` o `1536x1024`. Valori possibili: `1024x1024`, `1024x1536`, `1536x1024`	NO
usage	oggetto	Solo per i modelli della serie `gpt-image-1`, le informazioni sull'utilizzo del token per la generazione dell'immagine.	NO
└ input_tokens	numero intero	Il numero di token (immagini e testo) nel prompt di input.	NO
└input_tokens_details	oggetto	I token di input contengono informazioni dettagliate per la generazione di immagini.	NO
└ image_tokens	numero intero	Numero di token di immagine nel prompt di input.	NO
└ text_tokens	numero intero	Numero di token di testo nel prompt di input.	NO
└output_tokens	numero intero	Numero di token di immagine nell'immagine di output.	NO
└total_tokens	numero intero	Numero totale di token (immagini e testo) usati per la generazione di immagini.	NO

AzureListFilesResponse

Nome	TIPO	Descrzione	Obbligatorio
data	array		Sì
first_id	corda		Sì
ha_di_piu	boolean		Sì
last_id	corda		Sì
oggetto	enum	Valori possibili: `list`	Sì

AzureOpenAIFile

Nome	TIPO	Descrzione	Obbligatorio
bytes	numero intero	Le dimensioni del file in byte.	Sì
creato_il	numero intero	Timestamp Unix (in secondi) per la creazione del file.	Sì
scade_il	numero intero	Timestamp Unix (in secondi) per la scadenza del file.	NO
filename	corda	Nome del file.	Sì
id	corda	Identificatore di file a cui è possibile fare riferimento negli endpoint dell'API.	Sì
oggetto	enum	Il tipo di oggetto, che è sempre `file`. Valori possibili: `file`	Sì
purpose	enum	Scopo previsto del file. I valori supportati sono `assistants`, `assistants_output`, `batch`, `batch_output`, `fine-tune` e `fine-tune-results`. Valori possibili: `assistants`, `assistants_output`, `batch`, `batch_output`, `fine-tune`, `fine-tune-results`, `evals`	Sì
stato	enum	Valori possibili: `uploaded`, `pending`, `running`, `processed`, `error`, `deleting`, `deleted`	Sì
dettagli dello stato	corda	Deprecated. Per informazioni dettagliate sul motivo per cui la convalida di un file di training di ottimizzazione non è riuscita, vedere il campo `error` in `fine_tuning.job`.	NO

AzureOpenAIVideoGenerationErrorResponse

Nome	TIPO	Descrzione	Obbligatorio
codice	corda	Identificatore distinto generato dal computer per l'errore.	NO
inner_error	oggetto	Se applicabile, un errore upstream che ha generato questo errore.	NO
└─ codice	enum	Codice associato all'errore interno. Valori possibili: `ResponsibleAIPolicyViolation`	NO
└─ dettagli_errore		Dettagli dei risultati del filtro del contenuto associati all'errore interno.	NO
└ revised_prompt	corda	Se applicabile, il prompt modificato usato per la generazione.	NO
message	corda	Messaggio leggibile associato all'errore.	NO
param	corda	Se applicabile, il parametro di input della richiesta associato all'errore	NO
type	corda	Se applicabile, il numero di riga di input associato all'errore.	NO

AzureResponse

Nome	TIPO	Descrzione	Obbligatorio	Default
sfondo	boolean	Indica se eseguire la risposta del modello in background.	NO	Falso
creato_il	numero intero	Timestamp Unix (in secondi) di quando è stata creata questa risposta.	Sì
Errore	oggetto	Oggetto di errore restituito quando il modello non riesce a generare una risposta.	Sì
└─ codice	OpenAI.ResponseErrorCode	Codice di errore per la risposta.	NO
└* messaggio	corda	Descrizione leggibile dell'errore.	NO
id	corda	Identificatore univoco per questa risposta.	Sì
incomplete_details	oggetto	Informazioni dettagliate sul motivo per cui la risposta è incompleta.	Sì
└* motivo	enum	Motivo per cui la risposta è incompleta. Valori possibili: `max_output_tokens`, `content_filter`	NO
instructions	stringa o matrice		Sì
max_output_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per una risposta, inclusi token di output visibili e token di motivazione	NO
max_tool_calls	numero intero	Numero massimo di chiamate totali agli strumenti predefiniti che possono essere elaborati in una risposta. Questo numero massimo si applica a tutte le chiamate di strumenti predefinite, non a ogni singolo strumento. Eventuali altri tentativi di chiamare uno strumento da parte del modello verranno ignorati.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	Sì
model	corda	Modello usato per generare questa risposta.	Sì
oggetto	enum	Tipo di oggetto di questa risorsa: sempre impostato su `response`. Valori possibili: `response`	Sì
output	array	Matrice di elementi di contenuto generati dal modello. - La lunghezza e l'ordine degli elementi nella `output` matrice dipendono dalla risposta del modello. - Anziché accedere al primo elemento nella `output` matrice e presupponendo che si tratti di un `assistant` messaggio con il contenuto generato dal modello, è consigliabile usare la `output_text` proprietà in cui è supportato negli SDK.	Sì
output_text	corda	Proprietà utile solo SDK che contiene l'output di testo aggregato di tutti gli elementi `output_text` della matrice `output`, se presenti. Supportato negli SDK Python e JavaScript.	NO
chiamate_parallele_agli_strumenti	boolean	Indica se consentire al modello di eseguire chiamate degli strumenti in parallelo.	Sì	Vero
previous_response_id	corda	ID univoco della risposta precedente al modello. Usare questa opzione per creare conversazioni a più turni.	NO
prompt	oggetto	Riferimento a un modello di richiesta e alle relative variabili.	NO
└* id	corda	Identificatore univoco del modello di richiesta da utilizzare.	NO
** └─ Variabili	OpenAI.ResponsePromptVariables	Mappa facoltativa di valori da sostituire con le variabili nel prompt. I valori di sostituzione possono essere stringhe o altri tipi di input response, ad esempio immagini o file.	NO
└─ versione	corda	Versione facoltativa del modello di richiesta.	NO
reasoning	oggetto	Solo modelli di serie o Opzioni di configurazione per i modelli di ragionamento.	NO
└* sforzo	Sforzo di Ragionamento OpenAI	Solo modelli di serie o Vincola il lavoro sul ragionamento per i modelli di ragionamento. I valori attualmente supportati sono `low`, `medium` e `high`. La riduzione del lavoro di ragionamento può tradursi in risposte più veloci e in un minor numero di token usati per il ragionamento in una risposta.	NO
└─ genera_sommario	enum	Deprecato: usare `summary` invece. Riepilogo del ragionamento eseguito dal modello. Ciò può essere utile per eseguire il debug e comprendere il processo di ragionamento del modello. Uno tra `auto`, `concise` e `detailed`. Valori possibili: `auto`, `concise`, `detailed`	NO
└─ Riepilogo	enum	Riepilogo del ragionamento eseguito dal modello. Ciò può essere utile per eseguire il debug e comprendere il processo di ragionamento del modello. Uno tra `auto`, `concise` e `detailed`. Valori possibili: `auto`, `concise`, `detailed`	NO
stato	enum	Stato della generazione della risposta. Uno di `completed`, `failed`, `in_progresscancelled`, `queued`, o `incomplete`. Valori possibili: `completed`, `failedin_progress`, `cancelled`, , `queuedincomplete`	NO
temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	Sì
Testo	oggetto	Opzioni di configurazione per una risposta di testo dal modello. Può essere un testo normale o dati JSON strutturati.	NO
└* formato	OpenAI.ResponseTextFormatConfiguration		NO
tool_choice	oggetto	Controlla quale strumento (se presente) viene chiamato dal modello. `none` indica che il modello non chiamerà alcuno strumento e genera invece un messaggio. `auto` indica che il modello può scegliere tra la generazione di un messaggio o la chiamata di uno o più strumenti. `required` indica che il modello deve chiamare uno o più strumenti.	NO
└─ Tipo	OpenAI.ToolChoiceObjectType	Indica che il modello deve usare uno strumento predefinito per generare una risposta.	NO
strumenti	array	Una matrice di strumenti che il modello può chiamare durante la generazione di una risposta. È possibile specificare lo strumento da usare impostando il `tool_choice` parametro . Le due categorie di strumenti che è possibile fornire al modello sono: - Strumenti predefiniti: strumenti forniti da OpenAI che estendono le funzionalità del modello.	NO
top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	Sì
truncation	enum	Strategia di troncamento da usare per la risposta del modello. - `auto`: se il contesto di questa risposta e quelli precedenti supera le dimensioni della finestra di contesto del modello, il modello tronca la risposta per adattarsi alla finestra di contesto eliminando gli elementi di input al centro della conversazione. - `disabled` (impostazione predefinita): se una risposta del modello supererà le dimensioni della finestra di contesto per un modello, la richiesta avrà esito negativo con un errore 400. Valori possibili: `auto`, `disabled`	NO
usage	OpenAI.ResponseUsage	Rappresenta i dettagli di utilizzo dei token, inclusi i token di input, i token di output, la suddivisione dei token di output e i token totali usati.	NO
utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	Sì

AzureSearchChatDataSource

Rappresenta una configurazione dell'origine dati che userà una risorsa di ricerca Azure.

Nome	TIPO	Descrzione	Obbligatorio	Default
parameters	oggetto	Informazioni sui parametri per controllare l'uso dell'origine dati di ricerca Azure.	Sì
└─ consenti_risultato_parziale	boolean	Se impostato su true, il sistema consentirà l'uso di risultati parziali della ricerca e la richiesta avrà esito negativo se tutte le query parziali hanno esito negativo. Se non specificato, o specificato come false, la richiesta avrà esito negativo se una query di ricerca ha esito negativo.	NO	Falso
Autenticazione	oggetto		NO
└access_token	corda		NO
└─ tasto	corda		NO
└managed_identity_resource_id	corda		NO
└─ Tipo	enum	Valori possibili: `access_token`	NO
└─ dipendenza_embedded	oggetto	Rappresenta un'origine di vettorizzazione che effettua chiamate al servizio pubblico su una distribuzione del modello di incorporamento OpenAI Azure.	NO
Autenticazione	AzureChatDataSourceApiKeyAuthenticationOptions o AzureChatDataSourceAccessTokenAuthenticationOptions	Meccanismo di autenticazione da usare con la fonte di vettorializzazione basata sugli endpoint. L'autenticazione degli endpoint supporta la chiave API e i meccanismi di token access.	NO
└─ nome_distribuzione	corda	Distribuzione del modello di embedding da usare per la vettorizzazione. Questa distribuzione deve esistere all'interno della stessa risorsa OpenAI Azure della distribuzione del modello usata per i completamenti della chat.	NO
└─ dimensioni	numero intero	Numero di dimensioni da richiedere per gli incorporamenti. Supportato solo nei modelli "text-embedding-3" e versioni successive.	NO
Endpoint └*	corda	Specifica l'URL dell'endpoint della risorsa da cui recuperare gli incorporamenti. Deve essere nel formato di: https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings. Il parametro di query api-version non è consentito.	NO
└─ Tipo	enum	Identificatore del tipo, sempre "integrato" per questo tipo di origine di vettorizzazione. Valori possibili: `integrated`	NO
Endpoint └*	corda	Percorso endpoint assoluto da usare per la risorsa di ricerca Azure.	NO
└ fields_mapping	oggetto	Mapping dei campi da usare con la risorsa di ricerca Azure.	NO
└content_fields	array	I nomi dei campi di indice che devono essere gestiti come contenuto.	NO
└─content_fields_separator	corda	Il modello separatore che devono usare i campi di contenuto.	NO
└filepath_field	corda	Il nome del campo di indice da usare come percorso file.	NO
└─ campi_di_vettore_immagine	array	Il nome dei campi che rappresentano i dati del vettore dell’immagine.	NO
└─ campo_titolo	corda	Il nome del campo indice da usare come titolo.	NO
└url_field	corda	Nome del campo di indice da usare come URL.	NO
└vector_fields	array	Nomi dei campi che rappresentano dati vettoriali.	NO
└─ Filtro	corda	Filtro da applicare alla ricerca.	NO
└ in_scope	boolean	Indica se le query devono essere limitate all'uso dei dati indicizzati.	NO
└include_contexts	array	Proprietà del contesto di output da includere nella risposta. Per impostazione predefinita, verranno richieste citazioni e finalità.	NO	['citazioni', 'intento']
└ index_name	corda	Nome dell'indice da usare, come specificato nella risorsa di ricerca Azure.	NO
└max_search_queries	numero intero	Numero massimo di query riscritte che devono essere inviate al provider di ricerca per un singolo messaggio utente. Per impostazione predefinita, il sistema effettuerà una determinazione automatica.	NO
└query_type	enum	Tipo di query da usare per la risorsa di ricerca Azure. Valori possibili: `simple`, `semanticvector`, , `vector_simple_hybrid`,`vector_semantic_hybrid`	NO
└─ configurazione_semantica	corda	Configurazione semantica aggiuntiva per la query.	NO
└* rigidità	numero intero	La rigidità configurata del filtro di pertinenza della ricerca. Una maggiore rigidità aumenterà la precisione, ma diminuirà il richiamo della risposta.	NO
└top_n_documents	numero intero	Il numero configurato di documenti da includere nella query.	NO
type	enum	Identificatore di tipo discriminato, che è sempre "azure_search". Valori possibili: `azure_search`	Sì

AzureUserSecurityContext

Il contesto di sicurezza utente contiene diversi parametri che descrivono l'applicazione stessa e l'utente finale che interagisce con l'applicazione. Questi campi sono utili al team delle operazioni per la sicurezza per analizzare e mitigare gli incidenti di sicurezza fornendo un approccio esaustivo alla protezione delle applicazioni IA. Altre informazioni sulla protezione delle applicazioni di intelligenza artificiale tramite Microsoft Defender for Cloud.

Nome	TIPO	Descrzione	Obbligatorio
application_name	corda	Nome dell'applicazione. I dati personali sensibili non devono essere inclusi in questo campo.	NO
end_user_id	corda	Questo identificatore è l'ID oggetto utente Microsoft Entra ID (in precedenza Azure Active Directory) usato per autenticare gli utenti finali all'interno dell'applicazione di intelligenza artificiale generativa. I dati personali sensibili non devono essere inclusi in questo campo.	NO
end_user_tenant_id	corda	ID tenant Microsoft 365 cui appartiene l'utente finale. È necessario quando l'applicazione di intelligenza artificiale generativa è multi-tenant.	NO
source_ip	corda	Acquisisce l'indirizzo IP del client originale.	NO

ChatCompletionMessageToolCallsItem

Le chiamate degli strumenti generate dal modello, ad esempio le chiamate di funzioni.

Matrice di: OpenAI.ChatCompletionMessageToolCall

CreateVideoGenerationRequest

Nome	TIPO	Descrzione	Obbligatorio	Default
altezza	numero intero	Altezza del video. Sono supportate le dimensioni seguenti: 480x480, 854x480, 720x720, 1280x720, 1080x1080 e 1920x1080 con orientamento orizzontale e verticale.	Sì
model	corda	Nome dell'implementazione da usare per questa richiesta.	Sì
n_seconds	numero intero	Durata del processo di generazione video. Deve essere compreso tra 1 e 20 secondi.	NO	5
n_variants	numero intero	Numero di video da creare come varianti per questo processo. Deve essere compreso tra 1 e 5. Le dimensioni più piccole consentono più varianti.	NO	1
prompt	corda	Richiesta di questo processo di generazione video.	Sì
Larghezza	numero intero	Larghezza del video. Sono supportate le dimensioni seguenti: 480x480, 854x480, 720x720, 1280x720, 1080x1080 e 1920x1080 con orientamento orizzontale e verticale.	Sì

CreateVideoGenerationWithMediaRequestMultiPart

Proprietà di una richiesta di processo di generazione video con file multimediali.

Nome	TIPO	Descrzione	Obbligatorio	Default
files	array		Sì
altezza	numero intero	Altezza del video. Sono supportate le dimensioni seguenti: 480x480, 854x480, 720x720, 1280x720, 1080x1080 e 1920x1080 con orientamento orizzontale e verticale.	Sì
inpaint_items	array	Elementi di aggiornamento facoltativi per questo processo di generazione video.	NO
model	corda	Nome dell'implementazione da usare per questa richiesta.	Sì
n_seconds	numero intero	Durata del processo di generazione video. Deve essere compreso tra 1 e 20 secondi.	NO	5
n_variants	numero intero	Numero di video da creare come varianti per questo processo. Deve essere compreso tra 1 e 5. Le dimensioni più piccole consentono più varianti.	NO	1
prompt	corda	Richiesta di questo processo di generazione video.	Sì
Larghezza	numero intero	Larghezza del video. Sono supportate le dimensioni seguenti: 480x480, 854x480, 720x720, 1280x720, 1080x1080 e 1920x1080 con orientamento orizzontale e verticale.	Sì

CropBounds

Limiti di ritaglio per un elemento di ritocco digitale. Specifica l'area dell'elemento multimediale da utilizzare per l'aggiornamento.

Nome	TIPO	Descrzione	Obbligatorio	Default
bottom_fraction	numero	Limite inferiore della casella di ritaglio specificata come frazione dell'altezza dell'elemento multimediale originale. Deve essere compreso tra 0.0 e 1.0. Usare ad esempio 0,5 per metà dell'altezza dell'elemento multimediale originale.	NO	1
left_fraction	numero	Limite sinistro della casella di ritaglio specificato come frazione della larghezza dell'elemento multimediale originale. Deve essere compreso tra 0.0 e 1.0. Usare ad esempio 0,5 per metà della larghezza dell'elemento multimediale originale.	NO	0
right_fraction	numero	Limite destro della casella di ritaglio specificato come frazione della larghezza dell'elemento multimediale originale. Deve essere compreso tra 0.0 e 1.0. Usare ad esempio 0,5 per metà della larghezza dell'elemento multimediale originale.	NO	1
top_fraction	numero	Limite superiore della casella di ritaglio specificata come frazione dell'altezza dell'elemento multimediale originale. Deve essere compreso tra 0.0 e 1.0. Usare ad esempio 0,5 per metà dell'altezza dell'elemento multimediale originale.	NO	0

ElasticsearchChatDataSource

Nome	TIPO	Descrzione	Obbligatorio	Default
parameters	oggetto	Informazioni sui parametri per controllare l'uso dell'origine dati Elasticsearch.	Sì
└─ consenti_risultato_parziale	boolean	Se impostato su true, il sistema consentirà l'uso di risultati parziali della ricerca e la richiesta avrà esito negativo se tutte le query parziali hanno esito negativo. Se non specificato, o specificato come false, la richiesta avrà esito negativo se una query di ricerca ha esito negativo.	NO	Falso
Autenticazione	oggetto		NO
└─ chiave_api_cifrata	corda		NO
└─ tasto	corda		NO
└─key_id	corda		NO
└─ Tipo	enum	Valori possibili: `encoded_api_key`	NO
└─ dipendenza_embedded	AzureChatDataSourceVectorizationSource	Rappresentazione di un'origine di vettorizzazione dei dati utilizzabile come risorsa di incapsulamento con un'origine di dati.	NO
Endpoint └*	corda		NO
└ fields_mapping	oggetto		NO
└content_fields	array		NO
└─content_fields_separator	corda		NO
└filepath_field	corda		NO
└─ campo_titolo	corda		NO
└url_field	corda		NO
└vector_fields	array		NO
└ in_scope	boolean	Indica se le query devono essere limitate all'uso dei dati indicizzati.	NO
└include_contexts	array	Proprietà del contesto di output da includere nella risposta. Per impostazione predefinita, verranno richieste citazioni e finalità.	NO	['citazioni', 'intento']
└ index_name	corda		NO
└max_search_queries	numero intero	Numero massimo di query riscritte che devono essere inviate al provider di ricerca per un singolo messaggio utente. Per impostazione predefinita, il sistema effettuerà una determinazione automatica.	NO
└query_type	enum	Valori possibili: `simple`, `vector`	NO
└* rigidità	numero intero	La rigidità configurata del filtro di pertinenza della ricerca. Una maggiore rigidità aumenterà la precisione, ma diminuirà il richiamo della risposta.	NO
└top_n_documents	numero intero	Il numero configurato di documenti da includere nella query.	NO
type	enum	Identificatore di tipo discriminato, che è sempre "elasticsearch". Valori possibili: `elasticsearch`	Sì

InpaintItem

Elemento di aggiornamento per un processo di generazione di video. Specifica l'elemento multimediale che deve essere usato per l'aggiornamento nella generazione di video.

Nome	TIPO	Descrzione	Obbligatorio	Default
crop_bounds	oggetto	Limiti di ritaglio per un elemento di ritocco digitale. Specifica l'area dell'elemento multimediale da utilizzare per l'aggiornamento.	NO
└' bottom_fraction	numero	Limite inferiore della casella di ritaglio specificata come frazione dell'altezza dell'elemento multimediale originale. Deve essere compreso tra 0.0 e 1.0. Usare ad esempio 0,5 per metà dell'altezza dell'elemento multimediale originale.	NO	1
└' left_fraction	numero	Limite sinistro della casella di ritaglio specificato come frazione della larghezza dell'elemento multimediale originale. Deve essere compreso tra 0.0 e 1.0. Usare ad esempio 0,5 per metà della larghezza dell'elemento multimediale originale.	NO	0
└' right_fraction	numero	Limite destro della casella di ritaglio specificato come frazione della larghezza dell'elemento multimediale originale. Deve essere compreso tra 0.0 e 1.0. Usare ad esempio 0,5 per metà della larghezza dell'elemento multimediale originale.	NO	1
└' top_fraction	numero	Limite superiore della casella di ritaglio specificata come frazione dell'altezza dell'elemento multimediale originale. Deve essere compreso tra 0.0 e 1.0. Usare ad esempio 0,5 per metà dell'altezza dell'elemento multimediale originale.	NO	0
file_name	corda	Nome file dell'elemento multimediale. Deve corrispondere al nome file di un file allegato in questa richiesta.	Sì
frame_index	numero intero	Indice dei frame per questo elemento multimediale. Specifica il frame iniziale nel video generato risultante per questo elemento di aggiornamento.	Sì	0
type	oggetto	Tipo dell'elemento di aggiornamento.	Sì

JobStatus

Stato di un processo di generazione video.

Proprietà	Value
Descrizione	Stato di un processo di generazione video.
Tipo	corda
Valori	`preprocessing` `queued` `running` `processing` `cancelled` `succeeded` `failed`

MediaItemType

Tipo dell'elemento di aggiornamento.

Proprietà	Value
Descrizione	Tipo dell'elemento di aggiornamento.
Tipo	corda
Valori	`image`

MongoDBChatDataSource

Nome	TIPO	Descrzione	Obbligatorio	Default
parameters	oggetto	Informazioni sui parametri per controllare l'uso dell'origine dati MongoDB.	Sì
└─ consenti_risultato_parziale	boolean	Se impostato su true, il sistema consentirà l'uso di risultati parziali della ricerca e la richiesta avrà esito negativo se tutte le query parziali hanno esito negativo. Se non specificato, o specificato come false, la richiesta avrà esito negativo se una query di ricerca ha esito negativo.	NO	Falso
└ app_name	corda	Nome dell'applicazione MongoDB.	NO
Autenticazione	oggetto		NO
└ password	corda		NO
└─ Tipo	enum	Valori possibili: `username_and_password`	NO
└\ nome utente	corda		NO
└collection_name	corda	Nome della raccolta MongoDB.	NO
└─database_name	corda	Nome del database MongoDB.	NO
└─ dipendenza_embedded	oggetto	Rappresenta un'origine di vettorizzazione che effettua chiamate al servizio pubblico su una distribuzione del modello di incorporamento OpenAI Azure.	NO
Autenticazione	AzureChatDataSourceApiKeyAuthenticationOptions o AzureChatDataSourceAccessTokenAuthenticationOptions	Meccanismo di autenticazione da usare con la fonte di vettorializzazione basata sugli endpoint. L'autenticazione degli endpoint supporta la chiave API e i meccanismi di token access.	NO
└─ nome_distribuzione	corda	Distribuzione del modello di embedding da usare per la vettorizzazione. Questa distribuzione deve esistere all'interno della stessa risorsa OpenAI Azure della distribuzione del modello usata per i completamenti della chat.	NO
└─ dimensioni	numero intero	Numero di dimensioni da richiedere per gli incorporamenti. Supportato solo nei modelli "text-embedding-3" e versioni successive.	NO
Endpoint └*	corda	Specifica l'URL dell'endpoint della risorsa da cui recuperare gli incorporamenti. Deve essere nel formato di: https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings. Il parametro di query api-version non è consentito.	NO
└─ Tipo	enum	Identificatore del tipo, sempre "deployment_name" per questo tipo di origine di vettorizzazione. Valori possibili: `deployment_name`	NO
Endpoint └*	corda	Nome dell'endpoint del cluster MongoDB.	NO
└ fields_mapping	oggetto	Mappature dei campi da applicare ai dati utilizzati dalla sorgente dati MongoDB. Si noti che i mapping del contenuto e dei campi vettoriali sono necessari per MongoDB.	NO
└content_fields	array		NO
└─content_fields_separator	corda		NO
└filepath_field	corda		NO
└─ campo_titolo	corda		NO
└url_field	corda		NO
└vector_fields	array		NO
└ in_scope	boolean	Indica se le query devono essere limitate all'uso dei dati indicizzati.	NO
└include_contexts	array	Proprietà del contesto di output da includere nella risposta. Per impostazione predefinita, verranno richieste citazioni e finalità.	NO	['citazioni', 'intento']
└ index_name	corda	Nome dell'indice MongoDB.	NO
└max_search_queries	numero intero	Numero massimo di query riscritte che devono essere inviate al provider di ricerca per un singolo messaggio utente. Per impostazione predefinita, il sistema effettuerà una determinazione automatica.	NO
└* rigidità	numero intero	La rigidità configurata del filtro di pertinenza della ricerca. Una maggiore rigidità aumenterà la precisione, ma diminuirà il richiamo della risposta.	NO
└top_n_documents	numero intero	Il numero configurato di documenti da includere nella query.	NO
type	enum	L'identificatore di tipo discriminato, che è sempre "mongo_db". Valori possibili: `mongo_db`	Sì

OpenAI.Annotation

Discriminare per OpenAI.Annotation

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`file_citation`	OpenAI.AnnotationFileCitation
`url_citation`	OpenAI.AnnotationUrlCitation
`file_path`	OpenAI.AnnotationFilePath

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.AnnotationType		Sì

OpenAI.AnnotationFileCitation

Citazione in un file.

Nome	TIPO	Descrzione	Obbligatorio
ID del file	corda	ID del file.	Sì
filename	corda	Nome file del file citato.	Sì
indice	numero intero	Indice del file nell'elenco di file.	Sì
type	enum	Tipo di citazione del file. Sempre `file_citation`. Valori possibili: `file_citation`	Sì

OpenAI.AnnotationFilePath

Percorso di un file.

Nome	TIPO	Descrzione	Obbligatorio
ID del file	corda	ID del file.	Sì
indice	numero intero	Indice del file nell'elenco di file.	Sì
type	enum	Tipo del percorso del file. Sempre `file_path`. Valori possibili: `file_path`	Sì

OpenAI.AnnotationType

Proprietà	Value
Tipo	corda
Valori	`file_citation` `url_citation` `file_path` `container_file_citation`

OpenAI.AnnotationUrlCitation

Citazione per una risorsa Web usata per generare una risposta del modello.

Nome	TIPO	Descrzione	Obbligatorio
end_index	numero intero	Indice dell'ultimo carattere della citazione URL nel messaggio.	Sì
start_index	numero intero	Indice del primo carattere della citazione URL nel messaggio.	Sì
title	corda	Titolo della risorsa Web.	Sì
type	enum	Tipo di citazione URL. Sempre `url_citation`. Valori possibili: `url_citation`	Sì
URL.	corda	URL della risorsa Web.	Sì

OpenAI.PosizioneApprossimativa

Nome	TIPO	Descrzione	Obbligatorio
città	corda		NO
country	corda		NO
region	corda		NO
timezone	corda		NO
type	enum	Valori possibili: `approximate`	Sì

OpenAI.AudioResponseFormat

Formato dell'output, in una delle opzioni seguenti: json, text, srt, verbose_jsono vtt. Per gpt-4o-transcribe, gpt-4o-transcribe-diarize, gpt-4o-mini-transcribee gpt-4o-mini-transcribe-2025-12-15. L'unico formato supportato è json.

Proprietà	Value
Descrizione	Formato dell'output, in una delle opzioni seguenti: `json`, `text`, `srt`, `verbose_json`o `vtt`. Per `gpt-4o-transcribe`, `gpt-4o-transcribe-diarize`, `gpt-4o-mini-transcribe`e `gpt-4o-mini-transcribe-2025-12-15`. L'unico formato supportato è `json`.
Tipo	corda
Valori	`json` `text` `srt` `verbose_json` `vtt`

OpenAI.AutoChunkingStrategyRequestParam

Strategia predefinita. Attualmente, questa strategia usa un max_chunk_size_tokens di 800 e chunk_overlap_tokens di 400.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Sempre `auto`. Valori possibili: `auto`	Sì

OpenAI.ChatCompletionFunctionCallOption

Specificare una determinata funzione tramite {"name": "my_function"} impone al modello di chiamare tale funzione.

Nome	TIPO	Descrzione	Obbligatorio	Default
nome	corda	Nome della funzione da chiamare.	Sì

OpenAI.ChatCompletionFunctions

Nome	TIPO	Descrzione	Obbligatorio
descrizione	corda	Descrizione delle operazioni della funzione, usate dal modello per scegliere quando e come chiamare la funzione.	NO
nome	corda	Nome della funzione che deve essere chiamata. Deve essere a-z, A-Z, 0-9 o contenere caratteri di sottolineatura e trattini, con una lunghezza massima di 64 caratteri.	Sì
parameters		I parametri accettati dalle funzioni, descritti come oggetto Schema JSON. Vedere le informazioni di riferimento sullo schema JSON per la documentazione sul formato. L'omissione di `parameters` definisce una funzione con un elenco di parametri vuoto.	NO

OpenAI.ChatCompletionMessageAudioChunk

Nome	TIPO	Obbligatorio
data	corda	NO
scade_il	numero intero	NO
id	corda	NO
transcript	corda	NO

OpenAI.ChatCompletionMessageToolCall

Nome	TIPO	Descrzione	Obbligatorio
funzione	oggetto	Funzione chiamata dal modello.	Sì
└─ Argomenti	corda	Argomenti con cui chiamare la funzione, come generato dal modello in formato JSON. Il modello non genera sempre codice JSON valido e può generare allucinazioni con parametri non definiti nello schema della funzione. Convalidare gli argomenti nel codice prima di chiamare la funzione.	NO
└> nome	corda	Nome della funzione da chiamare.	NO
id	corda	ID della chiamata allo strumento.	Sì
type	enum	Tipo dello strumento. Attualmente è supportato solo `function`. Valori possibili: `function`	Sì

OpenAI.ChatCompletionMessageToolCallChunk

Nome	TIPO	Descrzione	Obbligatorio
funzione	oggetto		NO
└─ Argomenti	corda	Argomenti con cui chiamare la funzione, come generato dal modello in formato JSON. Il modello non genera sempre codice JSON valido e può generare allucinazioni con parametri non definiti nello schema della funzione. Convalidare gli argomenti nel codice prima di chiamare la funzione.	NO
└> nome	corda	Nome della funzione da chiamare.	NO
id	corda	ID della chiamata allo strumento.	NO
indice	numero intero		Sì
type	enum	Tipo dello strumento. Attualmente è supportato solo `function`. Valori possibili: `function`	NO

OpenAI.ChatCompletionNamedToolChoice

Specifica uno strumento che il modello deve usare. Usare per forzare il modello a chiamare una funzione specifica.

Nome	TIPO	Descrzione	Obbligatorio
funzione	oggetto		Sì
└> nome	corda	Nome della funzione da chiamare.	NO
type	enum	Tipo dello strumento. Attualmente è supportato solo `function`. Valori possibili: `function`	Sì

OpenAI.ChatCompletionRequestAssistantMessage

Messaggi inviati dal modello in risposta ai messaggi utente.

Nome	TIPO	Descrzione	Obbligatorio
audio	oggetto	Dati relativi a una risposta audio precedente dal modello.	NO
└* id	corda	Identificatore univoco per una risposta audio precedente dal modello.	NO
contenuto	stringa o matrice		NO
function_call	oggetto	Deprecato e sostituito da `tool_calls`. Nome e argomenti di una funzione che deve essere chiamata, come generati dal modello.	NO
└─ Argomenti	corda		NO
└> nome	corda		NO
nome	corda	Nome facoltativo per il partecipante. Fornisce le informazioni sul modello per distinguere i partecipanti con lo stesso ruolo.	NO
refusal	corda	Messaggio di rifiuto dell'assistente.	NO
ruolo	enum	Il ruolo dell'autore dei messaggi, in questo caso `assistant`. Valori possibili: `assistant`	Sì
tool_calls	ChatCompletionMessageToolCallsItem	Le chiamate degli strumenti generate dal modello, ad esempio le chiamate di funzioni.	NO

OpenAI.ChatCompletionRequestAssistantMessageContentPart

Nome	TIPO	Descrzione	Obbligatorio
refusal	corda	Messaggio di rifiuto generato dal modello.	Sì
Testo	corda	Contenuto di testo.	Sì
type	enum	Tipo della parte di contenuto. Valori possibili: `refusal`	Sì

OpenAI.ChatCompletionRequestDeveloperMessage

Istruzioni fornite dallo sviluppatore che il modello deve seguire, indipendentemente dai messaggi inviati dall'utente. Con i modelli o1 e versioni successive, i messaggi developer sostituiscono i messaggi system precedenti.

Nome	TIPO	Descrzione	Obbligatorio
contenuto	stringa o matrice		Sì
nome	corda	Nome facoltativo per il partecipante. Fornisce le informazioni sul modello per distinguere i partecipanti con lo stesso ruolo.	NO
ruolo	enum	Il ruolo dell'autore dei messaggi, in questo caso `developer`. Valori possibili: `developer`	Sì

OpenAI.ChatCompletionRequestFunctionMessage

Nome	TIPO	Descrzione	Obbligatorio
contenuto	corda	Contenuto del messaggio della funzione.	Sì
nome	corda	Nome della funzione da chiamare.	Sì
ruolo	enum	Il ruolo dell'autore dei messaggi, in questo caso `function`. Valori possibili: `function`	Sì

OpenAI.ChatCompletionRequestMessage

Discriminare per OpenAI.ChatCompletionRequestMessage

Questo componente usa la proprietà role per distinguere tra tipi diversi:

Valore tipo	Schema
`system`	OpenAI.ChatCompletionRequestSystemMessage
`developer`	OpenAI.ChatCompletionRequestDeveloperMessage
`user`	OpenAI.ChatCompletionRequestUserMessage
`assistant`	OpenAI.ChatCompletionRequestAssistantMessage
`tool`	OpenAI.ChatCompletionRequestToolMessage
`function`	OpenAI.ChatCompletionRequestFunctionMessage

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	stringa o matrice		NO
ruolo	oggetto	Ruolo dell'autore di un messaggio	Sì

OpenAI.ChatCompletionRequestMessageContentPart

Discriminatore per OpenAI.ChatCompletionRequestMessageContentPart

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`text`	OpenAI.ChatCompletionRequestMessageContentPartText
`image_url`	OpenAI.ChatCompletionRequestMessageContentPartImage
`refusal`	OpenAI.ChatCompletionRequestMessageContentPartRefusal
`file`	OpenAI.ChatCompletionRequestMessageContentPartFile
`input_audio`	OpenAI.ChatCompletionRequestMessageContentPartAudio

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.ChatCompletionRequestMessageContentPartType		Sì

OpenAI.ChatCompletionRequestMessageContentPartAudio

Nome	TIPO	Descrzione	Obbligatorio
input_audio	oggetto		Sì
└* dati	corda	Dati audio con codifica Base64.	NO
└* formato	enum	Formato dei dati audio codificati. Attualmente supporta "wav" e "mp3". Valori possibili: `wav`, `mp3`	NO
type	enum	Tipo della parte di contenuto. Sempre `input_audio`. Valori possibili: `input_audio`	Sì

OpenAI.ChatCompletionRequestMessageContentPartFile

Nome	TIPO	Descrzione	Obbligatorio
documento	oggetto		Sì
└file_data	corda	I dati del file codificati in Base64, utilizzati per trasferire il file al modello come stringa.	NO
└ file_id	corda	ID di un file caricato da usare come input.	NO
└─ nome file	corda	Nome del file, utilizzato quando si passa il file al modello come stringa.	NO
type	enum	Tipo della parte di contenuto. Sempre `file`. Valori possibili: `file`	Sì

OpenAI.ChatCompletionRequestMessageContentPartImage

Nome	TIPO	Descrzione	Obbligatorio
image_url	oggetto		Sì
└─ dettaglio	enum	Specifica il livello di dettaglio dell'immagine. Valori possibili: `auto`, `low`, `high`	NO
└─ URL	corda	URL dell'immagine o dati dell'immagine con codifica base64.	NO
type	enum	Tipo della parte di contenuto. Valori possibili: `image_url`	Sì

OpenAI.ChatCompletionRequestMessageContentPartRefusal

Nome	TIPO	Descrzione	Obbligatorio	Default
refusal	corda	Messaggio di rifiuto generato dal modello.	Sì
type	enum	Tipo della parte di contenuto. Valori possibili: `refusal`	Sì

OpenAI.ChatCompletionRequestMessageContentPartText

Nome	TIPO	Descrzione	Obbligatorio	Default
Testo	corda	Contenuto di testo.	Sì
type	enum	Tipo della parte di contenuto. Valori possibili: `text`	Sì

OpenAI.ChatCompletionRequestMessageContentPartType

Proprietà	Value
Tipo	corda
Valori	`text` `file` `input_audio` `image_url` `refusal`

OpenAI.ChatCompletionRequestSystemMessage

Istruzioni fornite dallo sviluppatore che il modello deve seguire, indipendentemente dai messaggi inviati dall'utente. Con i modelli o1 e versioni successive, usare i messaggi developer invece per questo scopo.

Nome	TIPO	Descrzione	Obbligatorio
contenuto	stringa o matrice		Sì
nome	corda	Nome facoltativo per il partecipante. Fornisce le informazioni sul modello per distinguere i partecipanti con lo stesso ruolo.	NO
ruolo	enum	Il ruolo dell'autore dei messaggi, in questo caso `system`. Valori possibili: `system`	Sì

OpenAI.ChatCompletionRequestSystemMessageContentPart

Riferimenti: OpenAI.ChatCompletionRequestMessageContentPartText

OpenAI.ChatCompletionRequestToolMessage

Nome	TIPO	Descrzione	Obbligatorio
contenuto	stringa o matrice		Sì
ruolo	enum	Il ruolo dell'autore dei messaggi, in questo caso `tool`. Valori possibili: `tool`	Sì
tool_call_id	corda	Chiamata dello strumento a cui risponde questo messaggio.	Sì

OpenAI.ChatCompletionRequestToolMessageContentPart

Riferimenti: OpenAI.ChatCompletionRequestMessageContentPartText

OpenAI.ChatCompletionRequestUserMessage

Messaggi inviati da un utente finale, contenenti richieste o informazioni di contesto aggiuntive.

Nome	TIPO	Descrzione	Obbligatorio
contenuto	stringa o matrice		Sì
nome	corda	Nome facoltativo per il partecipante. Fornisce le informazioni sul modello per distinguere i partecipanti con lo stesso ruolo.	NO
ruolo	enum	Il ruolo dell'autore dei messaggi, in questo caso `user`. Valori possibili: `user`	Sì

OpenAI.ChatCompletionRequestUserMessageContentPart

Nome	TIPO	Descrzione	Obbligatorio
documento	oggetto		Sì
└file_data	corda	I dati del file codificati in Base64, utilizzati per trasferire il file al modello come stringa.	NO
└ file_id	corda	ID di un file caricato da usare come input.	NO
└─ nome file	corda	Nome del file, utilizzato quando si passa il file al modello come stringa.	NO
image_url	oggetto		Sì
└─ dettaglio	enum	Specifica il livello di dettaglio dell'immagine. Valori possibili: `auto`, `low`, `high`	NO
└─ URL	corda	URL dell'immagine o dati dell'immagine con codifica base64.	NO
input_audio	oggetto		Sì
└* dati	corda	Dati audio con codifica Base64.	NO
└* formato	enum	Formato dei dati audio codificati. Attualmente supporta "wav" e "mp3". Valori possibili: `wav`, `mp3`	NO
Testo	corda	Contenuto di testo.	Sì
type	enum	Tipo della parte di contenuto. Sempre `file`. Valori possibili: `file`	Sì

OpenAI.ChatCompletionRole

Ruolo dell'autore di un messaggio

Proprietà	Value
Descrizione	Ruolo dell'autore di un messaggio
Tipo	corda
Valori	`system` `developer` `user` `assistant` `tool` `function`

OpenAI.ChatCompletionStreamOptions

Opzioni per la risposta in streaming. Impostare questa opzione solo quando si imposta stream: true.

Nome	TIPO	Descrzione	Obbligatorio	Default
include_usage	boolean	Se impostato, un blocco aggiuntivo verrà trasmesso prima del messaggio `data: [DONE]`. Il campo `usage` di questo blocco mostra le statistiche di utilizzo dei token per l'intera richiesta e il campo `choices` sarà sempre una matrice vuota. Tutti gli altri blocchi includeranno anche un campo `usage`, ma con un valore null. NOTA: Se il flusso viene interrotto, è possibile che non si riceva il blocco di utilizzo finale che contiene l'utilizzo totale del token per la richiesta.	NO

OpenAI.ChatCompletionStreamResponseDelta

Delta di completamento della chat generato dalle risposte del modello trasmesso.

Nome	TIPO	Descrzione	Obbligatorio
audio	oggetto		NO
└* dati	corda		NO
└─ scadenza_a	numero intero		NO
└* id	corda		NO
└─ trascrizione	corda		NO
contenuto	corda	Contenuto del messaggio del blocco.	NO
function_call	oggetto	Deprecato e sostituito da `tool_calls`. Nome e argomenti di una funzione che deve essere chiamata, come generati dal modello.	NO
└─ Argomenti	corda		NO
└> nome	corda		NO
refusal	corda	Messaggio di rifiuto generato dal modello.	NO
ruolo	oggetto	Ruolo dell'autore di un messaggio	NO
tool_calls	array		NO

OpenAI.ChatCompletionTokenLogprob

Nome	TIPO	Descrzione	Obbligatorio
bytes	array	Un elenco di numeri interi che rappresentano la rappresentazione in byte UTF-8 del token. Utile nei casi in cui i caratteri sono rappresentati da più token e le relative rappresentazioni in byte devono essere combinate per generare la rappresentazione di testo corretta. Può essere `null` se non è presente alcuna rappresentazione in byte per il token.	Sì
logprob	numero	Probabilità di log di questo token, se si trova all'interno dei primi 20 token più probabili. In caso contrario, il valore `-9999.0` viene usato per indicare che il token è molto improbabile.	Sì
token	corda	Token.	Sì
top_logprobs	array	Elenco dei token più probabili e della loro probabilità di log, in questa posizione del token. In rari casi, potrebbe venire restituito un numero di `top_logprobs` inferiore a quelli richiesti.	Sì

OpenAI.ChatCompletionTool

Nome	TIPO	Descrzione	Obbligatorio	Default
funzione	OpenAI.FunctionObject		Sì
type	enum	Tipo dello strumento. Attualmente è supportato solo `function`. Valori possibili: `function`	Sì

OpenAI.ChatCompletionToolChoiceOption

Controlla quale strumento (se presente) viene chiamato dal modello. none indica che il modello non chiamerà alcuno strumento e genera invece un messaggio. auto indica che il modello può scegliere tra la generazione di un messaggio o la chiamata di uno o più strumenti. required indica che il modello deve chiamare uno o più strumenti. Se si specifica uno strumento specifico tramite {"type": "function", "function": {"name": "my_function"}} impone al modello di chiamare tale strumento.

none è l'impostazione predefinita quando non sono presenti strumenti. auto è l'impostazione predefinita quando sono presenti strumenti.

Nome	TIPO	Descrzione	Obbligatorio
funzione	oggetto		Sì
└> nome	corda	Nome della funzione da chiamare.	NO
type	enum	Tipo dello strumento. Attualmente è supportato solo `function`. Valori possibili: `function`	Sì

OpenAI.ChatOutputPrediction

Rappresentazione di base dell'output stimato da un modello.

Discriminare per OpenAI.ChatOutputPrediction

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`content`	OpenAI.ChatOutputPredictionContent

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.ChatOutputPredictionType		Sì

OpenAI.ChatOutputPredictionContent

Contenuto di output statico stimato, ad esempio il contenuto di un file di testo che viene rigenerato.

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	stringa o matrice		Sì
type	enum	Tipo di contenuto previsto da fornire. Questo tipo attualmente è sempre `content`. Valori possibili: `content`	Sì

OpenAI.ChatOutputPredictionType

Proprietà	Value
Tipo	corda
Valori	`content`

OpenAI.ChunkingStrategyRequestParam

Strategia di suddivisione in blocchi usata per suddividere i file. Se non impostato, userà la strategia di auto.

Discriminatore per OpenAI.ChunkingStrategyRequestParam

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`static`	OpenAI.StaticChunkingStrategyRequestParam

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Tipo di strategia di suddivisione in blocchi. Valori possibili: `auto`, `static`	Sì

OpenAI.ChunkingStrategyResponseParam

Discriminatore per OpenAI.ChunkingStrategyResponseParam

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`other`	OpenAI.OtherChunkingStrategyResponseParam
`static`	OpenAI.StaticChunkingStrategyResponseParam

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `static`, `other`	Sì

OpenAI.CodeInterpreterOutput

Discriminatore per OpenAI.CodeInterpreterOutput

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`image`	OpenAI.CodeInterpreterOutputImage
`logs`	OpenAI.CodeInterpreterOutputLogs

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.CodeInterpreterOutputType		Sì

OpenAI.CodeInterpreterOutputImage

Output dell'immagine dall'interprete di codice.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Tipo dell'output. Sempre 'image'. Valori possibili: `image`	Sì
URL.	corda	URL dell'output dell'immagine dall'interprete di codice.	Sì

OpenAI.CodeInterpreterOutputLogs

Output dei log dall'interprete del codice.

Nome	TIPO	Descrzione	Obbligatorio	Default
logs	corda	Output dei log dall'interprete del codice.	Sì
type	enum	Tipo dell'output. Sempre 'logs'. Valori possibili: `logs`	Sì

OpenAI.CodeInterpreterOutputType

Proprietà	Value
Tipo	corda
Valori	`logs` `image`

OpenAI.CodeInterpreterTool

Strumento che esegue codice Python per generare una risposta a un prompt.

Nome	TIPO	Descrzione	Obbligatorio
container	oggetto	Configurazione per un contenitore dell'interprete di codice. Facoltativamente, specificare gli ID dei file in cui eseguire il codice.	Sì
└file_ids	array	Elenco facoltativo di file caricati da rendere disponibili al tuo codice.	NO
└─ Tipo	enum	Sempre `auto`. Valori possibili: `auto`	NO
type	enum	Tipo dello strumento dell'interprete di codice. Sempre `code_interpreter`. Valori possibili: `code_interpreter`	Sì

OpenAI.CodeInterpreterToolAuto

Configurazione per un contenitore dell'interprete di codice. Facoltativamente, specificare gli ID dei file in cui eseguire il codice.

Nome	TIPO	Descrzione	Obbligatorio	Default
identificatori_di_file	array	Elenco facoltativo di file caricati da rendere disponibili al tuo codice.	NO
type	enum	Sempre `auto`. Valori possibili: `auto`	Sì

OpenAI.CodeInterpreterToolCallItemParam

Chiamata dello strumento per eseguire il codice.

Nome	TIPO	Descrzione	Obbligatorio
codice	corda	Codice da eseguire o Null se non disponibile.	Sì
container_id	corda	ID del contenitore usato per eseguire il codice.	Sì
Risultati	array	Output generati dall'interprete del codice, ad esempio log o immagini. Può essere Null se non sono disponibili output.	Sì
type	enum	Valori possibili: `code_interpreter_call`	Sì

OpenAI.CodeInterpreterToolCallItemResource

Chiamata dello strumento per eseguire il codice.

Nome	TIPO	Descrzione	Obbligatorio
codice	corda	Codice da eseguire o Null se non disponibile.	Sì
container_id	corda	ID del contenitore usato per eseguire il codice.	Sì
Risultati	array	Output generati dall'interprete del codice, ad esempio log o immagini. Può essere Null se non sono disponibili output.	Sì
stato	enum	Valori possibili: `in_progress`, `completedincomplete`, , `interpreting`,`failed`	Sì
type	enum	Valori possibili: `code_interpreter_call`	Sì

OpenAI.ComparisonFilter

Filtro utilizzato per confrontare una chiave di attributo specificata con un determinato valore usando un'operazione di confronto definita.

Nome	TIPO	Descrzione	Obbligatorio
chiave	corda	La chiave da confrontare rispetto al valore.	Sì
type	enum	Specifica l'operatore di confronto: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`. - `eq`: uguale - `ne`: non uguale - `gt`:maggiore - `gte`: maggiore o uguale a - `lt`:meno di - `lte`: minore o uguale. Valori possibili: `eq`, `negt`, `gte`, , `ltlte`	Sì
valore	stringa o numero o valore booleano		Sì

OpenAI.CompletionUsage

Statistiche di utilizzo per la richiesta di completamento.

Nome	TIPO	Descrzione	Obbligatorio	Default
completion_tokens	numero intero	Numero di token nel completamento generato.	Sì	0
completion_tokens_details	oggetto	Scomposizione dei token usati in un completamento.	NO
└─ token_di_predizione_accettati	numero intero	Quando si usano output stimati, il numero di token della previsione che compaiono nel completamento.	NO	0
└audio_tokens	numero intero	Token dell'input audio generati dal modello.	NO	0
└─ token_di_ragionamento	numero intero	Token generati dal modello per il ragionamento.	NO	0
└rejected_prediction_tokens	numero intero	Quando si usano output stimati, il numero di token della previsione che non compaiono nel completamento. Tuttavia, come i token di ragionamento, questi token vengono ancora conteggiati nel totale dei token di completamento ai fini della fatturazione, dell'output e dei limiti della finestra di contesto.	NO	0
prompt_tokens	numero intero	Numero di token nel prompt.	Sì	0
prompt_tokens_details	oggetto	Suddivisione dei token usati nel prompt.	NO
└audio_tokens	numero intero	Token di input audio presenti nel prompt.	NO	0
└cached_tokens	numero intero	Token memorizzati nella cache presenti nel prompt.	NO	0
total_tokens	numero intero	Numero totale di token usati nella richiesta (prompt + completamento).	Sì	0

OpenAI.CompoundFilter

Combinare più filtri usando and o or.

Nome	TIPO	Descrzione	Obbligatorio	Default
filters	array	Matrice di filtri da combinare. Gli elementi possono essere `ComparisonFilter` o `CompoundFilter`.	Sì
type	enum	Tipo di operazione: `and` o `or`. Valori possibili: `and`, `or`	Sì

OpenAI.ComputerAction

Discriminare per OpenAI.ComputerAction

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`click`	OpenAI.ComputerActionClick
`double_click`	OpenAI.ComputerActionDoubleClick
`drag`	OpenAI.ComputerActionDrag
`move`	OpenAI.ComputerActionMove
`screenshot`	OpenAI.ComputerActionScreenshot
`scroll`	OpenAI.ComputerActionScroll
`type`	OpenAI.ComputerActionTypeKeys
`wait`	OpenAI.ComputerActionWait
`keypress`	OpenAI.ComputerActionKeyPress

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.ComputerActionType		Sì

OpenAI.ComputerActionClick

Azione di fare clic.

Nome	TIPO	Descrzione	Obbligatorio
pulsante	enum	Indica il pulsante del mouse premuto durante il clic. Uno di `left`, `rightwheel`, `back`, o `forward`. Valori possibili: `left`, `rightwheel`, , `back`,`forward`	Sì
type	enum	Specifica il tipo di evento. Per un'azione di clic, questa proprietà è sempre impostata su `click`. Valori possibili: `click`	Sì
x	numero intero	Coordinata x in cui si è verificato il clic.	Sì
y	numero intero	Coordinata y in cui si è verificato il clic.	Sì

OpenAI.ComputerActionDoubleClick

Azione con doppio clic.

Nome	TIPO	Descrzione	Obbligatorio
type	enum	Specifica il tipo di evento. Per un'azione di doppio clic, questa proprietà è sempre impostata su `double_click`. Valori possibili: `double_click`	Sì
x	numero intero	Coordinata x in cui si è verificato il doppio clic.	Sì
y	numero intero	Coordinata y in cui si è verificato il doppio clic.	Sì

OpenAI.ComputerActionDrag

Azione di trascinamento.

Nome	TIPO	Descrzione	Obbligatorio	Default
path	array	Matrice di coordinate che rappresentano il percorso dell'azione di trascinamento. Le coordinate verranno visualizzate come matrice di oggetti, ad esempio`{ x: 100, y: 200 }, { x: 200, y: 300 }`	Sì
type	enum	Specifica il tipo di evento. Per un'azione di trascinamento, questa proprietà è sempre impostata su `drag`. Valori possibili: `drag`	Sì

OpenAI.ComputerActionKeyPress

Una raccolta di pressioni di tasti che il modello desidera eseguire.

Nome	TIPO	Descrzione	Obbligatorio	Default
Chiavi	array	La combinazione di tasti che il modello richiede di premere. Si tratta di una matrice di stringhe, ognuna che rappresenta una chiave.	Sì
type	enum	Specifica il tipo di evento. Per un'azione keypress, questa proprietà è sempre impostata su `keypress`. Valori possibili: `keypress`	Sì

OpenAI.ComputerActionMove

Azione di spostamento del mouse.

Nome	TIPO	Descrzione	Obbligatorio
type	enum	Specifica il tipo di evento. Per un'azione di spostamento, questa proprietà è sempre impostata su `move`. Valori possibili: `move`	Sì
x	numero intero	Coordinata x in cui spostarsi.	Sì
y	numero intero	Coordinata y su cui spostarsi.	Sì

OpenAI.ComputerActionScreenshot

Azione screenshot.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Specifica il tipo di evento. Per un'azione screenshot, questa proprietà è sempre impostata su `screenshot`. Valori possibili: `screenshot`	Sì

OpenAI.ComputerActionScroll

Azione di scorrimento.

Nome	TIPO	Descrzione	Obbligatorio
scroll_x	numero intero	Distanza di scorrimento orizzontale.	Sì
scroll_y	numero intero	Distanza di scorrimento verticale.	Sì
type	enum	Specifica il tipo di evento. Per un'azione di scorrimento, questa proprietà è sempre impostata su `scroll`. Valori possibili: `scroll`	Sì
x	numero intero	Coordinata x in cui si è verificato lo scorrimento.	Sì
y	numero intero	Coordinata y in cui si è verificato lo scorrimento.	Sì

OpenAI.ComputerActionType

Proprietà	Value
Tipo	corda
Valori	`screenshot` `click` `double_click` `scroll` `type` `wait` `keypress` `drag` `move`

OpenAI.ComputerActionTypeKeys

Azione per digitare del testo.

Nome	TIPO	Descrzione	Obbligatorio	Default
Testo	corda	Testo da digitare.	Sì
type	enum	Specifica il tipo di evento. Per un'azione di tipo, questa proprietà è sempre impostata su `type`. Valori possibili: `type`	Sì

OpenAI.ComputerActionWait

Azione di attesa.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Specifica il tipo di evento. Per un'azione di attesa, questa proprietà è sempre impostata su `wait`. Valori possibili: `wait`	Sì

OpenAI.ComputerToolCallItemParam

Chiamata di uno strumento a uno strumento per l'uso del computer.

Nome	TIPO	Descrzione	Obbligatorio
azione	OpenAI.ComputerAction		Sì
call_id	corda	Identificatore usato per rispondere alla chiamata dello strumento con output.	Sì
pending_safety_checks	array	Controlli di sicurezza in sospeso per la chiamata computer.	Sì
type	enum	Valori possibili: `computer_call`	Sì

OpenAI.ComputerToolCallItemResource

Chiamata di uno strumento a uno strumento per l'uso del computer.

Nome	TIPO	Descrzione	Obbligatorio
azione	OpenAI.ComputerAction		Sì
call_id	corda	Identificatore usato per rispondere alla chiamata dello strumento con output.	Sì
pending_safety_checks	array	Controlli di sicurezza in sospeso per la chiamata computer.	Sì
stato	enum	Stato dell'elemento. Uno tra `in_progress`, `completed` e `incomplete`. Popolato quando gli elementi vengono restituiti tramite l'API. Valori possibili: `in_progress`, `completed`, `incomplete`	Sì
type	enum	Valori possibili: `computer_call`	Sì

OpenAI.ComputerToolCallOutputItemOutput

Discriminare per OpenAI.ComputerToolCallOutputItemOutput

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`computer_screenshot`	OpenAI.ComputerToolCallOutputItemOutputComputerScreenshot

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.ComputerToolCallOutputItemOutputType	Immagine di uno screenshot del computer usata con lo strumento per l'uso del computer.	Sì

OpenAI.ComputerToolCallOutputItemOutputComputerScreenshot

Nome	TIPO	Descrzione	Obbligatorio
ID del file	corda		NO
image_url	corda		NO
type	enum	Valori possibili: `computer_screenshot`	Sì

OpenAI.ComputerToolCallOutputItemOutputType

Immagine di uno screenshot del computer usata con lo strumento per l'uso del computer.

Proprietà	Value
Descrizione	Immagine di uno screenshot del computer usata con lo strumento per l'uso del computer.
Tipo	corda
Valori	`computer_screenshot`

OpenAI.ComputerToolCallOutputItemParam

Output di una chiamata allo strumento del computer.

Nome	TIPO	Descrzione	Obbligatorio
acknowledged_safety_checks	array	I controlli di sicurezza segnalati dall'API che sono stati riconosciuti dallo sviluppatore.	NO
call_id	corda	ID della chiamata dello strumento del computer che ha prodotto l'output.	Sì
output	OpenAI.ComputerToolCallOutputItemOutput		Sì
type	enum	Valori possibili: `computer_call_output`	Sì

OpenAI.ComputerToolCallOutputItemResource

Output di una chiamata allo strumento del computer.

Nome	TIPO	Descrzione	Obbligatorio
acknowledged_safety_checks	array	I controlli di sicurezza segnalati dall'API che sono stati riconosciuti dallo sviluppatore.	NO
call_id	corda	ID della chiamata dello strumento del computer che ha prodotto l'output.	Sì
output	OpenAI.ComputerToolCallOutputItemOutput		Sì
stato	enum	Stato dell'elemento. Uno tra `in_progress`, `completed` e `incomplete`. Popolato quando gli elementi vengono restituiti tramite l'API. Valori possibili: `in_progress`, `completed`, `incomplete`	Sì
type	enum	Valori possibili: `computer_call_output`	Sì

OpenAI.ComputerToolCallSafetyCheck

Controllo di sicurezza in sospeso per la chiamata computer.

Nome	TIPO	Descrzione	Obbligatorio
codice	corda	Tipo del controllo di sicurezza in sospeso.	Sì
id	corda	ID del controllo di sicurezza in sospeso.	Sì
message	corda	Dettagli sul controllo di sicurezza in sospeso.	Sì

OpenAI.ComputerUsePreviewTool

Strumento che controlla un computer virtuale.

Nome	TIPO	Descrzione	Obbligatorio
altezza_schermo	numero intero	Altezza dello schermo del computer.	Sì
larghezza_display	numero intero	Larghezza della visualizzazione del computer.	Sì
environment	enum	Tipo di ambiente del computer da controllare. Valori possibili: `windows`, `maclinux`, , `ubuntu`,`browser`	Sì
type	enum	Tipo dello strumento di utilizzo del computer. Sempre `computer_use_preview`. Valori possibili: `computer_use_preview`	Sì

OpenAI.Coordinate

Coppia di coordinate x/y, ad esempio { x: 100, y: 200 }.

Nome	TIPO	Descrzione	Obbligatorio	Default
x	numero intero	Coordinata x.	Sì
y	numero intero	Coordinata y.	Sì

OpenAI.CreateEmbeddingResponse

Nome	TIPO	Descrzione	Obbligatorio
data	array	Elenco degli incorporamenti generati dal modello.	Sì
model	corda	Nome del modello usato per generare l'incorporamento.	Sì
oggetto	enum	Il tipo di oggetto, che è sempre "elenco". Valori possibili: `list`	Sì
usage	oggetto	Informazioni sull'utilizzo relative alla richiesta.	Sì
└prompt_tokens	numero intero	Numero di token usati dal prompt.	NO
└total_tokens	numero intero	Numero totale di token usati dalla richiesta.	NO

OpenAI.CreateEvalItem

Messaggio di chat che costituisce il prompt o il contesto. Può includere riferimenti a variabili allo spazio dei nomi item, ad esempio {{item.name}}.

Nome	TIPO	Descrzione	Obbligatorio
contenuto	stringa o OpenAI.EvalItemContent	Input di testo per il modello: può contenere stringhe di modello.	Sì
ruolo	enum	Ruolo dell'inserimento del messaggio. Uno tra `user`, `assistant`, `system` o `developer`. Valori possibili: `user`, `assistant`, `system`, `developer`	Sì
type	enum	Tipo di input del messaggio. Sempre `message`. Valori possibili: `message`	NO

OpenAI.CreateEvalRunRequest

Nome	TIPO	Descrzione	Obbligatorio
fonte_dati	oggetto		Sì
└─ Tipo	OpenAI.EvalRunDataSourceType		NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
nome	corda	Nome della corsa.	NO

OpenAI.CreateFineTuningJobRequest

Modelli validi:

babbage-002
davinci-002
gpt-3.5-turbo
gpt-4o-mini

Nome	TIPO	Descrzione	Obbligatorio	Default
iperparametri	oggetto	Iperparametri usati per il processo di ottimizzazione. Questo valore è ora deprecato a favore di `method`e deve essere passato sotto il parametro `method`.	NO
└' batch_size	enum	Valori possibili: `auto`	NO
└' learning_rate_multiplier	enum	Valori possibili: `auto`	NO
└' n_epochs	enum	Valori possibili: `auto`	NO
integrazioni	array	Elenco di integrazioni da abilitare per il processo di ottimizzazione.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
method	OpenAI.FineTuneMethod	Metodo utilizzato per l'ottimizzazione.	NO
model	string (vedere modelli validi di seguito)	Nome del modello da ottimizzare.	Sì
seed	numero intero	Il seme controlla la riproducibilità del lavoro. Il passaggio degli stessi parametri di inizializzazione e processo dovrebbe produrre gli stessi risultati, ma in rari casi può differire. Se non viene specificato un valore di inizializzazione, ne verrà generato uno automaticamente.	NO
suffix	corda	Stringa di un massimo di 64 caratteri che verrà aggiunta al nome del modello ottimizzato. Ad esempio, un `suffix` oggetto "custom-model-name" produrrebbe un nome di modello come `ft:gpt-4o-mini:openai:custom-model-name:7p4lURel`.	NO	None
file di allenamento	corda	ID di un file caricato contenente i dati di training. Il set di dati deve essere formattato come file JSONL. Inoltre, è necessario caricare il file con lo scopo `fine-tune`. Il contenuto del file deve variare a seconda che il modello usi la chat, il formato dei completamenti o se il metodo di ottimizzazione usa il formato delle preferenze.	Sì
file_di_validazione	corda	ID di un file caricato contenente i dati di convalida. Se si fornisce questo file, i dati vengono usati per generare periodicamente metriche di convalida durante l’ottimizzazione. Queste metriche possono essere visualizzate nel file dei risultati di ottimizzazione. Gli stessi dati non devono essere presenti sia nei file di training sia nei file di convalida. Il set di dati deve essere formattato come file JSONL. È necessario caricare il file con lo scopo `fine-tune`.	NO

OpenAI.CreateFineTuningJobRequestIntegration

Discriminatore per OpenAI.CreateFineTuningJobRequestIntegration

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`wandb`	OpenAI.CreateFineTuningJobRequestWandbIntegration

Nome	TIPO	Descrzione	Obbligatorio	Default
type	string (vedere modelli validi di seguito)		Sì

OpenAI.CreateFineTuningJobRequestWandbIntegration

Nome	TIPO	Descrzione	Obbligatorio
type	enum	Valori possibili: `wandb`	Sì
wandb	oggetto		Sì
└─ Entità	corda		NO
└> nome	corda		NO
└project	corda		NO
└* tag	array		NO

OpenAI.CreateVectorStoreFileBatchRequest

Nome	TIPO	Descrzione	Obbligatorio
attributes	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri, valori booleani o numeri.	NO
chunking_strategy	OpenAI.ChunkingStrategyRequestParam	Strategia di suddivisione in blocchi usata per suddividere i file. Se non impostato, userà la strategia di `auto`.	NO
identificatori_di_file	array	Elenco di ID file che devono essere usati dall'archivio vettoriale. Utile per strumenti come `file_search` in grado di access file.	Sì

OpenAI.CreateVectorStoreFileRequest

Nome	TIPO	Descrzione	Obbligatorio
attributes	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri, valori booleani o numeri.	NO
chunking_strategy	OpenAI.ChunkingStrategyRequestParam	Strategia di suddivisione in blocchi usata per suddividere i file. Se non impostato, userà la strategia di `auto`.	NO
ID del file	corda	Un ID file che deve essere usato dall'archivio vettoriale. Utile per strumenti come `file_search` in grado di access file.	Sì

OpenAI.CreateVectorStoreRequest

Nome	TIPO	Descrzione	Obbligatorio
chunking_strategy	oggetto	Strategia predefinita. Attualmente, questa strategia usa un `max_chunk_size_tokens` di `800` e `chunk_overlap_tokens` di `400`.	NO
└─ statico	OpenAI.StaticChunkingStrategy		NO
└─ Tipo	enum	Sempre `static`. Valori possibili: `static`	NO
scade dopo	OpenAI.VectorStoreExpirationAfter	I criteri di scadenza per un archivio vettoriale.	NO
identificatori_di_file	array	Elenco di ID file che devono essere usati dall'archivio vettoriale. Utile per strumenti come `file_search` in grado di access file.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
nome	corda	Il nome dell’archivio vettoriale.	NO

OpenAI.DeleteFileResponse

Nome	TIPO	Descrzione	Obbligatorio
cancellato	boolean		Sì
id	corda		Sì
oggetto	enum	Valori possibili: `file`	Sì

OpenAI.DeleteVectorStoreFileResponse

Nome	TIPO	Descrzione	Obbligatorio
cancellato	boolean		Sì
id	corda		Sì
oggetto	enum	Valori possibili: `vector_store.file.deleted`	Sì

OpenAI.DeleteVectorStoreResponse

Nome	TIPO	Descrzione	Obbligatorio
cancellato	boolean		Sì
id	corda		Sì
oggetto	enum	Valori possibili: `vector_store.deleted`	Sì

OpenAI.Embedding

Rappresenta un vettore di incorporamento restituito dall'endpoint di incorporamento.

Nome	TIPO	Descrzione	Obbligatorio
embedding	stringa o matrice		Sì
indice	numero intero	Indice dell'incorporamento nell'elenco di incorporamenti.	Sì
oggetto	enum	Tipo di oggetto, che è sempre "embedding". Valori possibili: `embedding`	Sì

OpenAI.Eval

Un oggetto Eval con una configurazione dell'origine dati e criteri di test. Un Eval rappresenta un'attività da eseguire per l'integrazione LLM. Ad esempio:

Migliorare la qualità del chatbot
Scopri in che modo il mio chatbot gestisce il supporto clienti
Controlla se o4-mini è migliore nel mio caso d'uso rispetto a gpt-4o

Nome	TIPO	Descrzione	Obbligatorio	Default
creato_il	numero intero	Il timestamp Unix (in secondi) relativo alla creazione dell'eval.	Sì
configurazione_sorgente_dati	oggetto		Sì
└─ Tipo	OpenAI.EvalDataSourceConfigType		NO
id	corda	Identificatore univoco per la valutazione.	Sì
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	Sì
nome	corda	Nome della valutazione.	Sì
oggetto	enum	Tipo dell'oggetto. Valori possibili: `eval`	Sì
criteri_di_test	array	Elenco dei criteri di test.	Sì	None

Errore OpenAI.EvalApiError

Oggetto che rappresenta una risposta di errore dall'API Eval.

Nome	TIPO	Descrzione	Obbligatorio	Default
codice	corda	Codice di errore.	Sì
message	corda	Messaggio di errore.	Sì

OpenAI.EvalCompletionsRunDataSourceParams

Oggetto CompletionsRunDataSource che descrive una configurazione di campionamento del modello.

Nome	TIPO	Descrzione	Obbligatorio
messaggi di input	oggetto		NO
└item_reference	corda	Riferimento a una variabile nello spazio dei nomi `item`. Ad esempio, "item.input_trajectory"	NO
Modello └─	array	Elenco di messaggi di chat che formano il prompt o il contesto. Può includere riferimenti a variabili allo spazio dei nomi `item`, ad esempio {{item.name}}.	NO
└─ Tipo	enum	Tipo di messaggi di input. Sempre `item_reference`. Valori possibili: `item_reference`	NO
model	corda	Nome del modello da utilizzare per la generazione di completamenti, ad esempio "o3-mini".	NO
sampling_params	AzureEvalAPICompletionsSamplingParams		NO
source	oggetto		Sì
└> contenuto	array	Contenuto del file jsonl.	NO
└─created_after	numero intero	Timestamp Unix facoltativo per filtrare gli elementi creati dopo questo momento.	NO
└─ creato_prima	numero intero	Timestamp Unix facoltativo per filtrare gli elementi creati prima di questa volta.	NO
└* id	corda	Identificatore del file.	NO
└* limite	numero intero	Numero massimo facoltativo di elementi da restituire.	NO
└─ metadati	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
└─ Modello	corda	Modello facoltativo da filtrare in base a (ad esempio, 'gpt-4o').	NO
└─ Tipo	enum	Tipo di origine. Sempre `stored_completions`. Valori possibili: `stored_completions`	NO
type	enum	Tipo di origine dati di esecuzione. Sempre `completions`. Valori possibili: `completions`	Sì

OpenAI.EvalCustomDataSourceConfigParams

Oggetto CustomDataSourceConfig che definisce lo schema per l'origine dati utilizzata per le esecuzioni di valutazione. Questo schema viene usato per definire la forma dei dati che saranno:

Usati per definire i criteri di test e
Dati necessari per la creazione di un'esecuzione

Nome	TIPO	Descrzione	Obbligatorio	Default
includi_schema_esempio	boolean	Indica se l'eval dovrebbe attendersi che tu popoli lo spazio dei nomi di esempio (cioè, generando risposte dalla tua fonte di dati).	NO	Falso
schema_elemento	oggetto	Schema JSON per ogni riga nell'origine dati.	Sì
type	enum	Tipo di origine dati. Sempre `custom`. Valori possibili: `custom`	Sì

OpenAI.EvalCustomDataSourceConfigResource

Un CustomDataSourceConfig che specifica lo schema del tuo item e, facoltativamente, degli spazi dei nomi sample. Lo schema di risposta definisce la forma dei dati che saranno:

Usati per definire i criteri di test e
Dati necessari per la creazione di un'esecuzione

Nome	TIPO	Descrzione	Obbligatorio	Default
schema	oggetto	Schema Json per gli elementi della fonte dati di esecuzione. Informazioni su come creare schemi JSON qui.	Sì
type	enum	Tipo di origine dati. Sempre `custom`. Valori possibili: `custom`	Sì

OpenAI.EvalDataSourceConfigParams

Discriminatore per OpenAI.EvalDataSourceConfigParams

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`custom`	OpenAI.EvalCustomDataSourceConfigParams
`logs`	OpenAI.EvalLogsDataSourceConfigParams
`stored_completions`	OpenAI.EvalStoredCompletionsDataSourceConfigParams

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.EvalDataSourceConfigType		Sì

OpenAI.EvalDataSourceConfigResource

Discriminatore per OpenAI.EvalDataSourceConfigResource

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`custom`	OpenAI.EvalCustomDataSourceConfigResource
`stored_completions`	OpenAI.EvalStoredCompletionsDataSourceConfigResource
`logs`	OpenAI.EvalLogsDataSourceConfigResource

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.EvalDataSourceConfigType		Sì

OpenAI.EvalDataSourceConfigType

Proprietà	Value
Tipo	corda
Valori	`custom` `logs` `stored_completions`

OpenAI.EvalGraderLabelModelParams

Oggetto LabelModelGrader che usa un modello per assegnare etichette a ogni elemento della valutazione.

Nome	TIPO	Descrzione	Obbligatorio
ingresso	array	Elenco di messaggi di chat che formano il prompt o il contesto. Può includere riferimenti a variabili allo spazio dei nomi `item`, ad esempio {{item.name}}.	Sì
labels	array	Le etichette per classificare ogni elemento della valutazione.	Sì
model	corda	Modello da utilizzare per la valutazione. Deve supportare output strutturati.	Sì
nome	corda	Nome del grader.	Sì
etichette_di_passaggio	array	Le etichette che indicano un risultato positivo. Deve essere un sottoinsieme di etichette.	Sì
type	enum	Il tipo di oggetto, che è sempre `label_model`. Valori possibili: `label_model`	Sì

OpenAI.EvalGraderLabelModelResource

Nome	TIPO	Descrzione	Obbligatorio
ingresso	array		Sì
labels	array	Etichette da assegnare a ogni elemento della valutazione.	Sì
model	corda	Modello da utilizzare per la valutazione. Deve supportare output strutturati.	Sì
nome	corda	Nome del grader.	Sì
etichette_di_passaggio	array	Le etichette che indicano un risultato positivo. Deve essere un sottoinsieme di etichette.	Sì
type	enum	Il tipo di oggetto, che è sempre `label_model`. Valori possibili: `label_model`	Sì

OpenAI.EvalGraderParams

Discriminatore per OpenAI.EvalGraderParams

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`label_model`	OpenAI.EvalGraderLabelModelParams
`string_check`	OpenAI.EvalGraderStringCheckParams
`text_similarity`	OpenAI.EvalGraderTextSimilarityParams
`python`	OpenAI.EvalGraderPythonParams
`score_model`	OpenAI.EvalGraderScoreModelParams

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.GraderType		Sì

OpenAI.EvalGraderPythonParams

Nome	TIPO	Descrzione	Obbligatorio
image_tag	corda	Tag immagine da usare per lo script Python.	NO
nome	corda	Nome del grader.	Sì
soglia di superamento	numero	Soglia per il punteggio.	NO
source	corda	Codice sorgente dello script Python.	Sì
type	enum	Il tipo di oggetto, che è sempre `python`. Valori possibili: `python`	Sì

OpenAI.EvalGraderPythonResource

Nome	TIPO	Descrzione	Obbligatorio
image_tag	corda	Tag immagine da usare per lo script Python.	NO
nome	corda	Nome del grader.	Sì
soglia di superamento	numero	Soglia per il punteggio.	NO
source	corda	Codice sorgente dello script Python.	Sì
type	enum	Il tipo di oggetto, che è sempre `python`. Valori possibili: `python`	Sì

OpenAI.EvalGraderResource

Discriminatore per OpenAI.EvalGraderResource

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`label_model`	OpenAI.EvalGraderLabelModelResource
`text_similarity`	OpenAI.EvalGraderTextSimilarityResource
`python`	OpenAI.EvalGraderPythonResource
`score_model`	OpenAI.EvalGraderScoreModelResource

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.GraderType		Sì

OpenAI.EvalGraderScoreModelParams

Nome	TIPO	Descrzione	Obbligatorio
ingresso	array	Testo di input. Ciò può includere stringhe di modello.	Sì
model	corda	Modello da utilizzare per la valutazione.	Sì
nome	corda	Nome del grader.	Sì
soglia di superamento	numero	Soglia per il punteggio.	NO
intervallo	array	La gamma del punteggio. Il valore predefinito è `[0, 1]`.	NO
sampling_params		Parametri di campionamento per il modello.	NO
type	enum	Il tipo di oggetto, che è sempre `score_model`. Valori possibili: `score_model`	Sì

OpenAI.EvalGraderScoreModelResource

Nome	TIPO	Descrzione	Obbligatorio
ingresso	array	Testo di input. Ciò può includere stringhe di modello.	Sì
model	corda	Modello da utilizzare per la valutazione.	Sì
nome	corda	Nome del grader.	Sì
soglia di superamento	numero	Soglia per il punteggio.	NO
intervallo	array	La gamma del punteggio. Il valore predefinito è `[0, 1]`.	NO
sampling_params		Parametri di campionamento per il modello.	NO
type	enum	Il tipo di oggetto, che è sempre `score_model`. Valori possibili: `score_model`	Sì

OpenAI.EvalGraderStringCheckParams

Nome	TIPO	Descrzione	Obbligatorio
ingresso	corda	Testo di input. Ciò può includere stringhe di modello.	Sì
nome	corda	Nome del grader.	Sì
operazione	enum	Operazione di controllo della stringa da eseguire. Uno tra `eq`, `ne`, `like` o `ilike`. Valori possibili: `eq`, `ne`, `like`, `ilike`	Sì
riferimento	corda	Testo di riferimento. Ciò può includere stringhe di modello.	Sì
type	enum	Il tipo di oggetto, che è sempre `string_check`. Valori possibili: `string_check`	Sì

OpenAI.EvalGraderTextSimilarityParams

Nome	TIPO	Descrzione	Obbligatorio
metrica di valutazione	enum	Metrica di valutazione da usare. Uno di `fuzzy_match`, `bleu`, `gleu`, `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5` o `rouge_l`. Valori possibili: `fuzzy_match`, `bleu`, `gleumeteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5rouge_l`	Sì
ingresso	corda	Il testo in valutazione.	Sì
nome	corda	Nome del grader.	Sì
soglia di superamento	numero	Soglia per il punteggio.	Sì
riferimento	corda	Testo che viene valutato.	Sì
type	enum	Tipo di grader. Valori possibili: `text_similarity`	Sì

OpenAI.EvalGraderTextSimilarityResource

Nome	TIPO	Descrzione	Obbligatorio
metrica di valutazione	enum	Metrica di valutazione da usare. Uno di `fuzzy_match`, `bleu`, `gleu`, `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5` o `rouge_l`. Valori possibili: `fuzzy_match`, `bleu`, `gleumeteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5rouge_l`	Sì
ingresso	corda	Il testo in valutazione.	Sì
nome	corda	Nome del grader.	Sì
soglia di superamento	numero	Soglia per il punteggio.	Sì
riferimento	corda	Testo che viene valutato.	Sì
type	enum	Tipo di grader. Valori possibili: `text_similarity`	Sì

OpenAI.EvalItem

Messaggio di input al modello con un ruolo che indica la gerarchia di esecuzione delle istruzioni. Le istruzioni fornite con il ruolo developer o system hanno la precedenza sulle istruzioni fornite con il ruolo user. Si presuppone che i messaggi con il assistant ruolo siano stati generati dal modello nelle interazioni precedenti.

Nome	TIPO	Descrzione	Obbligatorio
contenuto	oggetto		Sì
└─ Tipo	OpenAI.EvalItemContentType		NO
ruolo	enum	Ruolo dell'inserimento del messaggio. Uno tra `user`, `assistant`, `system` o `developer`. Valori possibili: `user`, `assistant`, `system`, `developer`	Sì
type	enum	Tipo di input del messaggio. Sempre `message`. Valori possibili: `message`	NO

OpenAI.EvalItemContent

Discriminatore per OpenAI.EvalItemContent

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`input_text`	OpenAI.EvalItemContentInputText
`output_text`	OpenAI.EvalItemContentOutputText

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.EvalItemContentType		Sì

OpenAI.EvalItemContentInputText

Nome	TIPO	Descrzione	Obbligatorio	Default
Testo	corda		Sì
type	enum	Valori possibili: `input_text`	Sì

OpenAI.EvalItemContentOutputText

Nome	TIPO	Descrzione	Obbligatorio	Default
Testo	corda		Sì
type	enum	Valori possibili: `output_text`	Sì

OpenAI.EvalItemContentType

Proprietà	Value
Tipo	corda
Valori	`input_text` `output_text`

OpenAI.EvalJsonlRunDataSourceParams

Oggetto JsonlRunDataSource con che specifica un file JSONL che corrisponde all'eval

Nome	TIPO	Descrzione	Obbligatorio
source	oggetto		Sì
└> contenuto	array	Contenuto del file jsonl.	NO
└* id	corda	Identificatore del file.	NO
└─ Tipo	enum	Tipo di origine JSONL. Sempre `file_id`. Valori possibili: `file_id`	NO
type	enum	Tipo di origine dati. Sempre `jsonl`. Valori possibili: `jsonl`	Sì

OpenAI.EvalList

Oggetto che rappresenta un elenco di valori.

Nome	TIPO	Descrzione	Obbligatorio
data	array	Matrice di oggetti eval.	Sì
first_id	corda	Identificatore della prima valutazione nell'array di dati.	Sì
ha_di_piu	boolean	Indica se sono disponibili più valutazioni.	Sì
last_id	corda	Identificatore dell'ultima eval nella matrice di dati.	Sì
oggetto	enum	Il tipo di quest'oggetto. È sempre impostato su "list". Valori possibili: `list`	Sì

OpenAI.EvalLogsDataSourceConfigParams

Configurazione dell'origine dati che specifica la proprietà dei metadati della query dei log. Si tratta in genere di metadati come usecase=chatbot o prompt-version=v2e così via.

Nome	TIPO	Descrzione	Obbligatorio	Default
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
type	enum	Tipo di origine dati. Sempre `logs`. Valori possibili: `logs`	Sì

OpenAI.EvalLogsDataSourceConfigResource

LogsDataSourceConfig che specifica la proprietà dei metadati della query dei log. Si tratta in genere di metadati come usecase=chatbot o prompt-version=v2e così via. Lo schema restituito da questa configurazione dell'origine dati viene usato per definire quali variabili sono disponibili nelle valutazioni. item e sample sono entrambi definiti quando si usa questa configurazione dell'origine dati.

Nome	TIPO	Descrzione	Obbligatorio
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	Sì
schema	oggetto	Schema Json per gli elementi della fonte dati di esecuzione. Informazioni su come creare schemi JSON qui.	Sì
type	enum	Tipo di origine dati. Sempre `logs`. Valori possibili: `logs`	Sì

OpenAI.EvalResponsesRunDataSourceParams

Oggetto ResponsesRunDataSource che descrive una configurazione di campionamento del modello.

Nome	TIPO	Descrzione	Obbligatorio
messaggi di input	oggetto		NO
└item_reference	corda	Riferimento a una variabile nello spazio dei nomi `item`. cioè, "item.name"	NO
Modello └─	array	Elenco di messaggi di chat che formano il prompt o il contesto. Può includere riferimenti a variabili allo spazio dei nomi `item`, ad esempio {{item.name}}.	NO
└─ Tipo	enum	Tipo di messaggi di input. Sempre `item_reference`. Valori possibili: `item_reference`	NO
model	corda	Nome del modello da utilizzare per la generazione di completamenti, ad esempio "o3-mini".	NO
sampling_params	AzureEvalAPIResponseSamplingParams		NO
source	oggetto		Sì
└> contenuto	array	Contenuto del file jsonl.	NO
└─created_after	numero intero	Includere solo gli elementi creati dopo questo timestamp (inclusi). Si tratta di un parametro di query usato per selezionare le risposte.	NO
└─ creato_prima	numero intero	Includere solo gli elementi creati prima di questo timestamp (inclusi). Si tratta di un parametro di query usato per selezionare le risposte.	NO
└* id	corda	Identificatore del file.	NO
└instructions_search	corda	Stringa facoltativa per la ricerca nel campo 'instructions'. Si tratta di un parametro di query usato per selezionare le risposte.	NO
└─ metadati	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
└─ Modello	corda	Nome del modello per cui trovare le risposte. Si tratta di un parametro di query usato per selezionare le risposte.	NO
└• reasoning_effort	Sforzo di Ragionamento OpenAI	Parametro facoltativo del tentativo di ragionamento. Si tratta di un parametro di query usato per selezionare le risposte.	NO
└* temperatura	numero	Temperatura di campionamento. Si tratta di un parametro di query usato per selezionare le risposte.	NO
Strumenti └*	array	Elenco dei nomi degli strumenti. Si tratta di un parametro di query usato per selezionare le risposte.	NO
└top_p	numero	Parametro di campionamento del nucleo. Si tratta di un parametro di query usato per selezionare le risposte.	NO
└─ Tipo	enum	Tipo di origine dati di esecuzione. Sempre `responses`. Valori possibili: `responses`	NO
└─ utenti	array	Elenco di identificatori utente. Si tratta di un parametro di query usato per selezionare le risposte.	NO
type	enum	Tipo di origine dati di esecuzione. Sempre `responses`. Valori possibili: `responses`	Sì

OpenAI.EvalRun

Schema che rappresenta un ciclo di valutazione.

Nome	TIPO	Descrzione	Obbligatorio
creato_il	numero intero	Timestamp Unix (in secondi) quando è stata creata l'esecuzione della valutazione.	Sì
fonte_dati	oggetto		Sì
└─ Tipo	OpenAI.EvalRunDataSourceType		NO
Errore	OpenAI.EvalApiError	Oggetto che rappresenta una risposta di errore dall'API Eval.	Sì
eval_id	corda	Identificatore della valutazione associata.	Sì
id	corda	Identificatore univoco per l'esecuzione della valutazione.	Sì
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	Sì
model	corda	Modello valutato, se applicabile.	Sì
nome	corda	Nome della sessione di valutazione.	Sì
oggetto	enum	Tipo dell'oggetto . Sempre "eval.run". Valori possibili: `eval.run`	Sì
utilizzo_per_modello	array	Statistiche di utilizzo per ogni modello durante l'esecuzione della valutazione.	Sì
risultati_per_criteri_di_test	array	Risultati in base ai criteri di test applicati durante l'esecuzione della valutazione.	Sì
report_url	corda	URL del report renderizzato dell'esecuzione della valutazione nella dashboard dell'interfaccia utente.	Sì
conteggio_risultati	oggetto	Contatori che riepilogano i risultati del processo di valutazione.	Sì
└* non riuscito	numero intero	Numero di elementi di output che hanno generato un errore.	NO
└* non riuscito	numero intero	Numero di elementi di output che non sono riusciti a superare la valutazione.	NO
└> superato	numero intero	Numero di elementi di output che hanno superato la valutazione.	NO
└─ totale	numero intero	Numero totale di elementi di output eseguiti.	NO
stato	corda	Stato dell'esecuzione della valutazione.	Sì

OpenAI.EvalRunDataContentSource

Discriminatore per OpenAI.EvalRunDataContentSource

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`file_id`	OpenAI.EvalRunFileIdDataContentSource
`stored_completions`	OpenAI.EvalRunStoredCompletionsDataContentSource
`responses`	OpenAI.EvalRunResponsesDataContentSource

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.EvalRunDataContentSourceType		Sì

OpenAI.EvalRunDataContentSourceType

Proprietà	Value
Tipo	corda
Valori	`file_id` `file_content` `stored_completions` `responses`

OpenAI.EvalRunDataSourceCompletionsResource

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `completions`	Sì

OpenAI.EvalRunDataSourceJsonlResource

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `jsonl`	Sì

OpenAI.EvalRunDataSourceParams

Discriminatore per OpenAI.EvalRunDataSourceParams

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`jsonl`	OpenAI.EvalJsonlRunDataSourceParams
`completions`	OpenAI.EvalCompletionsRunDataSourceParams
`responses`	OpenAI.EvalResponsesRunDataSourceParams

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.EvalRunDataSourceType		Sì

OpenAI.EvalRunDataSourceResource

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.EvalRunDataSourceType		Sì

OpenAI.EvalRunDataSourceResponsesResource

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `responses`	Sì

OpenAI.EvalRunDataSourceType

Proprietà	Value
Tipo	corda
Valori	`jsonl` `completions` `responses`

OpenAI.EvalRunFileContentDataContentSource

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	array	Contenuto del file jsonl.	Sì
type	enum	Tipo di origine JSONL. Sempre `file_content`. Valori possibili: `file_content`	Sì

OpenAI.EvalRunFileIdDataContentSource

Nome	TIPO	Descrzione	Obbligatorio	Default
id	corda	Identificatore del file.	Sì
type	enum	Tipo di origine JSONL. Sempre `file_id`. Valori possibili: `file_id`	Sì

OpenAI.EvalRunList

Oggetto che rappresenta un elenco di run per una valutazione.

Nome	TIPO	Descrzione	Obbligatorio
data	array	Matrice di oggetti di esecuzione di eval.	Sì
first_id	corda	Identificatore della prima esecuzione dell'eval nella matrice di dati.	Sì
ha_di_piu	boolean	Indica se sono disponibili più valutazioni.	Sì
last_id	corda	Identificatore dell'ultima esecuzione di eval nell'array di dati.	Sì
oggetto	enum	Il tipo di quest'oggetto. È sempre impostato su "list". Valori possibili: `list`	Sì

OpenAI.EvalRunOutputItem

Un elemento di output di un'esecuzione di valutazione rappresentato da uno schema.

Nome	TIPO	Descrzione	Obbligatorio
creato_il	numero intero	Timestamp Unix (in secondi) quando è stata creata l'esecuzione della valutazione.	Sì
elemento_fonte_dati	oggetto	Dettagli dell'elemento di origine dei dati di input.	Sì
datasource_item_id (identificativo_elemento_fonte_dati)	numero intero	Identificatore dell'elemento dell'origine dati.	Sì
eval_id	corda	Identificatore del gruppo di valutazione.	Sì
id	corda	Identificatore univoco per l'elemento di output del ciclo di valutazione.	Sì
oggetto	enum	Tipo dell'oggetto . Sempre "eval.run.output_item". Valori possibili: `eval.run.output_item`	Sì
results	array	Elenco dei risultati dell'esecuzione della valutazione.	Sì
run_id	corda	Identificatore dell'esecuzione di valutazione associata a questo elemento dell'output.	Sì
campione	oggetto	Esempio contenente l'input e l'output del processo di valutazione.	Sì
└─ Errore	OpenAI.EvalApiError	Oggetto che rappresenta una risposta di errore dall'API Eval.	NO
└─ motivo_fine	corda	Motivo per cui la generazione dell'esempio è stata completata.	NO
└ Input	array	Matrice di messaggi di input.	NO
└ max_completion_tokens	numero intero	Numero massimo di token consentiti per il completamento.	NO
└─ Modello	corda	Modello utilizzato per generare l'esempio.	NO
└─ uscita	array	Matrice di messaggi di output.	NO
└* seed	numero intero	Il seme utilizzato per generare il campione.	NO
└* temperatura	numero	Temperatura di campionamento utilizzata.	NO
└top_p	numero	Valore top_p utilizzato per il campionamento.	NO
└─ utilizzo	oggetto	Dettagli sull'utilizzo dei token per l'esempio.	NO
└cached_tokens	numero intero	Numero di token recuperati dalla cache.	NO
└completion_tokens	numero intero	Numero di token di completamento generati.	NO
└prompt_tokens	numero intero	Numero di token di richiesta usati.	NO
└total_tokens	numero intero	Numero totale di token usati.	NO
stato	corda	Stato dell'esecuzione della valutazione.	Sì

OpenAI.EvalRunOutputItemList

Oggetto che rappresenta un elenco di elementi di output per un'esecuzione di valutazione.

Nome	TIPO	Descrzione	Obbligatorio
data	array	Una serie di oggetti che rappresentano l'output di esecuzione degli elementi eval.	Sì
first_id	corda	Identificatore del primo elemento di output dell'esecuzione di eval nella matrice di dati.	Sì
ha_di_piu	boolean	Indica se vi sono più elementi di output disponibili dall'esecuzione di valutazione.	Sì
last_id	corda	Identificatore dell'ultimo elemento risultante dall'esecuzione di eval nell'array dei dati.	Sì
oggetto	enum	Il tipo di quest'oggetto. È sempre impostato su "list". Valori possibili: `list`	Sì

OpenAI.EvalRunResponsesDataContentSource

Oggetto EvalResponsesSource che descrive una configurazione dell'origine dati di esecuzione.

Nome	TIPO	Descrzione	Obbligatorio
creato_dopo	numero intero	Includere solo gli elementi creati dopo questo timestamp (inclusi). Si tratta di un parametro di query usato per selezionare le risposte.	NO
creato_prima	numero intero	Includere solo gli elementi creati prima di questo timestamp (inclusi). Si tratta di un parametro di query usato per selezionare le risposte.	NO
instructions_search	corda	Stringa facoltativa per la ricerca nel campo 'instructions'. Si tratta di un parametro di query usato per selezionare le risposte.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
model	corda	Nome del modello per cui trovare le risposte. Si tratta di un parametro di query usato per selezionare le risposte.	NO
sforzo di ragionamento	oggetto	Solo modelli di serie o Vincola il lavoro sul ragionamento per i modelli di ragionamento. I valori attualmente supportati sono `low`, `medium` e `high`. La riduzione del lavoro di ragionamento può tradursi in risposte più veloci e in un minor numero di token usati per il ragionamento in una risposta.	NO
temperatura	numero	Temperatura di campionamento. Si tratta di un parametro di query usato per selezionare le risposte.	NO
strumenti	array	Elenco dei nomi degli strumenti. Si tratta di un parametro di query usato per selezionare le risposte.	NO
top_p	numero	Parametro di campionamento del nucleo. Si tratta di un parametro di query usato per selezionare le risposte.	NO
type	enum	Tipo di origine dati di esecuzione. Sempre `responses`. Valori possibili: `responses`	Sì
users	array	Elenco di identificatori utente. Si tratta di un parametro di query usato per selezionare le risposte.	NO

OpenAI.EvalRunStoredCompletionsDataContentSource

Una configurazione StoredCompletionsRunDataSource che descrive un set di filtri

Nome	TIPO	Descrzione	Obbligatorio
creato_dopo	numero intero	Timestamp Unix facoltativo per filtrare gli elementi creati dopo questo momento.	NO
creato_prima	numero intero	Timestamp Unix facoltativo per filtrare gli elementi creati prima di questa volta.	NO
limit	numero intero	Numero massimo facoltativo di elementi da restituire.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	Sì
model	corda	Modello facoltativo da filtrare in base a (ad esempio, 'gpt-4o').	NO
type	enum	Tipo di origine. Sempre `stored_completions`. Valori possibili: `stored_completions`	Sì

OpenAI.EvalStoredCompletionsDataSourceConfigParams

Deprecato a favore di LogsDataSourceConfig.

Nome	TIPO	Descrzione	Obbligatorio	Default
metadata	oggetto	Filtri dei metadati per l'origine dati dei completamenti archiviati.	NO
type	enum	Tipo di origine dati. Sempre `stored_completions`. Valori possibili: `stored_completions`	Sì

OpenAI.EvalStoredCompletionsDataSourceConfigResource

Deprecato a favore di LogsDataSourceConfig.

Nome	TIPO	Descrzione	Obbligatorio
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	Sì
schema	oggetto	Schema Json per gli elementi della fonte dati di esecuzione. Informazioni su come creare schemi JSON qui.	Sì
type	enum	Tipo di origine dati. Sempre `stored_completions`. Valori possibili: `stored_completions`	Sì

OpenAI.FileSearchTool

Strumento che cerca il contenuto pertinente dai file caricati.

Nome	TIPO	Descrzione	Obbligatorio
filters	oggetto		NO
max_num_risultati	numero intero	Il numero massimo di risultati da restituire. Questo numero deve essere compreso tra 1 e 50 (estremi inclusi).	NO
opzioni_di_classifica	oggetto		NO
└* ranker	enum	Ranker da usare per la ricerca di file. Valori possibili: `auto`, `default-2024-11-15`	NO
└─ soglia_punteggio	numero	Soglia del punteggio per la ricerca di file, un numero compreso tra 0 e 1. I numeri più vicini a 1 tenteranno di restituire solo i risultati più rilevanti, ma potrebbero restituire meno risultati.	NO
type	enum	Tipo dello strumento di ricerca file. Sempre `file_search`. Valori possibili: `file_search`	Sì
vector_store_ids	array	ID degli archivi vettoriali da cercare.	Sì

OpenAI.FileSearchToolCallItemParam

Risultati di una chiamata allo strumento di ricerca file.

Nome	TIPO	Descrzione	Obbligatorio
queries	array	Le interrogazioni usate per cercare i file.	Sì
results	array	Risultati della chiamata allo strumento di ricerca file.	NO
type	enum	Valori possibili: `file_search_call`	Sì

OpenAI.FileSearchToolCallItemResource

Risultati di una chiamata allo strumento di ricerca file.

Nome	TIPO	Descrzione	Obbligatorio
queries	array	Le interrogazioni usate per cercare i file.	Sì
results	array	Risultati della chiamata allo strumento di ricerca file.	NO
stato	enum	Stato della chiamata allo strumento di ricerca file. Uno di `in_progress`, `searchingincomplete` o `failed`. Valori possibili: `in_progress`, `searchingcompleted`, , `incomplete`,`failed`	Sì
type	enum	Valori possibili: `file_search_call`	Sì

OpenAI.Filters

Nome	TIPO	Descrzione	Obbligatorio
filters	array	Matrice di filtri da combinare. Gli elementi possono essere `ComparisonFilter` o `CompoundFilter`.	Sì
chiave	corda	La chiave da confrontare rispetto al valore.	Sì
type	enum	Tipo di operazione: `and` o `or`. Valori possibili: `and`, `or`	Sì
valore	stringa o numero o valore booleano	Valore da confrontare con la chiave dell'attributo; supporta tipi stringa, numero o boolean.	Sì

OpenAI.FineTuneDPOHyperparameters

Iperparametri usati per il processo di ottimizzazione DPO.

Nome	TIPO	Descrzione	Obbligatorio
dimensione del batch	enum	Valori possibili: `auto`	NO
beta	enum	Valori possibili: `auto`	NO
moltiplicatore_tasso_apprendimento	enum	Valori possibili: `auto`	NO
numero di epoche	enum	Valori possibili: `auto`	NO

OpenAI.FineTuneDPOMethod

Configurazione per il metodo di ottimizzazione DPO.

Nome	TIPO	Descrzione	Obbligatorio	Default
iperparametri	OpenAI.FineTuneDPOHyperparameters	Iperparametri usati per il processo di ottimizzazione DPO.	NO

OpenAI.FineTuneMethod

Metodo utilizzato per l'ottimizzazione.

Nome	TIPO	Descrzione	Obbligatorio
DPO	OpenAI.FineTuneDPOMethod	Configurazione per il metodo di ottimizzazione DPO.	NO
rinforzo	AzureFineTuneReinforcementMethod		NO
vigilato	OpenAI.FineTuneSupervisedMethod	Configurazione per il metodo di ottimizzazione con supervisione.	NO
type	enum	Tipo di metodo. È `supervised`, `dpo` o `reinforcement`. Valori possibili: `supervised`, `dpo`, `reinforcement`	Sì

OpenAI.FineTuneReinforcementHyperparameters

Iperparametri usati per il processo di ottimizzazione per rinforzo.

Nome	TIPO	Descrzione	Obbligatorio
dimensione del batch	enum	Valori possibili: `auto`	NO
compute_multiplier	enum	Valori possibili: `auto`	NO
eval_interval	enum	Valori possibili: `auto`	NO
eval_samples	enum	Valori possibili: `auto`	NO
moltiplicatore_tasso_apprendimento	enum	Valori possibili: `auto`	NO
numero di epoche	enum	Valori possibili: `auto`	NO
sforzo di ragionamento	enum	Livello di sforzo di ragionamento. Valori possibili: `default`, `low`, `medium`, `high`	NO

OpenAI.FineTuneSupervisedHyperparameters

Iperparametri usati per il processo di ottimizzazione.

Nome	TIPO	Descrzione	Obbligatorio
dimensione del batch	enum	Valori possibili: `auto`	NO
moltiplicatore_tasso_apprendimento	enum	Valori possibili: `auto`	NO
numero di epoche	enum	Valori possibili: `auto`	NO

OpenAI.FineTuneSupervisedMethod

Configurazione per il metodo di ottimizzazione con supervisione.

Nome	TIPO	Descrzione	Obbligatorio	Default
iperparametri	OpenAI.FineTuneSupervisedHyperparameters	Iperparametri usati per il processo di ottimizzazione.	NO

OpenAI.FineTuningIntegration

Discriminatore per OpenAI.FineTuningIntegration

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`wandb`	OpenAI.FineTuningIntegrationWandb

Nome	TIPO	Descrzione	Obbligatorio	Default
type	string (vedere modelli validi di seguito)		Sì

OpenAI.FineTuningIntegrationWandb

Nome	TIPO	Descrzione	Obbligatorio
type	enum	Tipo dell'integrazione abilitata per il processo di ottimizzazione. Valori possibili: `wandb`	Sì
wandb	oggetto	Impostazioni per l'integrazione con pesi e distorsioni. Questo payload specifica il project a cui verranno inviate le metriche. Facoltativamente, è possibile impostare un nome visualizzato esplicito per l'esecuzione, aggiungere tag all'esecuzione e impostare un'entità predefinita (team, nome utente e così via) da associare all'esecuzione.	Sì
└─ Entità	corda	Entità da utilizzare per l'esecuzione. In questo modo è possibile impostare il team o il nome utente dell'utente WandB che si desidera associare all'operazione. Se non è impostato, viene usata l'entità predefinita per la chiave API JpgB registrata.	NO
└> nome	corda	Nome visualizzato da impostare per l'esecuzione. Se non è impostato, verrà usato l'ID processo come nome.	NO
└project	corda	Nome del project in cui verrà creata la nuova esecuzione.	NO
└* tag	array	Elenco di tag da collegare all'esecuzione appena creata. Questi tag vengono passati direttamente a JpgB. Alcuni tag predefiniti vengono generati da OpenAI: "openai/finetune", "openai/{base-model}", "openai/{ftjob-abcdef}".	NO

OpenAI.FineTuningJob

L'oggetto fine_tuning.job rappresenta un processo di ottimizzazione che è stato creato tramite l'API.

Nome	TIPO	Descrzione	Obbligatorio
creato_il	numero intero	Timestamp Unix (in secondi) per la creazione del processo di ottimizzazione.	Sì
Errore	oggetto	Per i processi di ottimizzazione con `failed`, verranno fornite ulteriori informazioni sulla causa dell'errore.	Sì
└─ codice	corda	Codice di errore leggibile dal computer.	NO
└* messaggio	corda	Messaggio di errore leggibile.	NO
└* param	corda	Parametro non valido, in genere `training_file` o `validation_file`. Questo campo sarà Null se l'errore non fosse specifico del parametro.	NO
completamento stimato	numero intero	Timestamp Unix (in secondi) relativo alla previsione di completamento del processo di ottimizzazione. Il valore sarà Null se il processo di ottimizzazione non è in esecuzione.	NO
fine_tuned_model	corda	Nome del modello ottimizzato in fase di creazione. Il valore sarà Null se il processo di ottimizzazione è ancora in esecuzione.	Sì
terminato_il	numero intero	Timestamp Unix (in secondi) per il completamento del processo di ottimizzazione. Il valore sarà Null se il processo di ottimizzazione è ancora in esecuzione.	Sì
iperparametri	oggetto	Iperparametri usati per il processo di ottimizzazione. Questo valore verrà restituito solo durante l'esecuzione di processi `supervised`.	Sì
└' batch_size	enum	Valori possibili: `auto`	NO
└' learning_rate_multiplier	enum	Valori possibili: `auto`	NO
└' n_epochs	enum	Valori possibili: `auto`	NO
id	corda	Identificatore dell'oggetto a cui è possibile fare riferimento negli endpoint dell'API.	Sì
integrazioni	array	Elenco di integrazioni da abilitare per questo processo di ottimizzazione.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	Sì
method	OpenAI.FineTuneMethod	Metodo utilizzato per l'ottimizzazione.	NO
model	corda	Modello di base ottimizzato.	Sì
oggetto	enum	Tipo di oggetto, che è sempre "fine_tuning.job". Valori possibili: `fine_tuning.job`	Sì
organization_id	corda	L'organizzazione proprietaria del processo di ottimizzazione.	Sì
file_di_risultato	array	ID file dei risultati compilati per il processo di ottimizzazione. È possibile recuperare i risultati con l'API File.	Sì
seed	numero intero	Valore di inizializzazione utilizzato per il processo di ottimizzazione.	Sì
stato	enum	Stato corrente del processo di ottimizzazione, che può essere `validating_files`, `queued`, `running`, `succeeded`, `failed`o `cancelled`. Valori possibili: `validating_files`, `queuedrunning`, `succeeded`, , `failedcancelled`	Sì
trained_tokens	numero intero	Numero totale di token fatturabili elaborati da questo processo di ottimizzazione. Il valore sarà Null se il processo di ottimizzazione è ancora in esecuzione.	Sì
file di allenamento	corda	ID file utilizzato per il training. È possibile recuperare i dati di training con l'API File.	Sì
user_provided_suffix	corda	Suffisso descrittivo applicato al processo, come specificato nella richiesta di creazione del processo.	NO
file_di_validazione	corda	ID file utilizzato per la convalida. È possibile recuperare i risultati della convalida con l'API File.	Sì

OpenAI.FineTuningJobCheckpoint

L'oggetto fine_tuning.job.checkpoint rappresenta un checkpoint del modello per un processo di ottimizzazione pronto per l'uso.

Nome	TIPO	Descrzione	Obbligatorio
creato_il	numero intero	Timestamp UNIX (in secondi) relativo al momento in cui è stato creato il checkpoint.	Sì
punto_di_controllo_modello_ottimizzato	corda	Nome del modello di checkpoint ottimizzato che viene creato.	Sì
id_lavoro_affinamento	corda	Nome del processo di ottimizzazione da cui è stato creato il checkpoint.	Sì
id	corda	Identificatore del checkpoint, a cui è possibile fare riferimento negli endpoint dell'API.	Sì
metrics	oggetto	Metriche al numero di passaggio durante il processo di ottimizzazione.	Sì
└' full_valid_loss	numero		NO
└' full_valid_mean_token_accuracy	numero		NO
└* passaggio	numero		NO
└' train_loss	numero		NO
└' train_mean_token_accuracy	numero		NO
└' valid_loss	numero		NO
└' valid_mean_token_accuracy	numero		NO
oggetto	enum	Tipo di oggetto, che è sempre "fine_tuning.job.checkpoint". Valori possibili: `fine_tuning.job.checkpoint`	Sì
numero_passaggio	numero intero	Numero del passaggio in cui è stato creato il checkpoint.	Sì

OpenAI.FineTuningJobEvent

Oggetto evento processo di ottimizzazione

Nome	TIPO	Descrzione	Obbligatorio
creato_il	numero intero	Timestamp Unix (in secondi) per la creazione del processo di ottimizzazione.	Sì
data		Dati associati all'evento.	NO
id	corda	Identificatore dell'oggetto.	Sì
livello	enum	Livello di log dell'evento. Valori possibili: `info`, `warn`, `error`	Sì
message	corda	Messaggio dell'evento.	Sì
oggetto	enum	Tipo di oggetto, che è sempre "fine_tuning.job.event". Valori possibili: `fine_tuning.job.event`	Sì
type	enum	Il tipo di evento. Valori possibili: `message`, `metrics`	NO

OpenAI.FunctionObject

Nome	TIPO	Descrzione	Obbligatorio	Default
descrizione	corda	Descrizione delle operazioni della funzione, usate dal modello per scegliere quando e come chiamare la funzione.	NO
nome	corda	Nome della funzione che deve essere chiamata. Deve essere a-z, A-Z, 0-9 o contenere caratteri di sottolineatura e trattini, con una lunghezza massima di 64 caratteri.	Sì
parameters		I parametri accettati dalle funzioni, descritti come oggetto Schema JSON.	NO
rigido	boolean	Indica se abilitare una rigorosa conformità allo schema durante la generazione della chiamata di funzione. Se impostato su true, il modello seguirà lo schema esatto definito nel campo `parameters`. Solo un subset di schema JSON è supportato quando `strict` è `true`.	NO	Falso

OpenAI.FunctionTool

Definisce una funzione nel tuo codice che il modello può chiamare.

Nome	TIPO	Descrzione	Obbligatorio
descrizione	corda	Descrizione della funzione. Utilizzato dal modello per determinare se chiamare o meno la funzione.	NO
nome	corda	Nome della funzione da chiamare.	Sì
parameters		Oggetto schema JSON che descrive i parametri della funzione.	Sì
rigido	boolean	Indica se applicare la convalida rigorosa dei parametri. Valore predefinito `true`.	Sì
type	enum	Tipo di strumento funzionale. Sempre `function`. Valori possibili: `function`	Sì

OpenAI.FunctionToolCallItemParam

Chiamata di uno strumento per eseguire una funzione.

Nome	TIPO	Descrzione	Obbligatorio
arguments	corda	Stringa JSON degli argomenti da passare alla funzione.	Sì
call_id	corda	ID univoco della chiamata dello strumento di funzione generata dal modello.	Sì
nome	corda	Nome della funzione da eseguire.	Sì
type	enum	Valori possibili: `function_call`	Sì

OpenAI.FunctionToolCallItemResource

Chiamata di uno strumento per eseguire una funzione.

Nome	TIPO	Descrzione	Obbligatorio
arguments	corda	Stringa JSON degli argomenti da passare alla funzione.	Sì
call_id	corda	ID univoco della chiamata dello strumento di funzione generata dal modello.	Sì
nome	corda	Nome della funzione da eseguire.	Sì
stato	enum	Stato dell'elemento. Uno tra `in_progress`, `completed` e `incomplete`. Popolato quando gli elementi vengono restituiti tramite l'API. Valori possibili: `in_progress`, `completed`, `incomplete`	Sì
type	enum	Valori possibili: `function_call`	Sì

OpenAI.FunctionToolCallOutputItemParam

Output di una chiamata dello strumento di funzione.

Nome	TIPO	Descrzione	Obbligatorio
call_id	corda	ID univoco della chiamata dello strumento di funzione generata dal modello.	Sì
output	corda	Stringa JSON dell'output della chiamata dello strumento di funzione.	Sì
type	enum	Valori possibili: `function_call_output`	Sì

OpenAI.FunctionToolCallOutputItemResource

Output di una chiamata dello strumento di funzione.

Nome	TIPO	Descrzione	Obbligatorio
call_id	corda	ID univoco della chiamata dello strumento di funzione generata dal modello.	Sì
output	corda	Stringa JSON dell'output della chiamata dello strumento di funzione.	Sì
stato	enum	Stato dell'elemento. Uno tra `in_progress`, `completed` e `incomplete`. Popolato quando gli elementi vengono restituiti tramite l'API. Valori possibili: `in_progress`, `completed`, `incomplete`	Sì
type	enum	Valori possibili: `function_call_output`	Sì

OpenAI.Grader

Discriminatore per OpenAI.Grader

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`label_model`	OpenAI.GraderLabelModel
`text_similarity`	OpenAI.GraderTextSimilarity
`python`	OpenAI.GraderPython
`score_model`	OpenAI.GraderScoreModel
`multi`	OpenAI.GraderMulti

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.GraderType		Sì

OpenAI.GraderLabelModel

Oggetto LabelModelGrader che usa un modello per assegnare etichette a ogni elemento della valutazione.

Nome	TIPO	Descrzione	Obbligatorio
ingresso	array		Sì
labels	array	Etichette da assegnare a ogni elemento della valutazione.	Sì
model	corda	Modello da utilizzare per la valutazione. Deve supportare output strutturati.	Sì
nome	corda	Nome del grader.	Sì
etichette_di_passaggio	array	Le etichette che indicano un risultato positivo. Deve essere un sottoinsieme di etichette.	Sì
type	enum	Il tipo di oggetto, che è sempre `label_model`. Valori possibili: `label_model`	Sì

OpenAI.GraderMulti

Un oggetto multivalutatori combina l'output di più grader per produrre un singolo punteggio.

Nome	TIPO	Descrzione	Obbligatorio
calculate_output	corda	Formula per calcolare l'output in base ai risultati del classificatore.	Sì
valutatori	oggetto		Sì
nome	corda	Nome del grader.	Sì
type	enum	Il tipo di oggetto, che è sempre `multi`. Valori possibili: `multi`	Sì

OpenAI.GraderPython

Oggetto PythonGrader che esegue uno script Python nell'input.

Nome	TIPO	Descrzione	Obbligatorio
image_tag	corda	Tag immagine da usare per lo script Python.	NO
nome	corda	Nome del grader.	Sì
source	corda	Codice sorgente dello script Python.	Sì
type	enum	Il tipo di oggetto, che è sempre `python`. Valori possibili: `python`	Sì

OpenAI.GraderScoreModel

Oggetto ScoreModelGrader che usa un modello per assegnare un punteggio all'input.

Nome	TIPO	Descrzione	Obbligatorio
ingresso	array	Testo di input. Ciò può includere stringhe di modello.	Sì
model	corda	Modello da utilizzare per la valutazione.	Sì
nome	corda	Nome del grader.	Sì
intervallo	array	La gamma del punteggio. Il valore predefinito è `[0, 1]`.	NO
sampling_params		Parametri di campionamento per il modello.	NO
type	enum	Il tipo di oggetto, che è sempre `score_model`. Valori possibili: `score_model`	Sì

OpenAI.GraderStringCheck

Oggetto StringCheckGrader che esegue un confronto di stringhe tra input e riferimento usando un'operazione specificata.

Nome	TIPO	Descrzione	Obbligatorio
ingresso	corda	Testo di input. Ciò può includere stringhe di modello.	Sì
nome	corda	Nome del grader.	Sì
operazione	enum	Operazione di controllo della stringa da eseguire. Uno tra `eq`, `ne`, `like` o `ilike`. Valori possibili: `eq`, `ne`, `like`, `ilike`	Sì
riferimento	corda	Testo di riferimento. Ciò può includere stringhe di modello.	Sì
type	enum	Il tipo di oggetto, che è sempre `string_check`. Valori possibili: `string_check`	Sì

OpenAI.GraderTextSimilarity

Oggetto TextSimilarityGrader che assegna un grado al testo in base alle metriche di somiglianza.

Nome	TIPO	Descrzione	Obbligatorio
metrica di valutazione	enum	Metrica di valutazione da usare. Uno di `fuzzy_match`, `bleu`, `gleu`, `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5` o `rouge_l`. Valori possibili: `fuzzy_match`, `bleu`, `gleumeteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5rouge_l`	Sì
ingresso	corda	Il testo in valutazione.	Sì
nome	corda	Nome del grader.	Sì
riferimento	corda	Testo che viene valutato.	Sì
type	enum	Tipo di grader. Valori possibili: `text_similarity`	Sì

OpenAI.GraderType

Proprietà	Value
Tipo	corda
Valori	`string_check` `text_similarity` `score_model` `label_model` `python` `multi`

OpenAI.ImageGenTool

Strumento che genera immagini usando un modello come gpt-image-1.5.

Nome	TIPO	Descrzione	Obbligatorio	Default
sfondo	enum	Tipo di sfondo per l'immagine generata. Uno tra `transparent`, `opaque` e `auto`. Impostazione predefinita: `auto`. Valori possibili: `transparent`, `opaque`, `auto`	NO
input_image_mask	oggetto	Maschera opzionale per ritocco immagine. Contiene `image_url` (stringa, facoltativa) e `file_id` (stringa, facoltativa).	NO
└ file_id	corda	ID del file per l'immagine della maschera.	NO
└ image_url	corda	Immagine maschera con codifica Base64.	NO
model	enum	Modello di generazione di immagini da usare. Impostazione predefinita: `gpt-image-1`. Valori possibili: `gpt-image-1`, `gpt-image-1.5`	NO
moderation	enum	Livello di moderazione per l'immagine generata. Impostazione predefinita: `auto`. Valori possibili: `auto`, `low`	NO
Compressione dell'output	numero intero	Livello di compressione per l'immagine di output. Predefinito: 100.	NO	100
formato_di_output	enum	Formato di output dell'immagine generata. Uno tra `png`, `webp` e `jpeg`. Impostazione predefinita: `png`. Valori possibili: `png`, `webp`, `jpeg`	NO
immagini parziali	numero intero	Numero di immagini parziali da generare in modalità di streaming, da 0 (valore predefinito) a 3.	NO	0
qualità	enum	Qualità dell'immagine generata. Uno tra `low`, `medium`, `high` o `auto`. Impostazione predefinita: `auto`. Valori possibili: `low`, `medium`, `high`, `auto`	NO
size	enum	Dimensioni dell'immagine generata. Uno tra `1024x1024`, `1024x1536`, `1536x1024` o `auto`. Impostazione predefinita: `auto`. Valori possibili: `1024x1024`, `1024x1536`, `1536x1024`, `auto`	NO
type	enum	Tipo dello strumento di generazione di immagini. Sempre `image_generation`. Valori possibili: `image_generation`	Sì

OpenAI.ImageGenToolCallItemParam

Richiesta di generazione di immagini effettuata dal modello.

Nome	TIPO	Descrzione	Obbligatorio	Default
risultato	corda	Immagine generata codificata in base64.	Sì
type	enum	Valori possibili: `image_generation_call`	Sì

OpenAI.ImageGenToolCallItemResource

Richiesta di generazione di immagini effettuata dal modello.

Nome	TIPO	Descrzione	Obbligatorio
risultato	corda	Immagine generata codificata in base64.	Sì
stato	enum	Valori possibili: `in_progress`, `completed`, `generating`, `failed`	Sì
type	enum	Valori possibili: `image_generation_call`	Sì

OpenAI.ImplicitUserMessage

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	stringa o matrice		Sì

OpenAI.Includable

Specificare dati di output aggiuntivi da includere nella risposta del modello. I valori attualmente supportati sono:

code_interpreter_call.outputs: include gli output dell'esecuzione di codice Python negli elementi di chiamata dello strumento dell'interprete di codice.
computer_call_output.output.image_url: includere gli URL delle immagini provenienti dall'output della chiamata computer.
file_search_call.results: includere i risultati della ricerca della chiamata allo strumento di ricerca file.
message.input_image.image_url: includere gli URL dell'immagine dal messaggio di input.
message.output_text.logprobs: includere logprob con messaggi di assistente.
reasoning.encrypted_content: include una versione crittografata dei token di ragionamento negli output degli elementi di ragionamento. Ciò consente di usare gli elementi di ragionamento nelle conversazioni a più turni quando si usa l'API Risposte senza stato (ad esempio quando il store parametro è impostato su falseo quando un'organizzazione viene registrata nel programma di conservazione dei dati zero).

Proprietà	Value
Descrizione	Specificare dati di output aggiuntivi da includere nella risposta del modello. I valori attualmente supportati sono: - `code_interpreter_call.outputs`: includono i risultati dell'esecuzione di Python negli elementi di chiamata dello strumento interprete di codice. - `computer_call_output.output.image_url`: includere gli URL delle immagini provenienti dall'output della chiamata computer. - `file_search_call.results`: includere i risultati della ricerca della chiamata allo strumento di ricerca file. - `message.input_image.image_url`: includere gli URL dell'immagine dal messaggio di input. - `message.output_text.logprobs`: includere logprob con messaggi di assistente. - `reasoning.encrypted_content`: Includere una versione crittografata dei token di ragionamento negli output degli elementi di ragionamento. Ciò consente di usare gli elementi di ragionamento nelle conversazioni a più turni quando si usa l'API Risposte senza stato (ad esempio quando il `store` parametro è impostato su `false`o quando un'organizzazione viene registrata nel programma di conservazione dei dati zero).
Tipo	corda
Valori	`code_interpreter_call.outputs` `computer_call_output.output.image_url` `file_search_call.results` `message.input_image.image_url` `message.output_text.logprobs` `reasoning.encrypted_content`

OpenAI.ItemContent

Discriminare per OpenAI.ItemContent

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`input_audio`	OpenAI.ItemContentInputAudio
`output_audio`	OpenAI.ItemContentOutputAudio
`refusal`	OpenAI.ItemContentRefusal
`input_text`	OpenAI.ItemContentInputText
`input_image`	OpenAI.ItemContentInputImage
`input_file`	OpenAI.ItemContentInputFile
`output_text`	OpenAI.ItemContentOutputText

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.ItemContentType	Contenuti di input e output multimodali.	Sì

OpenAI.ItemContentInputAudio

Input audio per il modello.

Nome	TIPO	Descrzione	Obbligatorio
data	corda	Dati audio con codifica Base64.	Sì
format	enum	Formato dei dati audio. I formati attualmente supportati sono `mp3` e `wav`. Valori possibili: `mp3`, `wav`	Sì
type	enum	Tipo dell'elemento di input. Sempre `input_audio`. Valori possibili: `input_audio`	Sì

OpenAI.ItemContentInputFile

Un file di input per il modello.

Nome	TIPO	Descrzione	Obbligatorio
file_data	corda	Contenuto del file da inviare al modello.	NO
ID del file	corda	ID del file da inviare al modello.	NO
filename	corda	Nome del file da inviare al modello.	NO
type	enum	Tipo dell'elemento di input. Sempre `input_file`. Valori possibili: `input_file`	Sì

OpenAI.ItemContentInputImage

Un'immagine come input per il modello.

Nome	TIPO	Descrzione	Obbligatorio
detail	enum	Livello di dettaglio dell'immagine da inviare al modello. Uno tra `high`, `low` e `auto`. Il valore predefinito è `auto`. Valori possibili: `low`, `high`, `auto`	NO
ID del file	corda	ID del file da inviare al modello.	NO
image_url	corda	URL dell'immagine da inviare al modello. URL completo o immagine con codifica Base64 in un URL dati.	NO
type	enum	Tipo dell'elemento di input. Sempre `input_image`. Valori possibili: `input_image`	Sì

OpenAI.ItemContentInputText

Input di testo per il modello.

Nome	TIPO	Descrzione	Obbligatorio	Default
Testo	corda	Input di testo per il modello.	Sì
type	enum	Tipo dell'elemento di input. Sempre `input_text`. Valori possibili: `input_text`	Sì

OpenAI.ItemContentOutputAudio

Un'uscita audio dal modello.

Nome	TIPO	Descrzione	Obbligatorio
data	corda	Dati audio con codifica Base64 dal modello.	Sì
transcript	corda	Trascrizione dei dati audio del modello.	Sì
type	enum	Tipo di output audio. Sempre `output_audio`. Valori possibili: `output_audio`	Sì

OpenAI.ItemContentOutputText

Output di testo del modello.

Nome	TIPO	Descrzione	Obbligatorio
annotazioni	array	Annotazioni dell'output di testo.	Sì
logprobs	array		NO
Testo	corda	L'output di testo generato dal modello.	Sì
type	enum	Tipo del testo di uscita. Sempre `output_text`. Valori possibili: `output_text`	Sì

OpenAI.ItemContentRefusal

Rifiuto da parte del modello.

Nome	TIPO	Descrzione	Obbligatorio	Default
refusal	corda	Spiegazione del rifiuto dal modello.	Sì
type	enum	Tipo di rifiuto. Sempre `refusal`. Valori possibili: `refusal`	Sì

OpenAI.ItemContentType

Contenuti di input e output multimodali.

Proprietà	Value
Descrizione	Contenuti di input e output multimodali.
Tipo	corda
Valori	`input_text` `input_audio` `input_image` `input_file` `output_text` `output_audio` `refusal`

OpenAI.ItemParam

Elemento di contenuto usato per generare una risposta.

Discriminare per OpenAI.ItemParam

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`file_search_call`	OpenAI.FileSearchToolCallItemParam
`computer_call`	OpenAI.ComputerToolCallItemParam
`computer_call_output`	OpenAI.ComputerToolCallOutputItemParam
`web_search_call`	OpenAI.WebSearchToolCallItemParam
`function_call`	OpenAI.FunctionToolCallItemParam
`function_call_output`	OpenAI.FunctionToolCallOutputItemParam
`reasoning`	OpenAI.ReasoningItemParam
`item_reference`	OpenAI.ItemReferenceItemParam
`image_generation_call`	OpenAI.ImageGenToolCallItemParam
`code_interpreter_call`	OpenAI.CodeInterpreterToolCallItemParam
`local_shell_call`	OpenAI.LocalShellToolCallItemParam
`local_shell_call_output`	OpenAI.LocalShellToolCallOutputItemParam
`mcp_list_tools`	OpenAI.MCPListToolsItemParam
`mcp_approval_request`	OpenAI.MCPApprovalRequestItemParam
`mcp_approval_response`	OpenAI.MCPApprovalResponseItemParam
`mcp_call`	OpenAI.MCPCallItemParam
`message`	OpenAI.ResponsesMessageItemParam

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.ItemType		Sì

OpenAI.ItemReferenceItemParam

Identificatore interno di un elemento a cui fare riferimento.

Nome	TIPO	Descrzione	Obbligatorio	Default
id	corda	L'ID generato dal servizio relativo all'elemento di risposta precedentemente creato a cui si fa riferimento.	Sì
type	enum	Valori possibili: `item_reference`	Sì

OpenAI.ItemResource

Elemento di contenuto usato per generare una risposta.

Discriminatorio per OpenAI.ItemResource

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`file_search_call`	OpenAI.FileSearchToolCallItemResource
`computer_call`	OpenAI.ComputerToolCallItemResource
`computer_call_output`	OpenAI.ComputerToolCallOutputItemResource
`web_search_call`	OpenAI.WebSearchToolCallItemResource
`function_call`	OpenAI.FunctionToolCallItemResource
`function_call_output`	OpenAI.FunctionToolCallOutputItemResource
`reasoning`	OpenAI.ReasoningItemResource
`image_generation_call`	OpenAI.ImageGenToolCallItemResource
`code_interpreter_call`	OpenAI.CodeInterpreterToolCallItemResource
`local_shell_call`	OpenAI.LocalShellToolCallItemResource
`local_shell_call_output`	OpenAI.LocalShellToolCallOutputItemResource
`mcp_list_tools`	OpenAI.MCPListToolsItemResource
`mcp_approval_request`	OpenAI.MCPApprovalRequestItemResource
`mcp_approval_response`	OpenAI.MCPApprovalResponseItemResource
`mcp_call`	OpenAI.MCPCallItemResource
`message`	OpenAI.ResponsesMessageItemResource

Nome	TIPO	Descrzione	Obbligatorio	Default
id	corda		Sì
type	OpenAI.ItemType		Sì

OpenAI.ItemType

Proprietà	Value
Tipo	corda
Valori	`message` `file_search_call` `function_call` `function_call_output` `computer_call` `computer_call_output` `web_search_call` `reasoning` `item_reference` `image_generation_call` `code_interpreter_call` `local_shell_call` `local_shell_call_output` `mcp_list_tools` `mcp_approval_request` `mcp_approval_response` `mcp_call`

OpenAI.ListFineTuningJobCheckpointsResponse

Nome	TIPO	Descrzione	Obbligatorio
data	array		Sì
first_id	corda		NO
ha_di_piu	boolean		Sì
last_id	corda		NO
oggetto	enum	Valori possibili: `list`	Sì

OpenAI.ListFineTuningJobEventsResponse

Nome	TIPO	Descrzione	Obbligatorio
data	array		Sì
ha_di_piu	boolean		Sì
oggetto	enum	Valori possibili: `list`	Sì

OpenAI.ListModelsResponse

Nome	TIPO	Descrzione	Obbligatorio	Default
data	array		Sì
oggetto	enum	Valori possibili: `list`	Sì

OpenAI.ListPaginatedFineTuningJobsResponse

Nome	TIPO	Descrzione	Obbligatorio
data	array		Sì
ha_di_piu	boolean		Sì
oggetto	enum	Valori possibili: `list`	Sì

OpenAI.ListVectorStoreFilesFilter

Proprietà	Value
Tipo	corda
Valori	`in_progress` `completed` `failed` `cancelled`

OpenAI.ListVectorStoreFilesResponse

Nome	TIPO	Descrzione	Obbligatorio
data	array		Sì
first_id	corda		Sì
ha_di_piu	boolean		Sì
last_id	corda		Sì
oggetto	enum	Valori possibili: `list`	Sì

OpenAI.ListVectorStoresResponse

Nome	TIPO	Descrzione	Obbligatorio
data	array		Sì
first_id	corda		Sì
ha_di_piu	boolean		Sì
last_id	corda		Sì
oggetto	enum	Valori possibili: `list`	Sì

OpenAI.LocalShellExecAction

Eseguire un comando della shell nel server.

Nome	TIPO	Descrzione	Obbligatorio
command	array	Il comando da eseguire.	Sì
Env	oggetto	Variabili di ambiente da impostare per il comando.	Sì
timeout_ms	numero intero	Timeout facoltativo in millisecondi per il comando.	NO
type	enum	Tipo dell'azione della shell locale. Sempre `exec`. Valori possibili: `exec`	Sì
utente	corda	Utente facoltativo con cui eseguire il comando.	NO
working_directory	corda	Directory di lavoro facoltativa in cui eseguire il comando.	NO

OpenAI.LocalShellTool

Strumento che consente al modello di eseguire comandi della shell in un ambiente locale.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Tipo dello strumento shell locale. Sempre `local_shell`. Valori possibili: `local_shell`	Sì

OpenAI.LocalShellToolCallItemParam

Chiamata allo strumento per eseguire un comando nella shell locale.

Nome	TIPO	Descrzione	Obbligatorio
azione	OpenAI.LocalShellExecAction	Eseguire un comando della shell nel server.	Sì
call_id	corda	ID univoco della chiamata allo strumento shell locale generata dal modello.	Sì
type	enum	Valori possibili: `local_shell_call`	Sì

OpenAI.LocalShellToolCallItemResource

Chiamata allo strumento per eseguire un comando nella shell locale.

Nome	TIPO	Descrzione	Obbligatorio
azione	OpenAI.LocalShellExecAction	Eseguire un comando della shell nel server.	Sì
call_id	corda	ID univoco della chiamata allo strumento shell locale generata dal modello.	Sì
stato	enum	Valori possibili: `in_progress`, `completed`, `incomplete`	Sì
type	enum	Valori possibili: `local_shell_call`	Sì

OpenAI.LocalShellToolCallOutputItemParam

Output di una chiamata allo strumento shell locale.

Nome	TIPO	Descrzione	Obbligatorio	Default
output	corda	Stringa JSON dell'output della chiamata allo strumento shell locale.	Sì
type	enum	Valori possibili: `local_shell_call_output`	Sì

OpenAI.LocalShellToolCallOutputItemResource

Output di una chiamata allo strumento shell locale.

Nome	TIPO	Descrzione	Obbligatorio
output	corda	Stringa JSON dell'output della chiamata allo strumento shell locale.	Sì
stato	enum	Valori possibili: `in_progress`, `completed`, `incomplete`	Sì
type	enum	Valori possibili: `local_shell_call_output`	Sì

OpenAI.Location

Discriminare per OpenAI.Location

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`approximate`	OpenAI.ApproximateLocation

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.LocationType		Sì

OpenAI.LocationType

Proprietà	Value
Tipo	corda
Valori	`approximate`

OpenAI.LogProb

Probabilità di log di un token.

Nome	TIPO	Obbligatorio
bytes	array	Sì
logprob	numero	Sì
token	corda	Sì
top_logprobs	array	Sì

OpenAI.MCPApprovalRequestItemParam

Richiesta di approvazione umana di una chiamata a uno strumento.

Nome	TIPO	Descrzione	Obbligatorio
arguments	corda	Stringa JSON di argomenti per lo strumento.	Sì
nome	corda	Nome dello strumento da eseguire.	Sì
etichetta del server	corda	Etichetta del server MCP che effettua la richiesta.	Sì
type	enum	Valori possibili: `mcp_approval_request`	Sì

OpenAI.MCPApprovalRequestItemResource

Richiesta di approvazione umana di una chiamata a uno strumento.

Nome	TIPO	Descrzione	Obbligatorio
arguments	corda	Stringa JSON di argomenti per lo strumento.	Sì
nome	corda	Nome dello strumento da eseguire.	Sì
etichetta del server	corda	Etichetta del server MCP che effettua la richiesta.	Sì
type	enum	Valori possibili: `mcp_approval_request`	Sì

OpenAI.MCPApprovalResponseItemParam

Risposta a una richiesta di approvazione MCP.

Nome	TIPO	Descrzione	Obbligatorio
approval_request_id	corda	ID della richiesta di approvazione a cui si sta rispondendo.	Sì
approve	boolean	Indica se la richiesta è stata approvata.	Sì
reason	corda	Motivo facoltativo della decisione.	NO
type	enum	Valori possibili: `mcp_approval_response`	Sì

OpenAI.MCPApprovalResponseItemResource

Risposta a una richiesta di approvazione MCP.

Nome	TIPO	Descrzione	Obbligatorio
approval_request_id	corda	ID della richiesta di approvazione a cui si sta rispondendo.	Sì
approve	boolean	Indica se la richiesta è stata approvata.	Sì
reason	corda	Motivo facoltativo della decisione.	NO
type	enum	Valori possibili: `mcp_approval_response`	Sì

OpenAI.MCPCallItemParam

Chiamata di uno strumento in un server MCP.

Nome	TIPO	Descrzione	Obbligatorio
arguments	corda	Stringa JSON degli argomenti passati allo strumento.	Sì
Errore	corda	Errore della chiamata allo strumento, se presente.	NO
nome	corda	Nome dello strumento eseguito.	Sì
output	corda	Risultato della chiamata allo strumento.	NO
etichetta del server	corda	Etichetta del server MCP che esegue lo strumento.	Sì
type	enum	Valori possibili: `mcp_call`	Sì

OpenAI.MCPCallItemResource

Chiamata di uno strumento in un server MCP.

Nome	TIPO	Descrzione	Obbligatorio
arguments	corda	Stringa JSON degli argomenti passati allo strumento.	Sì
Errore	corda	Errore della chiamata allo strumento, se presente.	NO
nome	corda	Nome dello strumento eseguito.	Sì
output	corda	Risultato della chiamata allo strumento.	NO
etichetta del server	corda	Etichetta del server MCP che esegue lo strumento.	Sì
type	enum	Valori possibili: `mcp_call`	Sì

OpenAI.MCPListToolsItemParam

Elenco di strumenti disponibili in un server MCP.

Nome	TIPO	Descrzione	Obbligatorio
Errore	corda	Messaggio di errore se il server non è riuscito ad elencare gli strumenti.	NO
etichetta del server	corda	Etichetta del server MCP.	Sì
strumenti	array	Strumenti disponibili nel server.	Sì
type	enum	Valori possibili: `mcp_list_tools`	Sì

OpenAI.MCPListToolsItemResource

Elenco di strumenti disponibili in un server MCP.

Nome	TIPO	Descrzione	Obbligatorio
Errore	corda	Messaggio di errore se il server non è riuscito ad elencare gli strumenti.	NO
etichetta del server	corda	Etichetta del server MCP.	Sì
strumenti	array	Strumenti disponibili nel server.	Sì
type	enum	Valori possibili: `mcp_list_tools`	Sì

OpenAI.MCPListToolsTool

Strumento disponibile in un server MCP.

Nome	TIPO	Descrzione	Obbligatorio
annotazioni		Annotazioni aggiuntive sullo strumento.	NO
descrizione	corda	Descrizione dello strumento.	NO
input_schema		Schema JSON che descrive l'input dello strumento.	Sì
nome	corda	Nome dello strumento.	Sì

OpenAI.MCPTool

Assegnare al modello access strumenti aggiuntivi tramite server MCP (Model Context Protocol) remoti.

Nome	TIPO	Descrzione	Obbligatorio
strumenti consentiti	oggetto		NO
└tool_names	array	Elenco dei nomi degli strumenti consentiti.	NO
headers	oggetto	Intestazioni HTTP facoltative da inviare al server MCP. Usare per l'autenticazione o altri scopi.	NO
richiedere_approvazione	oggetto (vedere modelli validi di seguito)	Specificare quale degli strumenti del server MCP richiede l'approvazione.	NO
etichetta del server	corda	Etichetta per questo server MCP, usata per identificarla nelle chiamate degli strumenti.	Sì
URL del server	corda	URL del server MCP.	Sì
type	enum	Tipo dello strumento MCP. Sempre `mcp`. Valori possibili: `mcp`	Sì

OpenAI.MetadataPropertyForRequest

Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.

Nome	TIPO	Descrzione	Obbligatorio	Default
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO

OpenAI.Model

Descrive un'offerta di modello OpenAI che può essere usata con l'API.

Nome	TIPO	Descrzione	Obbligatorio
created	numero intero	Timestamp Unix (in secondi) durante la creazione del modello.	Sì
id	corda	Identificatore del modello a cui è possibile fare riferimento negli endpoint dell'API.	Sì
oggetto	enum	Tipo di oggetto, che è sempre "model". Valori possibili: `model`	Sì
owned_by	corda	L'organizzazione proprietaria del modello.	Sì

OpenAI.OtherChunkingStrategyResponseParam

Viene restituito quando la strategia di suddivisione in blocchi è sconosciuta. In genere, ciò è dovuto al fatto che il file è stato indicizzato prima dell'introduzione del concetto chunking_strategy nell'API.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Sempre `other`. Valori possibili: `other`	Sì

OpenAI.ParallelToolCalls

Indica se abilitare o meno la chiamata di funzioni parallele durante l'uso dello strumento.

Tipo: booleano

OpenAI.Prompt

Riferimento a un modello di richiesta e alle relative variabili.

Nome	TIPO	Descrzione	Obbligatorio
id	corda	Identificatore univoco del modello di richiesta da utilizzare.	Sì
variabili	oggetto	Mappa facoltativa di valori da sostituire con le variabili nel prompt. I valori di sostituzione possono essere stringhe o altri tipi di input response, ad esempio immagini o file.	NO
version	corda	Versione facoltativa del modello di richiesta.	NO

OpenAI.OpzioniDiClassifica

Nome	TIPO	Descrzione	Obbligatorio	Default
classificatore	enum	Ranker da usare per la ricerca di file. Valori possibili: `auto`, `default-2024-11-15`	NO
soglia_punteggio	numero	Soglia del punteggio per la ricerca di file, un numero compreso tra 0 e 1. I numeri più vicini a 1 tenteranno di restituire solo i risultati più rilevanti, ma potrebbero restituire meno risultati.	NO

OpenAI.Reasoning

Solo modelli di serie o

Nome	TIPO	Descrzione	Obbligatorio
effort	oggetto	Solo modelli di serie o Vincola il lavoro sul ragionamento per i modelli di ragionamento. I valori attualmente supportati sono `low`, `medium` e `high`. La riduzione del lavoro di ragionamento può tradursi in risposte più veloci e in un minor numero di token usati per il ragionamento in una risposta.	NO
generate_summary	enum	Deprecato: usare `summary` invece. Riepilogo del ragionamento eseguito dal modello. Ciò può essere utile per eseguire il debug e comprendere il processo di ragionamento del modello. Uno tra `auto`, `concise` e `detailed`. Valori possibili: `auto`, `concise`, `detailed`	NO
summary	enum	Riepilogo del ragionamento eseguito dal modello. Ciò può essere utile per eseguire il debug e comprendere il processo di ragionamento del modello. Uno tra `auto`, `concise` e `detailed`. Valori possibili: `auto`, `concise`, `detailed`	NO

OpenAI.SforzoDiRagionamento

Solo modelli di serie o

Vincola il lavoro sul ragionamento per i modelli di ragionamento. I valori attualmente supportati sono low, medium e high. La riduzione del lavoro di ragionamento può tradursi in risposte più veloci e in un minor numero di token usati per il ragionamento in una risposta.

Proprietà	Value
Descrizione	Solo modelli di serie o Vincola il lavoro sul ragionamento per i modelli di ragionamento. I valori attualmente supportati sono `low`, `medium` e `high`. La riduzione del lavoro di ragionamento può tradursi in risposte più veloci e in un minor numero di token usati per il ragionamento in una risposta.
Tipo	corda
Valori	`low` `medium` `high`

OpenAI.ReasoningItemParam

Descrizione della catena di pensiero usata da un modello di ragionamento durante la generazione di una risposta. Assicurarsi di includere questi elementi nell'API input Risposte per i turni successivi di una conversazione se si gestisce manualmente il contesto.

Nome	TIPO	Descrzione	Obbligatorio
encrypted_content	corda	Contenuto crittografato dell'elemento di ragionamento, popolato quando viene generata una risposta con `reasoning.encrypted_content` nel `include` parametro .	NO
summary	array	Contenuti del testo di ragionamento.	Sì
type	enum	Valori possibili: `reasoning`	Sì

OpenAI.ReasoningItemResource

Nome	TIPO	Descrzione	Obbligatorio
encrypted_content	corda	Contenuto crittografato dell'elemento di ragionamento, popolato quando viene generata una risposta con `reasoning.encrypted_content` nel `include` parametro .	NO
summary	array	Contenuti del testo di ragionamento.	Sì
type	enum	Valori possibili: `reasoning`	Sì

OpenAI.ReasoningItemSummaryPart

Discriminante per OpenAI.ReasoningItemSummaryPart

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`summary_text`	OpenAI.ReasoningItemSummaryTextPart

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.ReasoningItemSummaryPartType		Sì

OpenAI.ReasoningItemSummaryPartType

Proprietà	Value
Tipo	corda
Valori	`summary_text`

OpenAI.ReasoningItemSummaryTextPart

Nome	TIPO	Descrzione	Obbligatorio	Default
Testo	corda		Sì
type	enum	Valori possibili: `summary_text`	Sì

OpenAI.Response

Nome	TIPO	Descrzione	Obbligatorio	Default
sfondo	boolean	Indica se eseguire la risposta del modello in background.	NO	Falso
creato_il	numero intero	Timestamp Unix (in secondi) di quando è stata creata questa risposta.	Sì
Errore	oggetto	Oggetto di errore restituito quando il modello non riesce a generare una risposta.	Sì
└─ codice	OpenAI.ResponseErrorCode	Codice di errore per la risposta.	NO
└* messaggio	corda	Descrizione leggibile dell'errore.	NO
id	corda	Identificatore univoco per questa risposta.	Sì
incomplete_details	oggetto	Informazioni dettagliate sul motivo per cui la risposta è incompleta.	Sì
└* motivo	enum	Motivo per cui la risposta è incompleta. Valori possibili: `max_output_tokens`, `content_filter`	NO
instructions	stringa o matrice		Sì
max_output_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per una risposta, inclusi token di output visibili e token di motivazione	NO
max_tool_calls	numero intero	Numero massimo di chiamate totali agli strumenti predefiniti che possono essere elaborati in una risposta. Questo numero massimo si applica a tutte le chiamate di strumenti predefinite, non a ogni singolo strumento. Eventuali altri tentativi di chiamare uno strumento da parte del modello verranno ignorati.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	Sì
oggetto	enum	Tipo di oggetto di questa risorsa: sempre impostato su `response`. Valori possibili: `response`	Sì
output	array	Matrice di elementi di contenuto generati dal modello. - La lunghezza e l'ordine degli elementi nella `output` matrice dipendono dalla risposta del modello. - Anziché accedere al primo elemento nella `output` matrice e presupponendo che si tratti di un `assistant` messaggio con il contenuto generato dal modello, è consigliabile usare la `output_text` proprietà in cui è supportato negli SDK.	Sì
output_text	corda	Proprietà utile solo SDK che contiene l'output di testo aggregato di tutti gli elementi `output_text` della matrice `output`, se presenti. Supportato negli SDK Python e JavaScript.	NO
chiamate_parallele_agli_strumenti	boolean	Indica se consentire al modello di eseguire chiamate degli strumenti in parallelo.	Sì	Vero
previous_response_id	corda	ID univoco della risposta precedente al modello. Usare questa opzione per creare conversazioni a più turni.	NO
prompt	oggetto	Riferimento a un modello di richiesta e alle relative variabili.	NO
└* id	corda	Identificatore univoco del modello di richiesta da utilizzare.	NO
** └─ Variabili	OpenAI.ResponsePromptVariables	Mappa facoltativa di valori da sostituire con le variabili nel prompt. I valori di sostituzione possono essere stringhe o altri tipi di input response, ad esempio immagini o file.	NO
└─ versione	corda	Versione facoltativa del modello di richiesta.	NO
reasoning	oggetto	Solo modelli di serie o Opzioni di configurazione per i modelli di ragionamento.	NO
└* sforzo	Sforzo di Ragionamento OpenAI	Solo modelli di serie o Vincola il lavoro sul ragionamento per i modelli di ragionamento. I valori attualmente supportati sono `low`, `medium` e `high`. La riduzione del lavoro di ragionamento può tradursi in risposte più veloci e in un minor numero di token usati per il ragionamento in una risposta.	NO
└─ genera_sommario	enum	Deprecato: usare `summary` invece. Riepilogo del ragionamento eseguito dal modello. Ciò può essere utile per eseguire il debug e comprendere il processo di ragionamento del modello. Uno tra `auto`, `concise` e `detailed`. Valori possibili: `auto`, `concise`, `detailed`	NO
└─ Riepilogo	enum	Riepilogo del ragionamento eseguito dal modello. Ciò può essere utile per eseguire il debug e comprendere il processo di ragionamento del modello. Uno tra `auto`, `concise` e `detailed`. Valori possibili: `auto`, `concise`, `detailed`	NO
stato	enum	Stato della generazione della risposta. Uno di `completed`, `failed`, `in_progresscancelled`, `queued`, o `incomplete`. Valori possibili: `completed`, `failedin_progress`, `cancelled`, , `queuedincomplete`	NO
temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	Sì
Testo	oggetto	Opzioni di configurazione per una risposta di testo dal modello. Può essere un testo normale o dati JSON strutturati.	NO
└* formato	OpenAI.ResponseTextFormatConfiguration		NO
tool_choice	oggetto	Controlla quale strumento (se presente) viene chiamato dal modello. `none` indica che il modello non chiamerà alcuno strumento e genera invece un messaggio. `auto` indica che il modello può scegliere tra la generazione di un messaggio o la chiamata di uno o più strumenti. `required` indica che il modello deve chiamare uno o più strumenti.	NO
└─ Tipo	OpenAI.ToolChoiceObjectType	Indica che il modello deve usare uno strumento predefinito per generare una risposta.	NO
strumenti	array	Una matrice di strumenti che il modello può chiamare durante la generazione di una risposta. È possibile specificare lo strumento da usare impostando il `tool_choice` parametro . Le due categorie di strumenti che è possibile fornire al modello sono: - Strumenti predefiniti: strumenti forniti da OpenAI che estendono le funzionalità del modello.	NO
top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	Sì
truncation	enum	Strategia di troncamento da usare per la risposta del modello. - `auto`: se il contesto di questa risposta e quelli precedenti supera le dimensioni della finestra di contesto del modello, il modello tronca la risposta per adattarsi alla finestra di contesto eliminando gli elementi di input al centro della conversazione. - `disabled` (impostazione predefinita): se una risposta del modello supererà le dimensioni della finestra di contesto per un modello, la richiesta avrà esito negativo con un errore 400. Valori possibili: `auto`, `disabled`	NO
usage	OpenAI.ResponseUsage	Rappresenta i dettagli di utilizzo dei token, inclusi i token di input, i token di output, la suddivisione dei token di output e i token totali usati.	NO
utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	Sì

OpenAI.ResponseCodeInterpreterCallCodeDeltaEvent

Generato quando un frammento di codice parziale viene trasmesso dall'interprete del codice.

Nome	TIPO	Descrzione	Obbligatorio
delta	corda	Frammento di codice parziale trasmesso dall'interprete di codice.	Sì
item_id	corda	Identificatore univoco dell'elemento di chiamata dello strumento dell'interprete di codice.	Sì
output_index	numero intero	Indice dell'elemento di output nella risposta per cui viene trasmesso il codice.	Sì
type	enum	Tipo di evento. Sempre `response.code_interpreter_call_code.delta`. Valori possibili: `response.code_interpreter_call_code.delta`	Sì

OpenAI.ResponseCodeInterpreterCallCodeDoneEvent

Generato quando il frammento di codice viene finalizzato dall'interprete del codice.

Nome	TIPO	Descrzione	Obbligatorio
codice	corda	Output finale del frammento di codice generato dall'interprete di codice.	Sì
item_id	corda	Identificatore univoco dell'elemento di chiamata dello strumento dell'interprete di codice.	Sì
output_index	numero intero	Indice dell'elemento di output nella risposta per cui viene finalizzato il codice.	Sì
type	enum	Tipo di evento. Sempre `response.code_interpreter_call_code.done`. Valori possibili: `response.code_interpreter_call_code.done`	Sì

OpenAI.ResponseCodeInterpreterCallCompletedEvent

Generato al termine della chiamata dell'interprete del codice.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	Identificatore univoco dell'elemento di chiamata dello strumento dell'interprete di codice.	Sì
output_index	numero intero	Indice dell'elemento di output nella risposta per cui viene completata la chiamata all'interprete di codice.	Sì
type	enum	Tipo di evento. Sempre `response.code_interpreter_call.completed`. Valori possibili: `response.code_interpreter_call.completed`	Sì

OpenAI.ResponseCodeInterpreterCallInProgressEvent

Generato quando è in corso una chiamata a un interprete di codice.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	Identificatore univoco dell'elemento di chiamata dello strumento dell'interprete di codice.	Sì
output_index	numero intero	Indice dell'elemento di output nella risposta per cui è in corso la chiamata dell'interprete di codice.	Sì
type	enum	Tipo di evento. Sempre `response.code_interpreter_call.in_progress`. Valori possibili: `response.code_interpreter_call.in_progress`	Sì

OpenAI.ResponseCodeInterpreterCallInterpretingEvent

Generato quando l'interprete di codice interpreta attivamente il frammento di codice.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	Identificatore univoco dell'elemento di chiamata dello strumento dell'interprete di codice.	Sì
output_index	numero intero	Indice dell'elemento di output nella risposta per cui l'interprete di codice interpreta il codice.	Sì
type	enum	Tipo di evento. Sempre `response.code_interpreter_call.interpreting`. Valori possibili: `response.code_interpreter_call.interpreting`	Sì

OpenAI.ResponseCompletedEvent

Generato al termine della risposta del modello.

Nome	TIPO	Descrzione	Obbligatorio	Default
response	oggetto		Sì
└* sfondo	boolean	Indica se eseguire la risposta del modello in background.	NO	Falso
└created_at	numero intero	Timestamp Unix (in secondi) di quando è stata creata questa risposta.	NO
└─ Errore	OpenAI.ResponseError	Oggetto di errore restituito quando il modello non riesce a generare una risposta.	NO
└* id	corda	Identificatore univoco per questa risposta.	NO
└dettagli_incompleti	oggetto	Informazioni dettagliate sul motivo per cui la risposta è incompleta.	NO
└* motivo	enum	Motivo per cui la risposta è incompleta. Valori possibili: `max_output_tokens`, `content_filter`	NO
└* istruzioni	stringa o matrice	Messaggio di sistema (o sviluppatore) inserito nel contesto del modello. Quando si usa insieme a `previous_response_id`, le istruzioni di una risposta precedente non saranno trasferite alla risposta successiva. In questo modo è semplice scambiare messaggi di sistema (o sviluppatore) in nuove risposte.	NO
└ max_output_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per una risposta, inclusi token di output visibili e token di motivazione	NO
└' max_tool_calls	numero intero	Numero massimo di chiamate totali agli strumenti predefiniti che possono essere elaborati in una risposta. Questo numero massimo si applica a tutte le chiamate di strumenti predefinite, non a ogni singolo strumento. Eventuali altri tentativi di chiamare uno strumento da parte del modello verranno ignorati.	NO
└─ metadati	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
└─ oggetto	enum	Tipo di oggetto di questa risorsa: sempre impostato su `response`. Valori possibili: `response`	NO
└─ uscita	array	Matrice di elementi di contenuto generati dal modello. - La lunghezza e l'ordine degli elementi nella `output` matrice dipendono dalla risposta del modello. - Anziché accedere al primo elemento nella `output` matrice e presupponendo che si tratti di un `assistant` messaggio con il contenuto generato dal modello, è consigliabile usare la `output_text` proprietà in cui è supportato negli SDK.	NO
└output_text	corda	Proprietà utile solo SDK che contiene l'output di testo aggregato di tutti gli elementi `output_text` della matrice `output`, se presenti. Supportato negli SDK Python e JavaScript.	NO
└parallel_tool_calls	boolean	Indica se consentire al modello di eseguire chiamate degli strumenti in parallelo.	NO	Vero
└─previous_response_id	corda	ID univoco della risposta precedente al modello. Usare questa opzione per creare conversazioni a più turni.	NO
└* prompt	OpenAI.Prompt	Riferimento a un modello di richiesta e alle relative variabili.	NO
└* ragionamento	OpenAI.Reasoning	Solo modelli di serie o Opzioni di configurazione per i modelli di ragionamento.	NO
└─ stato	enum	Stato della generazione della risposta. Uno di `completed`, `failed`, `in_progresscancelled`, `queued`, o `incomplete`. Valori possibili: `completed`, `failedin_progress`, `cancelled`, , `queuedincomplete`	NO
└* temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	NO
└─ testo	oggetto	Opzioni di configurazione per una risposta di testo dal modello. Può essere un testo normale o dati JSON strutturati.	NO
└* formato	OpenAI.ResponseTextFormatConfiguration		NO
└tool_choice	OpenAI.ToolChoiceOptions o OpenAI.ToolChoiceObject	Come il modello deve selezionare quale strumento (o strumenti) usare durante la generazione di una risposta. Vedere il `tools` parametro per informazioni su come specificare gli strumenti che il modello può chiamare.	NO
Strumenti └*	array	Una matrice di strumenti che il modello può chiamare durante la generazione di una risposta. È possibile specificare lo strumento da usare impostando il `tool_choice` parametro . Le due categorie di strumenti che è possibile fornire al modello sono: - Strumenti predefiniti: strumenti forniti da OpenAI che estendono le funzionalità del modello.	NO
└ top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
└top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	NO
└─ troncamento	enum	Strategia di troncamento da usare per la risposta del modello. - `auto`: se il contesto di questa risposta e quelli precedenti supera le dimensioni della finestra di contesto del modello, il modello tronca la risposta per adattarsi alla finestra di contesto eliminando gli elementi di input al centro della conversazione. - `disabled` (impostazione predefinita): se una risposta del modello supererà le dimensioni della finestra di contesto per un modello, la richiesta avrà esito negativo con un errore 400. Valori possibili: `auto`, `disabled`	NO
└─ utilizzo	OpenAI.ResponseUsage	Rappresenta i dettagli di utilizzo dei token, inclusi i token di input, i token di output, la suddivisione dei token di output e i token totali usati.	NO
└─ utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO
type	enum	Tipo di evento. Sempre `response.completed`. Valori possibili: `response.completed`	Sì

OpenAI.ResponseContentPartAddedEvent

Generato quando viene aggiunta una nuova parte di contenuto.

Nome	TIPO	Descrzione	Obbligatorio
content_index	numero intero	Indice della parte di contenuto aggiunta.	Sì
item_id	corda	ID dell'elemento di output a cui è stata aggiunta la parte di contenuto.	Sì
output_index	numero intero	Indice dell'elemento di output a cui è stata aggiunta la parte di contenuto.	Sì
part	oggetto		Sì
└─ Tipo	OpenAI.ItemContentType	Contenuti di input e output multimodali.	NO
type	enum	Tipo di evento. Sempre `response.content_part.added`. Valori possibili: `response.content_part.added`	Sì

OpenAI.ResponseContentPartDoneEvent

Generato al termine di una parte del contenuto.

Nome	TIPO	Descrzione	Obbligatorio
content_index	numero intero	Indice della parte di contenuto eseguita.	Sì
item_id	corda	ID dell'elemento di output a cui è stata aggiunta la parte di contenuto.	Sì
output_index	numero intero	Indice dell'elemento di output a cui è stata aggiunta la parte di contenuto.	Sì
part	oggetto		Sì
└─ Tipo	OpenAI.ItemContentType	Contenuti di input e output multimodali.	NO
type	enum	Tipo di evento. Sempre `response.content_part.done`. Valori possibili: `response.content_part.done`	Sì

OpenAI.ResponseCreatedEvent

Evento generato quando viene creata una risposta.

Nome	TIPO	Descrzione	Obbligatorio	Default
response	oggetto		Sì
└* sfondo	boolean	Indica se eseguire la risposta del modello in background.	NO	Falso
└created_at	numero intero	Timestamp Unix (in secondi) di quando è stata creata questa risposta.	NO
└─ Errore	OpenAI.ResponseError	Oggetto di errore restituito quando il modello non riesce a generare una risposta.	NO
└* id	corda	Identificatore univoco per questa risposta.	NO
└dettagli_incompleti	oggetto	Informazioni dettagliate sul motivo per cui la risposta è incompleta.	NO
└* motivo	enum	Motivo per cui la risposta è incompleta. Valori possibili: `max_output_tokens`, `content_filter`	NO
└* istruzioni	stringa o matrice	Messaggio di sistema (o sviluppatore) inserito nel contesto del modello. Quando si usa insieme a `previous_response_id`, le istruzioni di una risposta precedente non saranno trasferite alla risposta successiva. In questo modo è semplice scambiare messaggi di sistema (o sviluppatore) in nuove risposte.	NO
└ max_output_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per una risposta, inclusi token di output visibili e token di motivazione	NO
└' max_tool_calls	numero intero	Numero massimo di chiamate totali agli strumenti predefiniti che possono essere elaborati in una risposta. Questo numero massimo si applica a tutte le chiamate di strumenti predefinite, non a ogni singolo strumento. Eventuali altri tentativi di chiamare uno strumento da parte del modello verranno ignorati.	NO
└─ metadati	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
└─ oggetto	enum	Tipo di oggetto di questa risorsa: sempre impostato su `response`. Valori possibili: `response`	NO
└─ uscita	array	Matrice di elementi di contenuto generati dal modello. - La lunghezza e l'ordine degli elementi nella `output` matrice dipendono dalla risposta del modello. - Anziché accedere al primo elemento nella `output` matrice e presupponendo che si tratti di un `assistant` messaggio con il contenuto generato dal modello, è consigliabile usare la `output_text` proprietà in cui è supportato negli SDK.	NO
└output_text	corda	Proprietà utile solo SDK che contiene l'output di testo aggregato di tutti gli elementi `output_text` della matrice `output`, se presenti. Supportato negli SDK Python e JavaScript.	NO
└parallel_tool_calls	boolean	Indica se consentire al modello di eseguire chiamate degli strumenti in parallelo.	NO	Vero
└─previous_response_id	corda	ID univoco della risposta precedente al modello. Usare questa opzione per creare conversazioni a più turni.	NO
└* prompt	OpenAI.Prompt	Riferimento a un modello di richiesta e alle relative variabili.	NO
└* ragionamento	OpenAI.Reasoning	Solo modelli di serie o Opzioni di configurazione per i modelli di ragionamento.	NO
└─ stato	enum	Stato della generazione della risposta. Uno di `completed`, `failed`, `in_progress`, `cancelled`, `queued`, o `incomplete`. Valori possibili: `completed`, `failedin_progress`, `cancelled`, , `queuedincomplete`	NO
└* temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	NO
└─ testo	oggetto	Opzioni di configurazione per una risposta di testo dal modello. Può essere un testo normale o dati JSON strutturati.	NO
└* formato	OpenAI.ResponseTextFormatConfiguration		NO
└tool_choice	OpenAI.ToolChoiceOptions o OpenAI.ToolChoiceObject	Come il modello deve selezionare quale strumento (o strumenti) usare durante la generazione di una risposta. Vedere il `tools` parametro per informazioni su come specificare gli strumenti che il modello può chiamare.	NO
Strumenti └*	array	Una matrice di strumenti che il modello può chiamare durante la generazione di una risposta. È possibile specificare lo strumento da usare impostando il `tool_choice` parametro . Le due categorie di strumenti che è possibile fornire al modello sono: - Strumenti predefiniti: strumenti forniti da OpenAI che estendono le funzionalità del modello.	NO
└ top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
└top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	NO
└─ troncamento	enum	Strategia di troncamento da usare per la risposta del modello. - `auto`: se il contesto di questa risposta e quelli precedenti supera le dimensioni della finestra di contesto del modello, il modello tronca la risposta per adattarsi alla finestra di contesto eliminando gli elementi di input al centro della conversazione. - `disabled` (impostazione predefinita): se una risposta del modello supererà le dimensioni della finestra di contesto per un modello, la richiesta avrà esito negativo con un errore 400. Valori possibili: `auto`, `disabled`	NO
└─ utilizzo	OpenAI.ResponseUsage	Rappresenta i dettagli di utilizzo dei token, inclusi i token di input, i token di output, la suddivisione dei token di output e i token totali usati.	NO
└─ utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO
type	enum	Tipo di evento. Sempre `response.created`. Valori possibili: `response.created`	Sì

OpenAI.ResponseError

Oggetto di errore restituito quando il modello non riesce a generare una risposta.

Nome	TIPO	Descrzione	Obbligatorio	Default
codice	OpenAI.ResponseErrorCode	Codice di errore per la risposta.	Sì
message	corda	Descrizione leggibile dell'errore.	Sì

OpenAI.ResponseErrorCode

Codice di errore per la risposta.

Proprietà	Value
Descrizione	Codice di errore per la risposta.
Tipo	corda
Valori	`server_error` `rate_limit_exceeded` `invalid_prompt` `vector_store_timeout` `invalid_image` `invalid_image_format` `invalid_base64_image` `invalid_image_url` `image_too_large` `image_too_small` `image_parse_error` `image_content_policy_violation` `invalid_image_mode` `image_file_too_large` `unsupported_image_media_type` `empty_image_file` `failed_to_download_image` `image_file_not_found`

OpenAI.ResponseErrorEvent

Generato quando si verifica un errore.

Nome	TIPO	Descrzione	Obbligatorio
codice	corda	Codice di errore.	Sì
message	corda	Messaggio di errore.	Sì
param	corda	Parametro di errore.	Sì
type	enum	Tipo di evento. Sempre `error`. Valori possibili: `error`	Sì

OpenAI.ResponseFailedEvent

Evento generato quando una risposta ha esito negativo.

Nome	TIPO	Descrzione	Obbligatorio	Default
response	oggetto		Sì
└* sfondo	boolean	Indica se eseguire la risposta del modello in background.	NO	Falso
└created_at	numero intero	Timestamp Unix (in secondi) di quando è stata creata questa risposta.	NO
└─ Errore	OpenAI.ResponseError	Oggetto di errore restituito quando il modello non riesce a generare una risposta.	NO
└* id	corda	Identificatore univoco per questa risposta.	NO
└dettagli_incompleti	oggetto	Informazioni dettagliate sul motivo per cui la risposta è incompleta.	NO
└* motivo	enum	Motivo per cui la risposta è incompleta. Valori possibili: `max_output_tokens`, `content_filter`	NO
└* istruzioni	stringa o matrice	Messaggio di sistema (o sviluppatore) inserito nel contesto del modello. Quando si usa insieme a `previous_response_id`, le istruzioni di una risposta precedente non saranno trasferite alla risposta successiva. In questo modo è semplice scambiare messaggi di sistema (o sviluppatore) in nuove risposte.	NO
└ max_output_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per una risposta, inclusi token di output visibili e token di motivazione	NO
└' max_tool_calls	numero intero	Numero massimo di chiamate totali agli strumenti predefiniti che possono essere elaborati in una risposta. Questo numero massimo si applica a tutte le chiamate di strumenti predefinite, non a ogni singolo strumento. Eventuali altri tentativi di chiamare uno strumento da parte del modello verranno ignorati.	NO
└─ metadati	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
└─ oggetto	enum	Tipo di oggetto di questa risorsa: sempre impostato su `response`. Valori possibili: `response`	NO
└─ uscita	array	Matrice di elementi di contenuto generati dal modello. - La lunghezza e l'ordine degli elementi nella `output` matrice dipendono dalla risposta del modello. - Anziché accedere al primo elemento nella `output` matrice e presupponendo che si tratti di un `assistant` messaggio con il contenuto generato dal modello, è consigliabile usare la `output_text` proprietà in cui è supportato negli SDK.	NO
└output_text	corda	Proprietà utile solo SDK che contiene l'output di testo aggregato di tutti gli elementi `output_text` della matrice `output`, se presenti. Supportato negli SDK Python e JavaScript.	NO
└parallel_tool_calls	boolean	Indica se consentire al modello di eseguire chiamate degli strumenti in parallelo.	NO	Vero
└─previous_response_id	corda	ID univoco della risposta precedente al modello. Usare questa opzione per creare conversazioni a più turni.	NO
└* prompt	OpenAI.Prompt	Riferimento a un modello di richiesta e alle relative variabili.	NO
└* ragionamento	OpenAI.Reasoning	Solo modelli di serie o Opzioni di configurazione per i modelli di ragionamento.	NO
└─ stato	enum	Stato della generazione della risposta. Uno di `completed`, `failed`, `in_progresscancelled`, `queued`, o `incomplete`. Valori possibili: `completed`, `failedin_progress`, `cancelled`, , `queuedincomplete`	NO
└* temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	NO
└─ testo	oggetto	Opzioni di configurazione per una risposta di testo dal modello. Può essere un testo normale o dati JSON strutturati.	NO
└* formato	OpenAI.ResponseTextFormatConfiguration		NO
└tool_choice	OpenAI.ToolChoiceOptions o OpenAI.ToolChoiceObject	Come il modello deve selezionare quale strumento (o strumenti) usare durante la generazione di una risposta. Vedere il `tools` parametro per informazioni su come specificare gli strumenti che il modello può chiamare.	NO
Strumenti └*	array	Una matrice di strumenti che il modello può chiamare durante la generazione di una risposta. È possibile specificare lo strumento da usare impostando il `tool_choice` parametro . Le due categorie di strumenti che è possibile fornire al modello sono: - Strumenti predefiniti: strumenti forniti da OpenAI che estendono le funzionalità del modello.	NO
└ top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
└top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	NO
└─ troncamento	enum	Strategia di troncamento da usare per la risposta del modello. - `auto`: se il contesto di questa risposta e quelli precedenti supera le dimensioni della finestra di contesto del modello, il modello tronca la risposta per adattarsi alla finestra di contesto eliminando gli elementi di input al centro della conversazione. - `disabled` (impostazione predefinita): se una risposta del modello supererà le dimensioni della finestra di contesto per un modello, la richiesta avrà esito negativo con un errore 400. Valori possibili: `auto`, `disabled`	NO
└─ utilizzo	OpenAI.ResponseUsage	Rappresenta i dettagli di utilizzo dei token, inclusi i token di input, i token di output, la suddivisione dei token di output e i token totali usati.	NO
└─ utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO
type	enum	Tipo di evento. Sempre `response.failed`. Valori possibili: `response.failed`	Sì

OpenAI.ResponseFileSearchCallCompletedEvent

Generato quando viene completata una chiamata di ricerca file (risultati trovati).

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	ID dell'elemento di output avviato dalla chiamata di ricerca file.	Sì
output_index	numero intero	Indice dell'elemento di output avviato dalla chiamata di ricerca file.	Sì
type	enum	Tipo di evento. Sempre `response.file_search_call.completed`. Valori possibili: `response.file_search_call.completed`	Sì

OpenAI.ResponseFileSearchCallInProgressEvent

Generato quando viene avviata una chiamata di ricerca file.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	ID dell'elemento di output avviato dalla chiamata di ricerca file.	Sì
output_index	numero intero	Indice dell'elemento di output avviato dalla chiamata di ricerca file.	Sì
type	enum	Tipo di evento. Sempre `response.file_search_call.in_progress`. Valori possibili: `response.file_search_call.in_progress`	Sì

OpenAI.ResponseFileSearchCallSearchingEvent

Generato quando una ricerca di file è attualmente in corso.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	ID dell'elemento di output avviato dalla chiamata di ricerca file.	Sì
output_index	numero intero	L'indice dell'elemento di output che la chiamata di ricerca file sta cercando.	Sì
type	enum	Tipo di evento. Sempre `response.file_search_call.searching`. Valori possibili: `response.file_search_call.searching`	Sì

OpenAI.ResponseFormat

Discriminare per OpenAI.ResponseFormat

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`text`	OpenAI.ResponseFormatText
`json_object`	OpenAI.ResponseFormatJsonObject
`json_schema`	OpenAI.ResponseFormatJsonSchema

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `text`, `json_object`, `json_schema`	Sì

OpenAI.ResponseFormatJsonObject

Formato della risposta dell'oggetto JSON. Metodo precedente di generazione di risposte JSON. Si consiglia di utilizzare json_schema per i modelli che lo supportano. Si noti che il modello non genererà JSON senza un messaggio di sistema o utente che indica to do.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Tipo di formato di risposta definito. Sempre `json_object`. Valori possibili: `json_object`	Sì

OpenAI.ResponseFormatJsonSchema

Formato di risposta dello schema JSON. Usato per generare risposte JSON strutturate.

Nome	TIPO	Descrzione	Obbligatorio	Default
json_schema	oggetto	Opzioni di configurazione degli output strutturati, incluso uno schema JSON.	Sì
└* descrizione	corda	Descrizione del formato di risposta, usato dal modello per determinare come rispondere nel formato.	NO
└> nome	corda	Nome del formato della risposta. Deve essere a-z, A-Z, 0-9 o contenere caratteri di sottolineatura e trattini, con una lunghezza massima di 64 caratteri.	NO
└─ Schema	OpenAI.ResponseFormatJsonSchemaSchema	Schema per il formato di risposta, descritto come oggetto Schema JSON. Informazioni su come creare schemi JSON qui.	NO
└─ rigoroso	boolean	Indica se abilitare una rigorosa conformità allo schema durante la generazione dell'output. Se impostato su true, il modello seguirà sempre lo schema esatto definito nel campo `schema`. Solo un subset di schema JSON è supportato quando `strict` è `true`.	NO	Falso
type	enum	Tipo di formato di risposta definito. Sempre `json_schema`. Valori possibili: `json_schema`	Sì

OpenAI.ResponseFormatJsonSchemaSchema

Schema per il formato di risposta, descritto come oggetto Schema JSON. Informazioni su come creare schemi JSON qui.

Tipo: oggetto

OpenAI.ResponseFormatText

Formato di risposta predefinito. Usato per generare risposte di testo.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Tipo di formato di risposta definito. Sempre `text`. Valori possibili: `text`	Sì

OpenAI.ResponseFunctionCallArgumentsDeltaEvent

Generato quando è presente un delta degli argomenti di chiamata di funzione parziale.

Nome	TIPO	Descrzione	Obbligatorio
delta	corda	Delta degli argomenti di chiamata di funzione aggiunto.	Sì
item_id	corda	ID dell'elemento di output a cui viene aggiunto il delta degli argomenti di chiamata di funzione.	Sì
output_index	numero intero	Indice dell'elemento di output a cui viene aggiunto il delta degli argomenti di chiamata di funzione.	Sì
type	enum	Tipo di evento. Sempre `response.function_call_arguments.delta`. Valori possibili: `response.function_call_arguments.delta`	Sì

OpenAI.ResponseFunctionCallArgumentsDoneEvent

Generato quando gli argomenti della chiamata di funzione vengono finalizzati.

Nome	TIPO	Descrzione	Obbligatorio
arguments	corda	Argomenti di chiamata di funzione.	Sì
item_id	corda	ID dell'elemento.	Sì
output_index	numero intero	Indice dell'elemento di output.	Sì
type	enum	Valori possibili: `response.function_call_arguments.done`	Sì

OpenAI.ResponseImageGenCallCompletedEvent

Generato quando una chiamata dello strumento di generazione di immagini è stata completata e l'immagine finale è disponibile.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	Identificatore univoco dell'elemento di generazione dell'immagine in fase di elaborazione.	Sì
output_index	numero intero	Indice dell'elemento di output nella matrice di output della risposta.	Sì
type	enum	Tipo di evento. Sempre «response.image_generation_call.completed». Valori possibili: `response.image_generation_call.completed`	Sì

OpenAI.ResponseImageGenCallGeneratingEvent

Generato quando una chiamata dello strumento di generazione di immagini genera attivamente un'immagine (stato intermedio).

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	Identificatore univoco dell'elemento di generazione dell'immagine in fase di elaborazione.	Sì
output_index	numero intero	Indice dell'elemento di output nella matrice di output della risposta.	Sì
type	enum	Tipo di evento. Sempre "response.image_generation_call.generating". Valori possibili: `response.image_generation_call.generating`	Sì

OpenAI.ResponseImageGenCallInProgressEvent

Generato quando è in corso una chiamata dello strumento di generazione di immagini.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	Identificatore univoco dell'elemento di generazione dell'immagine in fase di elaborazione.	Sì
output_index	numero intero	Indice dell'elemento di output nella matrice di output della risposta.	Sì
type	enum	Tipo di evento. Sempre 'response.image_generation_call.in_progress'. Valori possibili: `response.image_generation_call.in_progress`	Sì

OpenAI.ResponseImageGenCallPartialImageEvent

Generato quando un'immagine parziale è disponibile durante il flusso di generazione di immagini.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	Identificatore univoco dell'elemento di generazione dell'immagine in fase di elaborazione.	Sì
output_index	numero intero	Indice dell'elemento di output nella matrice di output della risposta.	Sì
partial_image_b64	corda	Dati di immagine parziali codificati in Base64, adatti per il rendering come immagine.	Sì
partial_image_index	numero intero	Indice in base 0 per l'immagine parziale (il back-end è basato su 1, ma questo è basato su 0 per l'utente).	Sì
type	enum	Tipo di evento. Sempre 'response.image_generation_call.partial_image'. Valori possibili: `response.image_generation_call.partial_image`	Sì

OpenAI.ResponseInProgressEvent

Generato quando la risposta è in corso.

Nome	TIPO	Descrzione	Obbligatorio	Default
response	oggetto		Sì
└* sfondo	boolean	Indica se eseguire la risposta del modello in background.	NO	Falso
└created_at	numero intero	Timestamp Unix (in secondi) di quando è stata creata questa risposta.	NO
└─ Errore	OpenAI.ResponseError	Oggetto di errore restituito quando il modello non riesce a generare una risposta.	NO
└* id	corda	Identificatore univoco per questa risposta.	NO
└dettagli_incompleti	oggetto	Informazioni dettagliate sul motivo per cui la risposta è incompleta.	NO
└* motivo	enum	Motivo per cui la risposta è incompleta. Valori possibili: `max_output_tokens`, `content_filter`	NO
└* istruzioni	stringa o matrice	Messaggio di sistema (o sviluppatore) inserito nel contesto del modello. Quando si usa insieme a `previous_response_id`, le istruzioni di una risposta precedente non saranno trasferite alla risposta successiva. In questo modo è semplice scambiare messaggi di sistema (o sviluppatore) in nuove risposte.	NO
└ max_output_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per una risposta, inclusi token di output visibili e token di motivazione	NO
└' max_tool_calls	numero intero	Numero massimo di chiamate totali agli strumenti predefiniti che possono essere elaborati in una risposta. Questo numero massimo si applica a tutte le chiamate di strumenti predefinite, non a ogni singolo strumento. Eventuali altri tentativi di chiamare uno strumento da parte del modello verranno ignorati.	NO
└─ metadati	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
└─ oggetto	enum	Tipo di oggetto di questa risorsa: sempre impostato su `response`. Valori possibili: `response`	NO
└─ uscita	array	Matrice di elementi di contenuto generati dal modello. - La lunghezza e l'ordine degli elementi nella `output` matrice dipendono dalla risposta del modello. - Anziché accedere al primo elemento nella `output` matrice e presupponendo che si tratti di un `assistant` messaggio con il contenuto generato dal modello, è consigliabile usare la `output_text` proprietà in cui è supportato negli SDK.	NO
└output_text	corda	Proprietà utile solo SDK che contiene l'output di testo aggregato di tutti gli elementi `output_text` della matrice `output`, se presenti. Supportato negli SDK Python e JavaScript.	NO
└parallel_tool_calls	boolean	Indica se consentire al modello di eseguire chiamate degli strumenti in parallelo.	NO	Vero
└─previous_response_id	corda	ID univoco della risposta precedente al modello. Usare questa opzione per creare conversazioni a più turni.	NO
└* prompt	OpenAI.Prompt	Riferimento a un modello di richiesta e alle relative variabili.	NO
└* ragionamento	OpenAI.Reasoning	Solo modelli di serie o Opzioni di configurazione per i modelli di ragionamento.	NO
└─ stato	enum	Stato della generazione della risposta. Uno di `completed`, `failed`, `in_progresscancelled`, `queued`, o `incomplete`. Valori possibili: `completed`, `failedin_progress`, `cancelled`, , `queuedincomplete`	NO
└* temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	NO
└─ testo	oggetto	Opzioni di configurazione per una risposta di testo dal modello. Può essere un testo normale o dati JSON strutturati.	NO
└* formato	OpenAI.ResponseTextFormatConfiguration		NO
└tool_choice	OpenAI.ToolChoiceOptions o OpenAI.ToolChoiceObject	Come il modello deve selezionare quale strumento (o strumenti) usare durante la generazione di una risposta. Vedere il `tools` parametro per informazioni su come specificare gli strumenti che il modello può chiamare.	NO
Strumenti └*	array	Una matrice di strumenti che il modello può chiamare durante la generazione di una risposta. È possibile specificare lo strumento da usare impostando il `tool_choice` parametro . Le due categorie di strumenti che è possibile fornire al modello sono: - Strumenti predefiniti: strumenti forniti da OpenAI che estendono le funzionalità del modello.	NO
└ top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
└top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	NO
└─ troncamento	enum	Strategia di troncamento da usare per la risposta del modello. - `auto`: se il contesto di questa risposta e quelli precedenti supera le dimensioni della finestra di contesto del modello, il modello tronca la risposta per adattarsi alla finestra di contesto eliminando gli elementi di input al centro della conversazione. - `disabled` (impostazione predefinita): se una risposta del modello supererà le dimensioni della finestra di contesto per un modello, la richiesta avrà esito negativo con un errore 400. Valori possibili: `auto`, `disabled`	NO
└─ utilizzo	OpenAI.ResponseUsage	Rappresenta i dettagli di utilizzo dei token, inclusi i token di input, i token di output, la suddivisione dei token di output e i token totali usati.	NO
└─ utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO
type	enum	Tipo di evento. Sempre `response.in_progress`. Valori possibili: `response.in_progress`	Sì

OpenAI.ResponseIncompleteEvent

L'evento che viene emesso quando una risposta si conclude come incompleta.

Nome	TIPO	Descrzione	Obbligatorio	Default
response	oggetto		Sì
└* sfondo	boolean	Indica se eseguire la risposta del modello in background.	NO	Falso
└created_at	numero intero	Timestamp Unix (in secondi) di quando è stata creata questa risposta.	NO
└─ Errore	OpenAI.ResponseError	Oggetto di errore restituito quando il modello non riesce a generare una risposta.	NO
└* id	corda	Identificatore univoco per questa risposta.	NO
└dettagli_incompleti	oggetto	Informazioni dettagliate sul motivo per cui la risposta è incompleta.	NO
└* motivo	enum	Motivo per cui la risposta è incompleta. Valori possibili: `max_output_tokens`, `content_filter`	NO
└* istruzioni	stringa o matrice	Messaggio di sistema (o sviluppatore) inserito nel contesto del modello. Quando si usa insieme a `previous_response_id`, le istruzioni di una risposta precedente non saranno trasferite alla risposta successiva. In questo modo è semplice scambiare messaggi di sistema (o sviluppatore) in nuove risposte.	NO
└ max_output_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per una risposta, inclusi token di output visibili e token di motivazione	NO
└' max_tool_calls	numero intero	Numero massimo di chiamate totali agli strumenti predefiniti che possono essere elaborati in una risposta. Questo numero massimo si applica a tutte le chiamate di strumenti predefinite, non a ogni singolo strumento. Eventuali altri tentativi di chiamare uno strumento da parte del modello verranno ignorati.	NO
└─ metadati	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
└─ oggetto	enum	Tipo di oggetto di questa risorsa: sempre impostato su `response`. Valori possibili: `response`	NO
└─ uscita	array	Matrice di elementi di contenuto generati dal modello. - La lunghezza e l'ordine degli elementi nella `output` matrice dipendono dalla risposta del modello. - Anziché accedere al primo elemento nella `output` matrice e presupponendo che si tratti di un `assistant` messaggio con il contenuto generato dal modello, è consigliabile usare la `output_text` proprietà in cui è supportato negli SDK.	NO
└output_text	corda	Proprietà utile solo SDK che contiene l'output di testo aggregato di tutti gli elementi `output_text` della matrice `output`, se presenti. Supportato negli SDK Python e JavaScript.	NO
└parallel_tool_calls	boolean	Indica se consentire al modello di eseguire chiamate degli strumenti in parallelo.	NO	Vero
└─previous_response_id	corda	ID univoco della risposta precedente al modello. Usare questa opzione per creare conversazioni a più turni.	NO
└* prompt	OpenAI.Prompt	Riferimento a un modello di richiesta e alle relative variabili.	NO
└* ragionamento	OpenAI.Reasoning	Solo modelli di serie o Opzioni di configurazione per i modelli di ragionamento.	NO
└─ stato	enum	Stato della generazione della risposta. Uno di `completed`, `failed`, `in_progresscancelled`, `queued`, o `incomplete`. Valori possibili: `completed`, `failedin_progress`, `cancelled`, , `queuedincomplete`	NO
└* temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	NO
└─ testo	oggetto	Opzioni di configurazione per una risposta di testo dal modello. Può essere un testo normale o dati JSON strutturati.	NO
└* formato	OpenAI.ResponseTextFormatConfiguration		NO
└tool_choice	OpenAI.ToolChoiceOptions o OpenAI.ToolChoiceObject	Come il modello deve selezionare quale strumento (o strumenti) usare durante la generazione di una risposta. Vedere il `tools` parametro per informazioni su come specificare gli strumenti che il modello può chiamare.	NO
Strumenti └*	array	Una matrice di strumenti che il modello può chiamare durante la generazione di una risposta. È possibile specificare lo strumento da usare impostando il `tool_choice` parametro . Le due categorie di strumenti che è possibile fornire al modello sono: - Strumenti predefiniti: strumenti forniti da OpenAI che estendono le funzionalità del modello.	NO
└ top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
└top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	NO
└─ troncamento	enum	Strategia di troncamento da usare per la risposta del modello. - `auto`: se il contesto di questa risposta e quelli precedenti supera le dimensioni della finestra di contesto del modello, il modello tronca la risposta per adattarsi alla finestra di contesto eliminando gli elementi di input al centro della conversazione. - `disabled` (impostazione predefinita): se una risposta del modello supererà le dimensioni della finestra di contesto per un modello, la richiesta avrà esito negativo con un errore 400. Valori possibili: `auto`, `disabled`	NO
└─ utilizzo	OpenAI.ResponseUsage	Rappresenta i dettagli di utilizzo dei token, inclusi i token di input, i token di output, la suddivisione dei token di output e i token totali usati.	NO
└─ utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO
type	enum	Tipo di evento. Sempre `response.incomplete`. Valori possibili: `response.incomplete`	Sì

OpenAI.ResponseItemList

Elenco di elementi di risposta.

Nome	TIPO	Descrzione	Obbligatorio
data	array	Elenco di elementi utilizzati per generare questa risposta.	Sì
first_id	corda	ID del primo elemento dell'elenco.	Sì
ha_di_piu	boolean	Indica se sono disponibili altri elementi.	Sì
last_id	corda	ID dell'ultimo elemento nell'elenco.	Sì
oggetto	enum	Il tipo di oggetto restituito deve essere `list`. Valori possibili: `list`	Sì

OpenAI.ResponseMCPCallArgumentsDeltaEvent

Generato quando è presente un delta (aggiornamento parziale) agli argomenti di una chiamata allo strumento MCP.

Nome	TIPO	Descrzione	Obbligatorio
delta		Aggiornamento parziale degli argomenti per la chiamata allo strumento MCP.	Sì
item_id	corda	Identificatore univoco dell'elemento di chiamata dello strumento MCP in fase di elaborazione.	Sì
output_index	numero intero	Indice dell'elemento di output nella matrice di output della risposta.	Sì
type	enum	Tipo di evento. Sempre 'response.mcp_call.arguments_delta'. Valori possibili: `response.mcp_call.arguments_delta`	Sì

OpenAI.ResponseMCPCallArgumentsDoneEvent

Generato quando gli argomenti per una chiamata allo strumento MCP vengono finalizzati.

Nome	TIPO	Descrzione	Obbligatorio
arguments		Argomenti finali per la chiamata allo strumento MCP.	Sì
item_id	corda	Identificatore univoco dell'elemento di chiamata dello strumento MCP in fase di elaborazione.	Sì
output_index	numero intero	Indice dell'elemento di output nella matrice di output della risposta.	Sì
type	enum	Tipo di evento. Sempre 'response.mcp_call.arguments_done'. Valori possibili: `response.mcp_call.arguments_done`	Sì

OpenAI.ResponseMCPCallCompletedEvent

Generato quando una chiamata allo strumento MCP è stata completata correttamente.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Tipo di evento. Sempre "response.mcp_call.completed". Valori possibili: `response.mcp_call.completed`	Sì

OpenAI.ResponseMCPCallFailedEvent

Generato quando una chiamata allo strumento MCP non è riuscita.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Tipo di evento. Lasciare invariato 'response.mcp_call.failed'. Valori possibili: `response.mcp_call.failed`	Sì

OpenAI.ResponseMCPCallInProgressEvent

Generato quando è in corso una chiamata allo strumento MCP.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	Identificatore univoco dell'elemento di chiamata dello strumento MCP in fase di elaborazione.	Sì
output_index	numero intero	Indice dell'elemento di output nella matrice di output della risposta.	Sì
type	enum	Tipo di evento. Sempre 'response.mcp_call.in_progress'. Valori possibili: `response.mcp_call.in_progress`	Sì

OpenAI.ResponseMCPListToolsCompletedEvent

Generato quando l'elenco degli strumenti MCP disponibili è stato recuperato correttamente.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Tipo di evento. Sempre "response.mcp_list_tools.completed". Valori possibili: `response.mcp_list_tools.completed`	Sì

OpenAI.ResponseMCPListToolsFailedEvent

Generato quando il tentativo di elencare gli strumenti MCP disponibili non è riuscito.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Tipo di evento. Sempre 'response.mcp_list_tools.failed'. Valori possibili: `response.mcp_list_tools.failed`	Sì

OpenAI.ResponseMCPListToolsInProgressEvent

Generato quando il sistema è in corso di recupero dell'elenco degli strumenti MCP disponibili.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Tipo di evento. Sempre 'response.mcp_list_tools.in_progress'. Valori possibili: `response.mcp_list_tools.in_progress`	Sì

OpenAI.ResponseOutputItemAddedEvent

Generato quando viene aggiunto un nuovo elemento di output.

Nome	TIPO	Descrzione	Obbligatorio
oggetto	oggetto	Elemento di contenuto usato per generare una risposta.	Sì
└* id	corda		NO
└─ Tipo	OpenAI.ItemType		NO
output_index	numero intero	Indice dell'elemento di output aggiunto.	Sì
type	enum	Tipo di evento. Sempre `response.output_item.added`. Valori possibili: `response.output_item.added`	Sì

OpenAI.ResponseOutputItemDoneEvent

Generato quando un elemento di output viene contrassegnato come completato.

Nome	TIPO	Descrzione	Obbligatorio
oggetto	oggetto	Elemento di contenuto usato per generare una risposta.	Sì
└* id	corda		NO
└─ Tipo	OpenAI.ItemType		NO
output_index	numero intero	Indice dell'elemento di output contrassegnato come completato.	Sì
type	enum	Tipo di evento. Sempre `response.output_item.done`. Valori possibili: `response.output_item.done`	Sì

OpenAI.ResponsePromptVariables

Mappa facoltativa di valori da sostituire con le variabili nel prompt. I valori di sostituzione possono essere stringhe o altri tipi di input response, ad esempio immagini o file.

Tipo: oggetto

OpenAI.ResponseQueuedEvent

Generato quando una risposta viene accodata e in attesa di essere elaborata.

Nome	TIPO	Descrzione	Obbligatorio	Default
response	oggetto		Sì
└* sfondo	boolean	Indica se eseguire la risposta del modello in background.	NO	Falso
└created_at	numero intero	Timestamp Unix (in secondi) di quando è stata creata questa risposta.	NO
└─ Errore	OpenAI.ResponseError	Oggetto di errore restituito quando il modello non riesce a generare una risposta.	NO
└* id	corda	Identificatore univoco per questa risposta.	NO
└dettagli_incompleti	oggetto	Informazioni dettagliate sul motivo per cui la risposta è incompleta.	NO
└* motivo	enum	Motivo per cui la risposta è incompleta. Valori possibili: `max_output_tokens`, `content_filter`	NO
└* istruzioni	stringa o matrice	Messaggio di sistema (o sviluppatore) inserito nel contesto del modello. Quando si usa insieme a `previous_response_id`, le istruzioni di una risposta precedente non saranno trasferite alla risposta successiva. In questo modo è semplice scambiare messaggi di sistema (o sviluppatore) in nuove risposte.	NO
└ max_output_tokens	numero intero	Limite superiore per il numero di token che possono essere generati per una risposta, inclusi token di output visibili e token di motivazione	NO
└' max_tool_calls	numero intero	Numero massimo di chiamate totali agli strumenti predefiniti che possono essere elaborati in una risposta. Questo numero massimo si applica a tutte le chiamate di strumenti predefinite, non a ogni singolo strumento. Eventuali altri tentativi di chiamare uno strumento da parte del modello verranno ignorati.	NO
└─ metadati	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
└─ oggetto	enum	Tipo di oggetto di questa risorsa: sempre impostato su `response`. Valori possibili: `response`	NO
└─ uscita	array	Matrice di elementi di contenuto generati dal modello. - La lunghezza e l'ordine degli elementi nella `output` matrice dipendono dalla risposta del modello. - Anziché accedere al primo elemento nella `output` matrice e presupponendo che si tratti di un `assistant` messaggio con il contenuto generato dal modello, è consigliabile usare la `output_text` proprietà in cui è supportato negli SDK.	NO
└output_text	corda	Proprietà utile solo SDK che contiene l'output di testo aggregato di tutti gli elementi `output_text` della matrice `output`, se presenti. Supportato negli SDK Python e JavaScript.	NO
└parallel_tool_calls	boolean	Indica se consentire al modello di eseguire chiamate degli strumenti in parallelo.	NO	Vero
└─previous_response_id	corda	ID univoco della risposta precedente al modello. Usare questa opzione per creare conversazioni a più turni.	NO
└* prompt	OpenAI.Prompt	Riferimento a un modello di richiesta e alle relative variabili.	NO
└* ragionamento	OpenAI.Reasoning	Solo modelli di serie o Opzioni di configurazione per i modelli di ragionamento.	NO
└─ stato	enum	Stato della generazione della risposta. Uno di `completed`, `failed`, `in_progresscancelled`, `queued`, o `incomplete`. Valori possibili: `completed`, `failedin_progress`, `cancelled`, , `queuedincomplete`	NO
└* temperatura	numero	Temperatura di campionamento da usare, compresa tra 0 e 2. Valori più elevati come 0.8 renderanno l'output più casuale, mentre valori più bassi come 0.2 lo renderanno più mirato e deterministico. In genere si consiglia di modificare questo valore o `top_p` ma non entrambi.	NO
└─ testo	oggetto	Opzioni di configurazione per una risposta di testo dal modello. Può essere un testo normale o dati JSON strutturati.	NO
└* formato	OpenAI.ResponseTextFormatConfiguration		NO
└tool_choice	OpenAI.ToolChoiceOptions o OpenAI.ToolChoiceObject	Come il modello deve selezionare quale strumento (o strumenti) usare durante la generazione di una risposta. Vedere il `tools` parametro per informazioni su come specificare gli strumenti che il modello può chiamare.	NO
Strumenti └*	array	Una matrice di strumenti che il modello può chiamare durante la generazione di una risposta. È possibile specificare lo strumento da usare impostando il `tool_choice` parametro . Le due categorie di strumenti che è possibile fornire al modello sono: - Strumenti predefiniti: strumenti forniti da OpenAI che estendono le funzionalità del modello.	NO
└ top_logprobs	numero intero	Un numero intero compreso tra 0 e 20 che specifica il numero di token più probabili da restituire in ogni posizione del token, ognuno con una probabilità di log associata.	NO
└top_p	numero	Un'alternativa al campionamento con temperatura, denominata campionamento del nucleo, in cui il modello considera i risultati dei token con massa di probabilità top_p. Quindi 0,1 significa che vengono considerati solo i token che comprendono la massa di probabilità superiore del 10%. In genere si consiglia di modificare questo valore o `temperature` ma non entrambi.	NO
└─ troncamento	enum	Strategia di troncamento da usare per la risposta del modello. - `auto`: se il contesto di questa risposta e quelli precedenti supera le dimensioni della finestra di contesto del modello, il modello tronca la risposta per adattarsi alla finestra di contesto eliminando gli elementi di input al centro della conversazione. - `disabled` (impostazione predefinita): se una risposta del modello supererà le dimensioni della finestra di contesto per un modello, la richiesta avrà esito negativo con un errore 400. Valori possibili: `auto`, `disabled`	NO
└─ utilizzo	OpenAI.ResponseUsage	Rappresenta i dettagli di utilizzo dei token, inclusi i token di input, i token di output, la suddivisione dei token di output e i token totali usati.	NO
└─ utente	corda	Identificatore univoco che rappresenta l'utente finale, che consente a OpenAI di monitorare e rilevare gli abusi.	NO
type	enum	Tipo di evento. Sempre 'response.queued'. Valori possibili: `response.queued`	Sì

OpenAI.ResponseReasoningDeltaEvent

Generato quando è presente un delta (aggiornamento parziale) al contenuto di ragionamento.

Nome	TIPO	Descrzione	Obbligatorio
content_index	numero intero	Indice della parte del contenuto di ragionamento all'interno dell'elemento di output.	Sì
delta		Aggiornamento parziale al contenuto di ragionamento.	Sì
item_id	corda	Identificatore univoco dell'elemento per il quale viene aggiornato il motivo.	Sì
output_index	numero intero	Indice dell'elemento di output nella matrice di output della risposta.	Sì
type	enum	Tipo di evento. Sempre 'response.reasoning.delta'. Valori possibili: `response.reasoning.delta`	Sì

OpenAI.ResponseReasoningDoneEvent

Generato quando il contenuto di ragionamento viene finalizzato per un elemento.

Nome	TIPO	Descrzione	Obbligatorio
content_index	numero intero	Indice della parte del contenuto di ragionamento all'interno dell'elemento di output.	Sì
item_id	corda	Identificatore univoco dell'elemento per il quale viene finalizzato il ragionamento.	Sì
output_index	numero intero	Indice dell'elemento di output nella matrice di output della risposta.	Sì
Testo	corda	Testo di ragionamento completato.	Sì
type	enum	Tipo di evento. Sempre 'response.reasoning.done'. Valori possibili: `response.reasoning.done`	Sì

OpenAI.ResponseReasoningSummaryDeltaEvent

Generato quando è presente un delta (aggiornamento parziale) al contenuto di riepilogo del ragionamento.

Nome	TIPO	Descrzione	Obbligatorio
delta		Aggiornamento parziale al contenuto di riepilogo del ragionamento.	Sì
item_id	corda	Identificatore univoco dell'elemento per il quale viene aggiornato il riepilogo dei motivi.	Sì
output_index	numero intero	Indice dell'elemento di output nella matrice di output della risposta.	Sì
summary_index	numero intero	Indice della parte di riepilogo all'interno dell'elemento di output.	Sì
type	enum	Tipo di evento. Sempre "response.reasoning_summary.delta". Valori possibili: `response.reasoning_summary.delta`	Sì

OpenAI.ResponseReasoningSummaryDoneEvent

Generato quando il contenuto di riepilogo del ragionamento viene finalizzato per un elemento.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	Identificatore univoco dell'elemento per il quale viene finalizzato il riepilogo del ragionamento.	Sì
output_index	numero intero	Indice dell'elemento di output nella matrice di output della risposta.	Sì
summary_index	numero intero	Indice della parte di riepilogo all'interno dell'elemento di output.	Sì
Testo	corda	Testo di riepilogo del ragionamento conclusivo.	Sì
type	enum	Tipo di evento. Sempre 'response.reasoning_summary.done'. Valori possibili: `response.reasoning_summary.done`	Sì

OpenAI.ResponseReasoningSummaryPartAddedEvent

Generato quando viene aggiunta una nuova parte di riepilogo del ragionamento.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	L'ID dell'elemento a cui è associata questa parte di riepilogo.	Sì
output_index	numero intero	L'indice dell'elemento di output a cui è associata questa parte di riepilogo.	Sì
part	oggetto		Sì
└─ Tipo	OpenAI.ReasoningItemSummaryPartType		NO
summary_index	numero intero	Indice della parte di sintesi all'interno del riepilogo del ragionamento.	Sì
type	enum	Tipo di evento. Sempre `response.reasoning_summary_part.added`. Valori possibili: `response.reasoning_summary_part.added`	Sì

OpenAI.ResponseReasoningSummaryPartDoneEvent

Generato quando viene completata una parte di riepilogo del ragionamento.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	L'ID dell'elemento a cui è associata questa parte di riepilogo.	Sì
output_index	numero intero	L'indice dell'elemento di output a cui è associata questa parte di riepilogo.	Sì
part	oggetto		Sì
└─ Tipo	OpenAI.ReasoningItemSummaryPartType		NO
summary_index	numero intero	Indice della parte di sintesi all'interno del riepilogo del ragionamento.	Sì
type	enum	Tipo di evento. Sempre `response.reasoning_summary_part.done`. Valori possibili: `response.reasoning_summary_part.done`	Sì

OpenAI.ResponseReasoningSummaryTextDeltaEvent

Generato quando un delta viene aggiunto a un testo di riepilogo del ragionamento.

Nome	TIPO	Descrzione	Obbligatorio
delta	corda	Delta del testo aggiunto al riepilogo.	Sì
item_id	corda	L'ID dell'elemento a cui è associato questo delta del testo di riepilogo.	Sì
output_index	numero intero	L'indice dell'elemento di output a cui è associato questo delta del testo di riepilogo.	Sì
summary_index	numero intero	Indice della parte di sintesi all'interno del riepilogo del ragionamento.	Sì
type	enum	Tipo di evento. Sempre `response.reasoning_summary_text.delta`. Valori possibili: `response.reasoning_summary_text.delta`	Sì

OpenAI.ResponseReasoningSummaryTextDoneEvent

Generato quando viene completato un testo di riepilogo del ragionamento.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	L'ID dell'elemento a cui è associato questo testo di riepilogo.	Sì
output_index	numero intero	L'indice dell'elemento di output a cui è associato questo testo di riepilogo.	Sì
summary_index	numero intero	Indice della parte di sintesi all'interno del riepilogo del ragionamento.	Sì
Testo	corda	Testo completo del riepilogo del ragionamento completato.	Sì
type	enum	Tipo di evento. Sempre `response.reasoning_summary_text.done`. Valori possibili: `response.reasoning_summary_text.done`	Sì

OpenAI.ResponseRefusalDeltaEvent

Emesso quando è presente un testo di rifiuto parziale.

Nome	TIPO	Descrzione	Obbligatorio
content_index	numero intero	Indice della parte del contenuto a cui viene aggiunto il testo di rifiuto.	Sì
delta	corda	Testo di rifiuto aggiunto.	Sì
item_id	corda	ID dell'elemento di output a cui viene aggiunto il testo di rifiuto.	Sì
output_index	numero intero	Indice dell'elemento di output a cui viene aggiunto il testo di rifiuto.	Sì
type	enum	Tipo di evento. Sempre `response.refusal.delta`. Valori possibili: `response.refusal.delta`	Sì

OpenAI.ResponseRefusalDoneEvent

Generato quando viene finalizzato il testo di rifiuto.

Nome	TIPO	Descrzione	Obbligatorio
content_index	numero intero	Indice della parte del contenuto in cui viene finalizzato il testo di rifiuto.	Sì
item_id	corda	ID dell'elemento di output in cui viene finalizzato il testo di rifiuto.	Sì
output_index	numero intero	Indice dell'elemento di output in cui viene finalizzato il testo di rifiuto.	Sì
refusal	corda	Il testo di rifiuto completato.	Sì
type	enum	Tipo di evento. Sempre `response.refusal.done`. Valori possibili: `response.refusal.done`	Sì

OpenAI.ResponseStreamEvent

Discriminatorio per OpenAI.ResponseStreamEvent

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`response.completed`	OpenAI.ResponseCompletedEvent
`response.content_part.added`	OpenAI.ResponseContentPartAddedEvent
`response.content_part.done`	OpenAI.ResponseContentPartDoneEvent
`response.created`	OpenAI.ResponseCreatedEvent
`error`	OpenAI.ResponseErrorEvent
`response.file_search_call.completed`	OpenAI.ResponseFileSearchCallCompletedEvent
`response.file_search_call.in_progress`	OpenAI.ResponseFileSearchCallInProgressEvent
`response.file_search_call.searching`	OpenAI.ResponseFileSearchCallSearchingEvent
`response.function_call_arguments.delta`	OpenAI.ResponseFunctionCallArgumentsDeltaEvent
`response.function_call_arguments.done`	OpenAI.ResponseFunctionCallArgumentsDoneEvent
`response.in_progress`	OpenAI.ResponseInProgressEvent
`response.failed`	OpenAI.ResponseFailedEvent
`response.incomplete`	OpenAI.ResponseIncompleteEvent
`response.output_item.added`	OpenAI.ResponseOutputItemAddedEvent
`response.output_item.done`	OpenAI.ResponseOutputItemDoneEvent
`response.refusal.delta`	OpenAI.ResponseRefusalDeltaEvent
`response.refusal.done`	OpenAI.ResponseRefusalDoneEvent
`response.output_text.delta`	OpenAI.ResponseTextDeltaEvent
`response.output_text.done`	OpenAI.ResponseTextDoneEvent
`response.reasoning_summary_part.added`	OpenAI.ResponseReasoningSummaryPartAddedEvent
`response.reasoning_summary_part.done`	OpenAI.ResponseReasoningSummaryPartDoneEvent
`response.reasoning_summary_text.delta`	OpenAI.ResponseReasoningSummaryTextDeltaEvent
`response.reasoning_summary_text.done`	OpenAI.ResponseReasoningSummaryTextDoneEvent
`response.web_search_call.completed`	OpenAI.ResponseWebSearchCallCompletedEvent
`response.web_search_call.in_progress`	OpenAI.ResponseWebSearchCallInProgressEvent
`response.web_search_call.searching`	OpenAI.ResponseWebSearchCallSearchingEvent
`response.image_generation_call.completed`	OpenAI.ResponseImageGenCallCompletedEvent
`response.image_generation_call.generating`	OpenAI.ResponseImageGenCallGeneratingEvent
`response.image_generation_call.in_progress`	OpenAI.ResponseImageGenCallInProgressEvent
`response.image_generation_call.partial_image`	OpenAI.ResponseImageGenCallPartialImageEvent
`response.mcp_call.arguments_delta`	OpenAI.ResponseMCPCallArgumentsDeltaEvent
`response.mcp_call.arguments_done`	OpenAI.ResponseMCPCallArgumentsDoneEvent
`response.mcp_call.completed`	OpenAI.ResponseMCPCallCompletedEvent
`response.mcp_call.failed`	OpenAI.ResponseMCPCallFailedEvent
`response.mcp_call.in_progress`	OpenAI.ResponseMCPCallInProgressEvent
`response.mcp_list_tools.completed`	OpenAI.ResponseMCPListToolsCompletedEvent
`response.mcp_list_tools.failed`	OpenAI.ResponseMCPListToolsFailedEvent
`response.mcp_list_tools.in_progress`	OpenAI.ResponseMCPListToolsInProgressEvent
`response.queued`	OpenAI.ResponseQueuedEvent
`response.reasoning.delta`	OpenAI.ResponseReasoningDeltaEvent
`response.reasoning.done`	OpenAI.ResponseReasoningDoneEvent
`response.reasoning_summary.delta`	OpenAI.ResponseReasoningSummaryDeltaEvent
`response.reasoning_summary.done`	OpenAI.ResponseReasoningSummaryDoneEvent
`response.code_interpreter_call_code.delta`	OpenAI.ResponseCodeInterpreterCallCodeDeltaEvent
`response.code_interpreter_call_code.done`	OpenAI.ResponseCodeInterpreterCallCodeDoneEvent
`response.code_interpreter_call.completed`	OpenAI.ResponseCodeInterpreterCallCompletedEvent
`response.code_interpreter_call.in_progress`	OpenAI.ResponseCodeInterpreterCallInProgressEvent
`response.code_interpreter_call.interpreting`	OpenAI.ResponseCodeInterpreterCallInterpretingEvent

Nome	TIPO	Descrzione	Obbligatorio	Default
sequence_number	numero intero	Numero di sequenza per questo evento.	Sì
type	OpenAI.ResponseStreamEventType		Sì

OpenAI.ResponseStreamEventType

Proprietà Value

Tipo corda

Valori response.audio.delta
response.audio.done
response.audio_transcript.delta
response.audio_transcript.done
response.code_interpreter_call_code.delta
response.code_interpreter_call_code.done
response.code_interpreter_call.completed
response.code_interpreter_call.in_progress
response.code_interpreter_call.interpreting
response.completed
response.content_part.added
response.content_part.done
response.created
error
response.file_search_call.completed
response.file_search_call.in_progress
response.file_search_call.searching
response.function_call_arguments.delta
response.function_call_arguments.done
response.in_progress
response.failed
response.incomplete
response.output_item.added
response.output_item.done
response.refusal.delta
response.refusal.done
response.output_text.annotation.added
response.output_text.delta
response.output_text.done
response.reasoning_summary_part.added
response.reasoning_summary_part.done
response.reasoning_summary_text.delta
response.reasoning_summary_text.done
response.web_search_call.completed
response.web_search_call.in_progress
response.web_search_call.searching
response.image_generation_call.completed
response.image_generation_call.generating
response.image_generation_call.in_progress
response.image_generation_call.partial_image
response.mcp_call.arguments_delta
response.mcp_call.arguments_done
response.mcp_call.completed
response.mcp_call.failed
response.mcp_call.in_progress
response.mcp_list_tools.completed
response.mcp_list_tools.failed
response.mcp_list_tools.in_progress
response.queued
response.reasoning.delta
response.reasoning.done
response.reasoning_summary.delta
response.reasoning_summary.done

OpenAI.ResponseTextDeltaEvent

Generato quando è presente un delta di testo aggiuntivo.

Nome	TIPO	Descrzione	Obbligatorio
content_index	numero intero	Indice della parte di contenuto a cui è stato aggiunto il delta del testo.	Sì
delta	corda	Delta del testo aggiunto.	Sì
item_id	corda	ID dell'elemento di output a cui è stato aggiunto il delta del testo.	Sì
output_index	numero intero	Indice dell'elemento di output a cui è stato aggiunto il delta del testo.	Sì
type	enum	Tipo di evento. Sempre `response.output_text.delta`. Valori possibili: `response.output_text.delta`	Sì

OpenAI.ResponseTextDoneEvent

Generato quando viene finalizzato il contenuto di testo.

Nome	TIPO	Descrzione	Obbligatorio
content_index	numero intero	Indice della parte del contenuto in cui viene finalizzato il contenuto del testo.	Sì
item_id	corda	ID dell'elemento di output in cui viene finalizzato il contenuto del testo.	Sì
output_index	numero intero	Indice dell'elemento di output in cui viene finalizzato il contenuto del testo.	Sì
Testo	corda	Contenuto di testo finalizzato.	Sì
type	enum	Tipo di evento. Sempre `response.output_text.done`. Valori possibili: `response.output_text.done`	Sì

OpenAI.ResponseTextFormatConfiguration

Discriminatore per OpenAI.ResponseTextFormatConfiguration

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`text`	OpenAI.ResponseTextFormatConfigurationText
`json_object`	OpenAI.ResponseTextFormatConfigurationJsonObject
`json_schema`	OpenAI.ResponseTextFormatConfigurationJsonSchema

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.ResponseTextFormatConfigurationType	Oggetto che specifica il formato che il modello deve restituire. La configurazione `{ "type": "json_schema" }` abilita gli output strutturati, che garantisce che il modello corrisponda allo schema JSON fornito. Il formato predefinito è `{ "type": "text" }` senza opzioni aggiuntive. Non consigliato per i modelli gpt-4o e versioni successive: L'impostazione su `{ "type": "json_object" }` abilita la modalità JSON precedente, che garantisce che il messaggio generato dal modello sia JSON valido. L'uso `json_schema` è preferibile per i modelli che lo supportano.	Sì

OpenAI.ResponseTextFormatConfigurationJsonObject

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `json_object`	Sì

OpenAI.ResponseTextFormatConfigurationJsonSchema

Formato di risposta dello schema JSON. Usato per generare risposte JSON strutturate.

Nome	TIPO	Descrzione	Obbligatorio	Default
descrizione	corda	Descrizione del formato di risposta, usato dal modello per determinare come rispondere nel formato.	NO
nome	corda	Nome del formato della risposta. Deve essere a-z, A-Z, 0-9 o contenere caratteri di sottolineatura e trattini, con una lunghezza massima di 64 caratteri.	Sì
schema	OpenAI.ResponseFormatJsonSchemaSchema	Schema per il formato di risposta, descritto come oggetto Schema JSON. Informazioni su come creare schemi JSON qui.	Sì
rigido	boolean	Indica se abilitare una rigorosa conformità allo schema durante la generazione dell'output. Se impostato su true, il modello seguirà sempre lo schema esatto definito nel campo `schema`. Solo un subset di schema JSON è supportato quando `strict` è `true`.	NO	Falso
type	enum	Tipo di formato di risposta definito. Sempre `json_schema`. Valori possibili: `json_schema`	Sì

OpenAI.ResponseTextFormatConfigurationText

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `text`	Sì

OpenAI.ResponseTextFormatConfigurationType

Oggetto che specifica il formato che il modello deve restituire.

La configurazione { "type": "json_schema" } abilita gli output strutturati, che garantisce che il modello corrisponda allo schema JSON fornito.

Il formato predefinito è { "type": "text" } senza opzioni aggiuntive.

Non consigliato per i modelli gpt-4o e versioni successive:

L'impostazione su { "type": "json_object" } abilita la modalità JSON precedente, che garantisce che il messaggio generato dal modello sia JSON valido. L'uso json_schema è preferibile per i modelli che lo supportano.

Proprietà	Value
Descrizione	Oggetto che specifica il formato che il modello deve restituire.

La configurazione { "type": "json_schema" } abilita gli output strutturati, che garantisce che il modello corrisponda allo schema JSON fornito.

Il formato predefinito è { "type": "text" } senza opzioni aggiuntive.

Non consigliato per i modelli gpt-4o e versioni successive:

OpenAI.ResponseUsage

Rappresenta i dettagli di utilizzo dei token, inclusi i token di input, i token di output, la suddivisione dei token di output e i token totali usati.

Nome	TIPO	Descrzione	Obbligatorio
input_tokens	numero intero	Numero di token di input.	Sì
input_tokens_details	oggetto	Dettaglio dei token di input.	Sì
└cached_tokens	numero intero	Numero di token recuperati dalla cache.	NO
output_tokens	numero intero	Numero di token in uscita.	Sì
output_tokens_details	oggetto	Dettaglio dei token di output.	Sì
└─ token_di_ragionamento	numero intero	Numero di token di ragionamento.	NO
total_tokens	numero intero	Numero totale di token usati.	Sì

OpenAI.ResponseWebSearchCallCompletedEvent

Nota: web_search non è ancora disponibile tramite Azure OpenAI.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	ID univoco per l'elemento di output associato alla chiamata di ricerca Web.	Sì
output_index	numero intero	Indice dell'elemento di output a cui è associata la chiamata di ricerca Web.	Sì
type	enum	Tipo di evento. Sempre `response.web_search_call.completed`. Valori possibili: `response.web_search_call.completed`	Sì

OpenAI.ResponseWebSearchCallInProgressEvent

Nota: web_search non è ancora disponibile tramite Azure OpenAI.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	ID univoco per l'elemento di output associato alla chiamata di ricerca Web.	Sì
output_index	numero intero	Indice dell'elemento di output a cui è associata la chiamata di ricerca Web.	Sì
type	enum	Tipo di evento. Sempre `response.web_search_call.in_progress`. Valori possibili: `response.web_search_call.in_progress`	Sì

OpenAI.ResponseWebSearchCallSearchingEvent

Nota: web_search non è ancora disponibile tramite Azure OpenAI.

Nome	TIPO	Descrzione	Obbligatorio
item_id	corda	ID univoco per l'elemento di output associato alla chiamata di ricerca Web.	Sì
output_index	numero intero	Indice dell'elemento di output a cui è associata la chiamata di ricerca Web.	Sì
type	enum	Tipo di evento. Sempre `response.web_search_call.searching`. Valori possibili: `response.web_search_call.searching`	Sì

OpenAI.ResponsesAssistantMessageItemParam

Elemento del parametro del messaggio con il ruolo assistant.

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	array	Contenuto associato al messaggio.	Sì
ruolo	enum	Ruolo del messaggio, che è sempre `assistant`. Valori possibili: `assistant`	Sì

OpenAI.ResponsesAssistantMessageItemResource

Elemento della risorsa messaggio con il ruolo assistant.

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	array	Contenuto associato al messaggio.	Sì
ruolo	enum	Ruolo del messaggio, che è sempre `assistant`. Valori possibili: `assistant`	Sì

OpenAI.ResponsesDeveloperMessageItemParam

Elemento del parametro del messaggio con il ruolo developer.

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	array	Contenuto associato al messaggio.	Sì
ruolo	enum	Ruolo del messaggio, che è sempre `developer`. Valori possibili: `developer`	Sì

OpenAI.ResponsesDeveloperMessageItemResource

Elemento della risorsa messaggio con il ruolo developer.

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	array	Contenuto associato al messaggio.	Sì
ruolo	enum	Ruolo del messaggio, che è sempre `developer`. Valori possibili: `developer`	Sì

OpenAI.ResponsesMessageItemParam

Elemento del messaggio di risposta, che rappresenta un ruolo e un contenuto, come specificato come parametri di richiesta client.

Discriminatorio per OpenAI.ResponsesMessageItemParam

Questo componente usa la proprietà role per distinguere tra tipi diversi:

Valore tipo	Schema
`user`	OpenAI.ResponsesUserMessageItemParam
`system`	OpenAI.ResponsesSystemMessageItemParam
`developer`	OpenAI.ResponsesDeveloperMessageItemParam
`assistant`	OpenAI.ResponsesAssistantMessageItemParam

Nome	TIPO	Descrzione	Obbligatorio	Default
ruolo	oggetto	Raccolta di ruoli validi per le risposte agli elementi del messaggio.	Sì
type	enum	Tipo dell'elemento delle risposte, che è sempre "message". Valori possibili: `message`	Sì

OpenAI.ResponsesMessageItemResource

Elemento della risorsa del messaggio di risposta, che rappresenta un ruolo e un contenuto, come specificato nelle risposte del servizio.

Discriminare per OpenAI.ResponsesMessageItemResource

Questo componente usa la proprietà role per distinguere tra tipi diversi:

Valore tipo	Schema
`user`	OpenAI.ResponsesUserMessageItemResource
`system`	OpenAI.ResponsesSystemMessageItemResource
`developer`	OpenAI.ResponsesDeveloperMessageItemResource
`assistant`	OpenAI.ResponsesAssistantMessageItemResource

Nome	TIPO	Descrzione	Obbligatorio
ruolo	oggetto	Raccolta di ruoli validi per le risposte agli elementi del messaggio.	Sì
stato	enum	Stato dell'elemento. Uno tra `in_progress`, `completed` e `incomplete`. Popolato quando gli elementi vengono restituiti tramite l'API. Valori possibili: `in_progress`, `completed`, `incomplete`	Sì
type	enum	Tipo dell'elemento delle risposte, che è sempre "message". Valori possibili: `message`	Sì

OpenAI.ResponsesMessageRole

Raccolta di ruoli validi per le risposte agli elementi del messaggio.

Proprietà	Value
Descrizione	Raccolta di ruoli validi per le risposte agli elementi del messaggio.
Tipo	corda
Valori	`system` `developer` `user` `assistant`

OpenAI.ResponsesSystemMessageItemParam

Elemento del parametro del messaggio con il ruolo system.

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	array	Contenuto associato al messaggio.	Sì
ruolo	enum	Ruolo del messaggio, che è sempre `system`. Valori possibili: `system`	Sì

OpenAI.ResponsesSystemMessageItemResource

Elemento della risorsa messaggio con il ruolo system.

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	array	Contenuto associato al messaggio.	Sì
ruolo	enum	Ruolo del messaggio, che è sempre `system`. Valori possibili: `system`	Sì

OpenAI.ResponsesUserMessageItemParam

Elemento del parametro del messaggio con il ruolo user.

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	array	Contenuto associato al messaggio.	Sì
ruolo	enum	Ruolo del messaggio, che è sempre `user`. Valori possibili: `user`	Sì

OpenAI.ResponsesUserMessageItemResource

Elemento della risorsa messaggio con il ruolo user.

Nome	TIPO	Descrzione	Obbligatorio	Default
contenuto	array	Contenuto associato al messaggio.	Sì
ruolo	enum	Ruolo del messaggio, che è sempre `user`. Valori possibili: `user`	Sì

OpenAI.RunGraderRequest

Nome	TIPO	Descrzione	Obbligatorio
cernitore	oggetto	Oggetto StringCheckGrader che esegue un confronto di stringhe tra input e riferimento usando un'operazione specificata.	Sì
└' calculate_output	corda	Formula per calcolare l'output in base ai risultati del classificatore.	NO
└' evaluation_metric	enum	Metrica di valutazione da usare. Uno di `fuzzy_match`, `bleu`, `gleu`, `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5` o `rouge_l`. Valori possibili: `fuzzy_match`, `bleu`, `gleumeteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5rouge_l`	NO
└️ voti	oggetto		NO
└' image_tag	corda	Tag immagine da usare per lo script Python.	NO
└ Input	array	Testo di input. Ciò può includere stringhe di modello.	NO
└─ Modello	corda	Modello da utilizzare per la valutazione.	NO
└> nome	corda	Nome del grader.	NO
└─ Operazione	enum	Operazione di controllo della stringa da eseguire. Uno tra `eq`, `ne`, `like` o `ilike`. Valori possibili: `eq`, `ne`, `like`, `ilike`	NO
└* intervallo	array	La gamma del punteggio. Il valore predefinito è `[0, 1]`.	NO
Riferimento	corda	Testo che viene valutato.	NO
└sampling_params		Parametri di campionamento per il modello.	NO
└─ sorgente	corda	Codice sorgente dello script Python.	NO
└─ Tipo	enum	Il tipo di oggetto, che è sempre `multi`. Valori possibili: `multi`	NO
oggetto		Elemento del set di dati fornito al classificatore. Verrà usato per popolare il `item` namespace.	NO
model_sample	corda	Esempio di modello da valutare. Questo valore verrà usato per popolare lo spazio dei nomi `sample`. La `output_json` variabile verrà popolata se l'esempio di modello è una stringa JSON valida.	Sì

OpenAI.RunGraderResponse

Nome	TIPO	Obbligatorio
metadata	oggetto	Sì
└─ errori	oggetto	NO
└• formula_parse_error	boolean	NO
└' invalid_variable_error	boolean	NO
└• model_grader_parse_error	boolean	NO
└' model_grader_refusal_error	boolean	NO
└• model_grader_server_error	boolean	NO
└' model_grader_server_error_details	corda	NO
└' other_error	boolean	NO
└• python_grader_runtime_error	boolean	NO
└' python_grader_runtime_error_details	corda	NO
└' python_grader_server_error	boolean	NO
└• python_grader_server_error_type	corda	NO
└' sample_parse_error	boolean	NO
└' truncated_observation_error	boolean	NO
└' unresponsive_reward_error	boolean	NO
└' execution_time	numero	NO
└> nome	corda	NO
└' sampled_model_name	corda	NO
└* punteggi		NO
└' token_usage	numero intero	NO
└─ Tipo	corda	NO
model_grader_token_usage_per_model		Sì
riconoscimento	numero	Sì
sub_rewards		Sì

OpenAI.StaticChunkingStrategy

Nome	TIPO	Descrzione	Obbligatorio	Default
sovrapposizione_segmento_token	numero intero	Numero di token che si sovrappongono tra blocchi. Il valore predefinito è `400`. Notare che la sovrapposizione non deve superare la metà di `max_chunk_size_tokens`.	Sì
dimensione_massima_chunk_token	numero intero	Numero massimo di token in ogni blocco. Il valore predefinito è `800`. Il valore minimo è `100` e il valore massimo è `4096`.	Sì

OpenAI.StaticChunkingStrategyRequestParam

Personalizzare la propria strategia di suddivisione in blocchi impostando le dimensioni dei blocchi e la sovrapposizione dei blocchi.

Nome	TIPO	Descrzione	Obbligatorio	Default
statico	OpenAI.StaticChunkingStrategy		Sì
type	enum	Sempre `static`. Valori possibili: `static`	Sì

OpenAI.StaticChunkingStrategyResponseParam

Nome	TIPO	Descrzione	Obbligatorio	Default
statico	OpenAI.StaticChunkingStrategy		Sì
type	enum	Sempre `static`. Valori possibili: `static`	Sì

OpenAI.StopConfiguration

Non supportato con i modelli o3 di ragionamento più recenti e o4-mini.

Fino a 4 sequenze in cui l'API smetterà di generare altri token. Il testo restituito non conterrà la sequenza di interruzione.

Questo schema accetta uno dei tipi seguenti:

string
array

OpenAI.Tool

Discriminatore per OpenAI.Tool

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`function`	OpenAI.FunctionTool
`file_search`	OpenAI.FileSearchTool
`computer_use_preview`	OpenAI.ComputerUsePreviewTool
`web_search_preview`	OpenAI.WebSearchPreviewTool
`code_interpreter`	OpenAI.CodeInterpreterTool
`image_generation`	OpenAI.ImageGenTool
`local_shell`	OpenAI.LocalShellTool
`mcp`	OpenAI.MCPTool

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.ToolType	Strumento che può essere usato per generare una risposta.	Sì

OpenAI.ToolChoiceObject

Discriminante per OpenAI.ToolChoiceObject

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`file_search`	OpenAI.ToolChoiceObjectFileSearch
`computer_use_preview`	OpenAI.ToolChoiceObjectComputer
`web_search_preview`	OpenAI.ToolChoiceObjectWebSearch
`image_generation`	OpenAI.ToolChoiceObjectImageGen
`code_interpreter`	OpenAI.ToolChoiceObjectCodeInterpreter
`function`	OpenAI.ToolChoiceObjectFunction
`mcp`	OpenAI.ToolChoiceObjectMCP

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.ToolChoiceObjectType	Indica che il modello deve usare uno strumento predefinito per generare una risposta.	Sì

OpenAI.ToolChoiceObjectCodeInterpreter

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `code_interpreter`	Sì

OpenAI.ToolChoiceObjectComputer

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `computer_use_preview`	Sì

OpenAI.ToolChoiceObjectFileSearch

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `file_search`	Sì

OpenAI.ToolChoiceObjectFunction

Usare questa opzione per forzare il modello a chiamare una funzione specifica.

Nome	TIPO	Descrzione	Obbligatorio	Default
nome	corda	Nome della funzione da chiamare.	Sì
type	enum	Per la chiamata di funzione, il tipo è sempre `function`. Valori possibili: `function`	Sì

OpenAI.ToolChoiceObjectImageGen

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `image_generation`	Sì

OpenAI.ToolChoiceObjectMCP

Usare questa opzione per forzare il modello a chiamare uno strumento specifico in un server MCP remoto.

Nome	TIPO	Descrzione	Obbligatorio
nome	corda	Nome dello strumento da chiamare sul server.	NO
etichetta del server	corda	Etichetta del server MCP da utilizzare.	Sì
type	enum	Per gli strumenti MCP, il tipo è sempre `mcp`. Valori possibili: `mcp`	Sì

OpenAI.ToolChoiceObjectType

Indica che il modello deve usare uno strumento predefinito per generare una risposta.

Proprietà	Value
Descrizione	Indica che il modello deve usare uno strumento predefinito per generare una risposta.

Tipo	corda
Valori	`file_search` `function` `computer_use_preview` `web_search_preview` `image_generation` `code_interpreter` `mcp`

OpenAI.ToolChoiceObjectWebSearch

Nota: web_search non è ancora disponibile tramite Azure OpenAI.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Valori possibili: `web_search_preview`	Sì

OpenAI.ToolChoiceOptions

Controlla quale strumento (se presente) viene chiamato dal modello.

none indica che il modello non chiamerà alcuno strumento e genera invece un messaggio.

auto indica che il modello può scegliere tra la generazione di un messaggio o la chiamata di uno o più strumenti.

required indica che il modello deve chiamare uno o più strumenti.

Proprietà	Value
Descrizione	Controlla quale strumento (se presente) viene chiamato dal modello. `none` indica che il modello non chiamerà alcuno strumento e genera invece un messaggio. `auto` indica che il modello può scegliere tra la generazione di un messaggio o la chiamata di uno o più strumenti. `required` indica che il modello deve chiamare uno o più strumenti.
Tipo	corda
Valori	`none` `auto` `required`

OpenAI.ToolType

Strumento che può essere usato per generare una risposta.

Proprietà	Value
Descrizione	Strumento che può essere usato per generare una risposta.
Tipo	corda
Valori	`file_search` `function` `computer_use_preview` `web_search_preview` `mcp` `code_interpreter` `image_generation` `local_shell`

OpenAI.TopLogProb

Probabilità di log superiore di un token.

Nome	TIPO	Obbligatorio
bytes	array	Sì
logprob	numero	Sì
token	corda	Sì

OpenAI.TranscriptionAudioResponseFormat

Riferimenti: OpenAI.AudioResponseFormat

OpenAI.TranscriptionInclude

Proprietà	Value
Tipo	corda
Valori	`logprobs`

OpenAI.TranscriptionSegment

Nome	TIPO	Descrzione	Obbligatorio
avg_logprob	numero	Logprob medio del segmento. Se il valore è inferiore a -1, considerare che i logprobs non sono riusciti.	Sì
compression_ratio	numero	Rapporto di compressione del segmento. Se il valore è maggiore di 2,4, prendere in considerazione l'errore di compressione.	Sì
fine	numero	Ora di fine del segmento in secondi.	Sì
id	numero intero	Identificatore univoco del segmento.	Sì
no_speech_prob	numero	Probabilità di nessun parlato nel segmento. Se il valore è superiore a 1,0 ed il `avg_logprob` è inferiore a -1, considerate questo segmento silenzioso.	Sì
seek	numero intero	Offset di ricerca del segmento.	Sì
start	numero	Ora di inizio del segmento in secondi.	Sì
temperatura	numero	Parametro Temperature usato per generare il segmento.	Sì
Testo	corda	Contenuto di testo del segmento.	Sì
tokens	array	Matrice di ID token per il contenuto di testo.	Sì

OpenAI.TranscriptionWord

Nome	TIPO	Descrzione	Obbligatorio
fine	numero	Ora di fine della parola in secondi.	Sì
start	numero	Ora di inizio della parola in secondi.	Sì
word	corda	Contenuto di testo della parola.	Sì

OpenAI.TranslationAudioResponseFormat

Riferimenti: OpenAI.AudioResponseFormat

OpenAI.UpdateVectorStoreFileAttributesRequest

Nome	TIPO	Descrzione	Obbligatorio	Default
attributes	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri, valori booleani o numeri.	Sì

OpenAI.UpdateVectorStoreRequest

Nome	TIPO	Descrzione	Obbligatorio
scade dopo	oggetto	I criteri di scadenza per un archivio vettoriale.	NO
Ancoraggio └*	enum	Timestamp di ancoraggio dopo il quale si applicano i criteri di scadenza. Ancoraggi supportati: `last_active_at`. Valori possibili: `last_active_at`	NO
└* giorni	numero intero	Numero di giorni dopo l'ora di ancoraggio in cui scadrà l'archivio vettoriale.	NO
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	NO
nome	corda	Il nome dell’archivio vettoriale.	NO

OpenAI.VadConfig

Nome	TIPO	Descrzione	Obbligatorio	Default
prefix_padding_ms	numero intero	Quantità di audio da includere prima del riconoscimento vocale rilevato da VAD (in millisecondi).	NO	300
silence_duration_ms	numero intero	Durata del silenzio per rilevare l'arresto vocale (in millisecondi). Con valori più brevi, il modello risponderà più rapidamente, ma potrebbe attivarsi durante le brevi pause dell'utente.	NO	200
threshold	numero	Soglia di sensibilità (da 0,0 a 1,0) per il rilevamento delle attività vocali. Una soglia più elevata richiederà un audio più forte per attivare il modello e quindi potrebbe offrire prestazioni migliori in ambienti rumorosi.	NO	0,5
type	enum	Deve essere impostato su `server_vad` per abilitare la suddivisione in blocchi manuale tramite VAD sul lato server. Valori possibili: `server_vad`	Sì

OpenAI.ValidateGraderRequest

Nome	TIPO	Descrzione	Obbligatorio
cernitore	oggetto	Oggetto StringCheckGrader che esegue un confronto di stringhe tra input e riferimento usando un'operazione specificata.	Sì
└' calculate_output	corda	Formula per calcolare l'output in base ai risultati del classificatore.	NO
└' evaluation_metric	enum	Metrica di valutazione da usare. Uno di `fuzzy_match`, `bleu`, `gleu`, `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5` o `rouge_l`. Valori possibili: `fuzzy_match`, `bleu`, `gleumeteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5rouge_l`	NO
└️ voti	oggetto		NO
└' image_tag	corda	Tag immagine da usare per lo script Python.	NO
└ Input	array	Testo di input. Ciò può includere stringhe di modello.	NO
└─ Modello	corda	Modello da utilizzare per la valutazione.	NO
└> nome	corda	Nome del grader.	NO
└─ Operazione	enum	Operazione di controllo della stringa da eseguire. Uno tra `eq`, `ne`, `like` o `ilike`. Valori possibili: `eq`, `ne`, `like`, `ilike`	NO
└* intervallo	array	La gamma del punteggio. Il valore predefinito è `[0, 1]`.	NO
Riferimento	corda	Testo che viene valutato.	NO
└sampling_params		Parametri di campionamento per il modello.	NO
└─ sorgente	corda	Codice sorgente dello script Python.	NO
└─ Tipo	enum	Il tipo di oggetto, che è sempre `multi`. Valori possibili: `multi`	NO

OpenAI.ValidateGraderResponse

Nome	TIPO	Descrzione	Obbligatorio
cernitore	oggetto	Oggetto StringCheckGrader che esegue un confronto di stringhe tra input e riferimento usando un'operazione specificata.	NO
└' calculate_output	corda	Formula per calcolare l'output in base ai risultati del classificatore.	NO
└' evaluation_metric	enum	Metrica di valutazione da usare. Uno di `fuzzy_match`, `bleu`, `gleu`, `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5` o `rouge_l`. Valori possibili: `fuzzy_match`, `bleu`, `gleumeteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5rouge_l`	NO
└️ voti	oggetto		NO
└' image_tag	corda	Tag immagine da usare per lo script Python.	NO
└ Input	array	Testo di input. Ciò può includere stringhe di modello.	NO
└─ Modello	corda	Modello da utilizzare per la valutazione.	NO
└> nome	corda	Nome del grader.	NO
└─ Operazione	enum	Operazione di controllo della stringa da eseguire. Uno tra `eq`, `ne`, `like` o `ilike`. Valori possibili: `eq`, `ne`, `like`, `ilike`	NO
└* intervallo	array	La gamma del punteggio. Il valore predefinito è `[0, 1]`.	NO
Riferimento	corda	Testo che viene valutato.	NO
└sampling_params		Parametri di campionamento per il modello.	NO
└─ sorgente	corda	Codice sorgente dello script Python.	NO
└─ Tipo	enum	Il tipo di oggetto, che è sempre `multi`. Valori possibili: `multi`	NO

OpenAI.VectorStoreExpirationAfter

I criteri di scadenza per un archivio vettoriale.

Nome	TIPO	Descrzione	Obbligatorio	Default
anchor	enum	Timestamp di ancoraggio dopo il quale si applicano i criteri di scadenza. Ancoraggi supportati: `last_active_at`. Valori possibili: `last_active_at`	Sì
Giorni	numero intero	Numero di giorni dopo l'ora di ancoraggio in cui scadrà l'archivio vettoriale.	Sì

OpenAI.VectorStoreFileAttributes

Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri, valori booleani o numeri.

Tipo: oggetto

OpenAI.VectorStoreFileBatchObject

Una batch di file collegati a un archivio vettoriale.

Nome	TIPO	Descrzione	Obbligatorio
creato_il	numero intero	Timestamp Unix (in secondi) di quando è stato creato il batch di file dell’archivio vettoriale.	Sì
file_counts	oggetto		Sì
└* annullato	numero intero	Il numero di file che sono stati annullati.	NO
└* completato	numero intero	Il numero di file elaborati.	NO
└* non riuscito	numero intero	Il numero di file per cui l’elaborazione non è riuscita.	NO
└─ in corso	numero intero	Il numero di file attualmente in fase di elaborazione.	NO
└─ totale	numero intero	Numero totale di file.	NO
id	corda	Identificatore a cui è possibile fare riferimento negli endpoint API.	Sì
oggetto	enum	Il tipo di oggetto, che è sempre `vector_store.file_batch`. Valori possibili: `vector_store.files_batch`	Sì
stato	enum	Lo stato del batch del file dell’archivio vettoriale, che può essere `in_progress`, `completed`, `cancelled` o `failed`. Valori possibili: `in_progress`, `completed`, `cancelled`, `failed`	Sì
ID del negozio vettoriale	corda	ID dell'archivio vettoriale a cui è associato il file.	Sì

OpenAI.VectorStoreFileObject

Elenco di file collegati a un archivio vettoriale.

Nome	TIPO	Descrzione	Obbligatorio
attributes	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri, valori booleani o numeri.	NO
chunking_strategy	oggetto		NO
└─ Tipo	enum	Valori possibili: `static`, `other`	NO
creato_il	numero intero	Timestamp Unix (in secondi) di quando è stato creato il file dell’archivio vettoriale.	Sì
id	corda	Identificatore a cui è possibile fare riferimento negli endpoint API.	Sì
errore_ultimo	oggetto	Ultimo errore associato a questo file dell’archivio vettoriale. Sarà `null` se non ci sono errori.	Sì
└─ codice	enum	Uno tra `server_error` e `rate_limit_exceeded`. Valori possibili: `server_error`, `unsupported_file`, `invalid_file`	NO
└* messaggio	corda	Descrizione leggibile dell'errore.	NO
oggetto	enum	Il tipo di oggetto, che è sempre `vector_store.file`. Valori possibili: `vector_store.file`	Sì
stato	enum	Lo stato del file dell’archivio vettoriale, che può essere `in_progress`, `completed`, `cancelled` o `failed`. Lo stato di `completed` indica che il file dell’archivio vettoriale è pronto per l'uso. Valori possibili: `in_progress`, `completed`, `cancelled`, `failed`	Sì
usage_bytes	numero intero	Utilizzo totale dell'archivio vettoriale in byte. Si noti che questo può essere diverso dalle dimensioni del file originale.	Sì
ID del negozio vettoriale	corda	ID dell'archivio vettoriale a cui è associato il file.	Sì

OpenAI.VectorStoreObject

Un archivio vettoriale è una raccolta di file elaborati che può essere usato dallo strumento file_search.

Nome	TIPO	Descrzione	Obbligatorio
creato_il	numero intero	Timestamp Unix (in secondi) di quando è stato creato l’archivio vettoriale.	Sì
scade dopo	OpenAI.VectorStoreExpirationAfter	I criteri di scadenza per un archivio vettoriale.	NO
scade_il	numero intero	Timestamp Unix (in secondi) di quando l’archivio vettoriale scadrà.	NO
file_counts	oggetto		Sì
└* annullato	numero intero	Il numero di file che sono stati annullati.	NO
└* completato	numero intero	Il numero di file elaborati correttamente.	NO
└* non riuscito	numero intero	Il numero di file per cui l’elaborazione non è riuscita.	NO
└─ in corso	numero intero	Il numero di file attualmente in fase di elaborazione.	NO
└─ totale	numero intero	Numero totale di file.	NO
id	corda	Identificatore a cui è possibile fare riferimento negli endpoint API.	Sì
ultima_attività_il	numero intero	Timestamp Unix (in secondi) di quando l’archivio vettoriale è stato attivo per l’ultima volta.	Sì
metadata	oggetto	Set di 16 coppie chiave-valore che possono essere collegate a un oggetto. Ciò può essere utile per archiviare informazioni aggiuntive sull'oggetto in un formato strutturato ed eseguire query sugli oggetti tramite API o il dashboard. Le chiavi sono stringhe con una lunghezza massima di 64 caratteri. I valori sono stringhe con una lunghezza massima di 512 caratteri.	Sì
nome	corda	Il nome dell’archivio vettoriale.	Sì
oggetto	enum	Il tipo di oggetto, che è sempre `vector_store`. Valori possibili: `vector_store`	Sì
stato	enum	Lo stato dell’archivio vettoriale, che può essere `expired`, `in_progress` o `completed`. Lo stato di `completed` indica che l'archivio vettoriale è pronto per l'uso. Valori possibili: `expired`, `in_progress`, `completed`	Sì
usage_bytes	numero intero	Numero totale di byte utilizzati dai file nell'archivio vettoriale.	Sì

OpenAI.VoiceIdsShared

Proprietà	Value
Tipo	corda
Valori	`alloy` `ash` `ballad` `coral` `echo` `fable` `onyx` `nova` `sage` `shimmer` `verse`

OpenAI.WebSearchAction

Discriminatore per OpenAI.WebSearchAction

Questo componente usa la proprietà type per distinguere tra tipi diversi:

Valore tipo	Schema
`find`	OpenAI.WebSearchActionFind
`open_page`	OpenAI.WebSearchActionOpenPage
`search`	OpenAI.WebSearchActionSearch

Nome	TIPO	Descrzione	Obbligatorio	Default
type	OpenAI.WebSearchActionType		Sì

OpenAI.WebSearchActionFind

Tipo di azione "find": cerca un criterio all'interno di una pagina caricata.

Nome	TIPO	Descrzione	Obbligatorio
pattern	corda	Modello o testo da cercare all'interno della pagina.	Sì
type	enum	Tipo di azione. Valori possibili: `find`	Sì
URL.	corda	URL della pagina in cui è stata eseguita la ricerca del modello.	Sì

OpenAI.WebSearchActionOpenPage

Tipo di azione "open_page" - Apre un URL specifico dai risultati della ricerca.

Nome	TIPO	Descrzione	Obbligatorio	Default
type	enum	Tipo di azione. Valori possibili: `open_page`	Sì
URL.	corda	URL aperto dal modello.	Sì

OpenAI.WebSearchActionSearch

Tipo di azione "search" - Esegue una query di ricerca Web.

Nome	TIPO	Descrzione	Obbligatorio	Default
query	corda	Query di ricerca.	Sì
type	enum	Tipo di azione. Valori possibili: `search`	Sì

OpenAI.WebSearchActionType

Proprietà	Value
Tipo	corda
Valori	`search` `open_page` `find`

OpenAI.WebSearchPreviewTool

Nota: web_search non è ancora disponibile tramite Azure OpenAI.

Nome	TIPO	Descrzione	Obbligatorio
dimensione_del_contesto_di_ricerca	enum	Linee guida generali per la quantità di spazio della finestra di contesto da usare per la ricerca. Uno tra `low`, `medium` e `high`. `medium` è l'impostazione predefinita. Valori possibili: `low`, `medium`, `high`	NO
type	enum	Tipo dello strumento di ricerca Web. Uno tra `web_search_preview` e `web_search_preview_2025_03_11`. Valori possibili: `web_search_preview`	Sì
posizione_utente	oggetto		NO
└─ Tipo	OpenAI.LocationType		NO

OpenAI.WebSearchToolCallItemParam

Nota: web_search non è ancora disponibile tramite Azure OpenAI.

Nome	TIPO	Descrzione	Obbligatorio
azione	oggetto		Sì
└─ Tipo	OpenAI.WebSearchActionType		NO
type	enum	Valori possibili: `web_search_call`	Sì

OpenAI.WebSearchToolCallItemResource

Nota: web_search non è ancora disponibile tramite Azure OpenAI.

Nome	TIPO	Descrzione	Obbligatorio
azione	oggetto		Sì
└─ Tipo	OpenAI.WebSearchActionType		NO
stato	enum	Stato della chiamata dello strumento di ricerca Web. Valori possibili: `in_progress`, `searching`, `completed`, `failed`	Sì
type	enum	Valori possibili: `web_search_call`	Sì

PineconeChatDataSource

Nome	TIPO	Descrzione	Obbligatorio	Default
parameters	oggetto	Informazioni sui parametri per controllare l'uso dell'origine dati Pinecone.	Sì
└─ consenti_risultato_parziale	boolean	Se impostato su true, il sistema consentirà l'uso di risultati parziali della ricerca e la richiesta avrà esito negativo se tutte le query parziali hanno esito negativo. Se non specificato, o specificato come false, la richiesta avrà esito negativo se una query di ricerca ha esito negativo.	NO	Falso
Autenticazione	oggetto		NO
└─ tasto	corda		NO
└─ Tipo	enum	Valori possibili: `api_key`	NO
└─ dipendenza_embedded	oggetto	Rappresentazione di un'origine di vettorizzazione dei dati utilizzabile come risorsa di incapsulamento con un'origine di dati.	NO
└─ Tipo	AzureChatDataSourceVectorizationSourceType	Identificatore di differenziazione per l'origine di vettorizzazione concreta.	NO
└─ Ambiente	corda	Nome dell'ambiente da usare con Pinecone.	NO
└ fields_mapping	oggetto	Mappature dei campi da applicare ai dati utilizzati dalla fonte di dati Pinecone. Si noti che i mapping dei campi del contenuto sono necessari per Pinecone.	NO
└content_fields	array		NO
└─content_fields_separator	corda		NO
└filepath_field	corda		NO
└─ campo_titolo	corda		NO
└url_field	corda		NO
└ in_scope	boolean	Indica se le query devono essere limitate all'uso dei dati indicizzati.	NO
└include_contexts	array	Proprietà del contesto di output da includere nella risposta. Per impostazione predefinita, verranno richieste citazioni e finalità.	NO	['citazioni', 'intento']
└ index_name	corda	Nome dell'indice di database Pinecone da utilizzare.	NO
└max_search_queries	numero intero	Numero massimo di query riscritte che devono essere inviate al provider di ricerca per un singolo messaggio utente. Per impostazione predefinita, il sistema effettuerà una determinazione automatica.	NO
└* rigidità	numero intero	La rigidità configurata del filtro di pertinenza della ricerca. Una maggiore rigidità aumenterà la precisione, ma diminuirà il richiamo della risposta.	NO
└top_n_documents	numero intero	Il numero configurato di documenti da includere nella query.	NO
type	enum	Identificatore di tipo discriminato, che è sempre "pinecone". Valori possibili: `pinecone`	Sì

Qualità

Qualità del contenuto video da recuperare. Specifica la qualità del contenuto video che deve essere restituito.

Proprietà	Value
Descrizione	Qualità del contenuto video da recuperare. Specifica la qualità del contenuto video che deve essere restituito.
Tipo	corda
Valori	`high` `low`

ResponseFormatJSONSchemaRequest

Nome	TIPO	Descrzione	Obbligatorio	Default
json_schema	oggetto	Schema JSON per il formato di risposta	Sì
type	enum	Tipo di formato della risposta Valori possibili: `json_schema`	Sì

ResponseModalities

Tipi di output che si desidera generare il modello. La maggior parte dei modelli è in grado di generare testo, in base all'impostazione predefinita:

["text"]

Il modello gpt-4o-audio-preview può essere usato anche per generare audio. Per far sì che questo modello generi risposte sia di testo che audio, è possibile usare:

["text", "audio"]

matrice di: string

SpeechGenerationResponseFormat

Formati di output audio supportati per la sintesi vocale.

Questo componente può essere uno dei seguenti:

VideoGeneration

Risultato della generazione di video.

Nome	TIPO	Descrzione	Obbligatorio
creato_il	numero intero	Ora in cui è stata creata la generazione di video.	Sì
altezza	numero intero	Altezza del video.	Sì
id	corda	ID della generazione di video.	Sì
job_id	corda	ID del processo di generazione video per questo video.	Sì
n_seconds	numero intero	Durata della generazione di video.	Sì
oggetto	enum	Valori possibili: `video.generation`	Sì
prompt	corda	Richiesta di generazione di video.	Sì
Larghezza	numero intero	Larghezza del video.	Sì

VideoGenerationJob

Processo di generazione video.

Nome	TIPO	Descrzione	Obbligatorio
creato_il	numero intero	Il momento in cui l'attività è stata creata.	Sì
scade_il	numero intero	Ora in cui il processo viene eliminato automaticamente dal servizio. Il contenuto video e i metadati del processo devono essere archiviati prima di questa data per evitare la perdita di dati.	NO
failure_reason	string (vedere modelli validi di seguito)		NO
terminato_il	numero intero	L'ora in cui il lavoro è terminato con tutte le generazioni di video.	NO
Generazioni	array	Video generati per questo processo. Il numero dipende dal n_variants specificato e dal successo della creazione delle generazioni.	NO
altezza	numero intero	Altezza del video.	Sì
id	corda	ID del processo.	Sì
inpaint_items	array	Elementi di aggiornamento facoltativi per questo processo di generazione video.	NO
model	corda	Nome della distribuzione da usare per questo processo di generazione video.	Sì
n_seconds	numero intero	Durata del processo di generazione video.	Sì
n_variants	numero intero	Numero di video da creare come varianti per questo processo di generazione di video.	Sì
oggetto	enum	Valori possibili: `video.generation.job`	Sì
prompt	corda	Richiesta di questo processo di generazione video.	Sì
stato	oggetto	Stato di un processo di generazione video.	Sì
Larghezza	numero intero	Altezza del video.	Sì

VideoGenerationJobList

Elenco di processi di generazione video.

Nome	TIPO	Descrzione	Obbligatorio
data	array	Elenco di processi di generazione video.	Sì
first_id	corda	ID del primo processo nella pagina corrente, se disponibile.	NO
ha_di_piu	boolean	Flag che indica se sono disponibili più processi dopo l'elenco.	Sì
last_id	corda	ID dell'ultimo processo nella pagina corrente, se disponibile.	NO
oggetto	enum	Valori possibili: `list`	Sì

Passaggi successivi

Informazioni sui modelli e sull'ottimizzazione con l'API REST. Altre informazioni sui modelli informazioni che alimentano Azure OpenAI.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-02-28

Condividi tramite

Azure Riferimento all'anteprima dell'API REST di OpenAI nei modelli di Microsoft Foundry v1

Inferenza del piano dati

Creare il riconoscimento vocale

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Responses

Esempi

Example

Creare la trascrizione

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Responses

Esempi

Example

Crea traduzione

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Responses

Esempi

Example

Creare il completamento della chat

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Responses

Esempi

Example

Creare incorporazione

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Responses

Esempi

Example

Elenco valutazioni

Parametri dell'URI

Intestazione della richiesta

Responses

Createeval

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Responses

Ottieni valutazione

Parametri dell'URI

Intestazione della richiesta

Responses

Aggiorna valutazione

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Responses

Elimina valutazione

Parametri dell'URI

Intestazione della richiesta

Responses

Ottenere le esecuzioni di valutazione

Parametri dell'URI

Intestazione della richiesta

Responses

Creare l'esecuzione di valutazione

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Responses

Ottenere l'esecuzione della valutazione

Parametri dell'URI

Intestazione della richiesta

Responses

Annulla esecuzione valutazione

Parametri dell'URI

Intestazione della richiesta

Responses

Deleteevalrun

Parametri dell'URI

Intestazione della richiesta