VoiceResponse interface

Uma resposta de voz persistente representando uma reviravolta de inferência do modelo dentro de uma conversa. Nos resultados da lista, a output projeção pode ser omitida; recupere a resposta completa (GET .../responses/{response_id}) ou a rota dos itens de resposta paginados (GET .../responses/{response_id}/items) para seus itens de saída. created_at / completed_at são extensões duráveis de ordenação da Foundry.

Extends

Propriedades

audio

A configuração de áudio usada para a resposta, incluindo o formato de voz e áudio usado para a saída.

completed_at

O carimbo de tempo do Unix (em segundos) para quando a resposta foi concluída.

conversation_id

O id da conversa a que essa resposta pertence.

created_at

O carimbo de data do Unix (em segundos) indica quando a resposta foi criada.

id

O id único da resposta.

metadata

Um conjunto de pares-chave-valor anexados à resposta.

output

Os itens de saída produzidos pela resposta. Pode ser omitido nos resultados da lista; recuperar a resposta completa (GET .../responses/{response_id}) ou usar a rota paginada dos itens de resposta (GET .../responses/{response_id}/itens) para seus itens de saída. Cada item response_id também faz um link para essa resposta na lista de itens em nível de conversa.

temperature

A temperatura de amostragem usada para a resposta.

Propriedades herdadas

max_output_tokens

Número máximo de tokens de saída para uma resposta de um único assistente, incluindo chamadas de ferramenta, que foi usado nessa resposta.

object

O tipo de objeto deve ser realtime.response.

output_modalities

O conjunto de modalidades que o modelo usou para responder, atualmente os únicos valores possíveis são [\"audio\"], [\"text\"]. A saída de áudio sempre inclui uma transcrição de texto. Configurar a saída para modo text desativa a saída de áudio do modelo.

status

O status final da resposta (completed, cancelled, failed, ou incomplete, in_progress).

status_details

Detalhes adicionais sobre o status.

usage

Estatísticas de uso para a Resposta, isso corresponderá à faturação. Uma sessão de API em tempo real manterá um contexto de conversa e adicionará novos Itens à conversa, assim, a saída de turnos anteriores (tokens de texto e áudio) se tornará a entrada para turnos posteriores.

Detalhes da propriedade

audio

A configuração de áudio usada para a resposta, incluindo o formato de voz e áudio usado para a saída.

audio?: VoiceResponseAudio

Valor da propriedade

completed_at

O carimbo de tempo do Unix (em segundos) para quando a resposta foi concluída.

completed_at?: Date

Valor da propriedade

Date

conversation_id

O id da conversa a que essa resposta pertence.

conversation_id: string

Valor da propriedade

string

created_at

O carimbo de data do Unix (em segundos) indica quando a resposta foi criada.

created_at?: Date

Valor da propriedade

Date

id

O id único da resposta.

id: string

Valor da propriedade

string

metadata

Um conjunto de pares-chave-valor anexados à resposta.

metadata?: Record<string, string>

Valor da propriedade

Record<string, string>

output

Os itens de saída produzidos pela resposta. Pode ser omitido nos resultados da lista; recuperar a resposta completa (GET .../responses/{response_id}) ou usar a rota paginada dos itens de resposta (GET .../responses/{response_id}/itens) para seus itens de saída. Cada item response_id também faz um link para essa resposta na lista de itens em nível de conversa.

output?: RealtimeConversationItemUnion[]

Valor da propriedade

temperature

A temperatura de amostragem usada para a resposta.

temperature?: number

Valor da propriedade

number

Detalhes das propriedades herdadas

max_output_tokens

Número máximo de tokens de saída para uma resposta de um único assistente, incluindo chamadas de ferramenta, que foi usado nessa resposta.

max_output_tokens?: number | "inf"

Valor da propriedade

number | "inf"

Herdado deVoiceResponseBase.max_output_tokens

object

O tipo de objeto deve ser realtime.response.

object?: "realtime.response"

Valor da propriedade

"realtime.response"

Herdado doVoiceResponseBase.object

output_modalities

O conjunto de modalidades que o modelo usou para responder, atualmente os únicos valores possíveis são [\"audio\"], [\"text\"]. A saída de áudio sempre inclui uma transcrição de texto. Configurar a saída para modo text desativa a saída de áudio do modelo.

output_modalities?: ("text" | "audio")[]

Valor da propriedade

("text" | "audio")[]

Herdado deVoiceResponseBase.output_modalities

status

O status final da resposta (completed, cancelled, failed, ou incomplete, in_progress).

status?: "failed" | "in_progress" | "cancelled" | "completed" | "incomplete"

Valor da propriedade

"failed" | "in_progress" | "cancelled" | "completed" | "incomplete"

Herdado deVoiceResponseBase.status

status_details

Detalhes adicionais sobre o status.

status_details?: RealtimeResponseStatusDetails

Valor da propriedade

Herdado deVoiceResponseBase.status_details

usage

Estatísticas de uso para a Resposta, isso corresponderá à faturação. Uma sessão de API em tempo real manterá um contexto de conversa e adicionará novos Itens à conversa, assim, a saída de turnos anteriores (tokens de texto e áudio) se tornará a entrada para turnos posteriores.

usage?: RealtimeResponseUsage

Valor da propriedade

Herdado deVoiceResponseBase.usage