OpenAIClientOptionsWithAzureAgent interface

Ampliaron las opciones de cliente de OpenAI para incluir la configuración de endpoints de Azure Agent.

Extends

ClientOptions

Propiedades

azureConfig

Azure Agent endpoint configuration.

Propiedades heredadas

adminAPIKey

Por defecto es proces.env['OPENAI_ADMIN_KEY'].

apiKey

Clave API usada para autenticación.

  • Acepta una cadena estática o una función asíncrona que se resuelve a una cadena.
  • Por defecto es proces.env['OPENAI_API_KEY'].
  • Cuando se proporciona una función, se invoca al construir cabeceras de autenticación de portadores para cada intento, incluyendo reintentos y llamadas directas buildRequest() . El resultado de cada invocación se utiliza para su propia petición.
  • La función debe devolver una cadena no vacía; de lo contrario, se lanza un OpenAIErrr.
  • Si la función se lanza, el error se envuelve en un OpenAIError con el error original disponible como cause.
  • Mutuamente excluyente con workloadIdentity.
baseURL

Anular la URL base predeterminada de la API, por ejemplo, "https://api.example.com/v2/"

Por defecto es proces.env['OPENAI_BASE_URL'].

credential

Credencial de certificado de primera clase creada con fromX509 .openai/auth/x509-transport

dangerouslyAllowBrowser

Por defecto, no se permite el uso de esta biblioteca en el lado del cliente, ya que corre el riesgo de exponer tus credenciales secretas de la API a los atacantes. Solo configura esta opción true si entiendes los riesgos y tienes las medidas adecuadas de mitigación.

dataResidency

Selecciona un endpoint regional de OpenAI. Esto anula una URL heredada o de la base del entorno y es mutuamente excluyente con una URL explícita baseURL o provider. La disponibilidad depende de tu proyecto y modelo; no se realiza ningún respaldo. null y undefined dejar sin cambios la resolución de URL base ordinaria.

defaultHeaders

Cabeceras predeterminadas para incluir en cada petición a la API.

Estos pueden eliminarse en solicitudes individuales estableciendo explícitamente la cabecera en null opciones de solicitud.

defaultQuery

Parámetros de consulta predeterminados para incluir en cada solicitud a la API.

Estos pueden eliminarse en solicitudes individuales estableciendo explícitamente el parámetro en undefined las opciones de solicitud.

fetch

Especifica una implementación de función personalizada fetch .

Si no se proporciona, esperamos que se fetch defina globalmente.

fetchOptions

Opciones adicionales RequestInit que se pasarán a fetch las llamadas. Las propiedades serán anuladas por solicitud fetchOptions.

logger

Pon el leñador.

Por defecto es globalThis.console.

logLevel

Establece el nivel del log.

Por defecto se pone en process.env['OPENAI_LOG'] o 'warn' si no está activado.

maxRetries

El número máximo de veces que el cliente intentará una solicitud en caso de fallo temporal, como un error de red o un error 5XX del servidor.

organization

Por defecto es proces.env['OPENAI_ORG_ID'].

project

Por defecto es proces.env['OPENAI_PROJECT_ID'].

provider

Configura este cliente para que utilice un proveedor de API de terceros. Mutuamente excluyentes con autenticación y baseURL opciones de alto nivel.

timeout

El tiempo máximo (en milisegundos) que el cliente debe esperar a una respuesta del servidor antes de expirar una sola petición.

Ten en cuenta que los tiempos de espera de las solicitudes se vuelven a intentar por defecto, así que en el peor de los casos puedes esperar mucho más tiempo antes de que la promesa tenga éxito o falle.

Node.js fetch aplica tiempos de espera independientes de respuesta y inactividad en el cuerpo, normalmente siendo de cinco minutos, incluso cuando este tiempo de espera es más largo. Para aumentarlos, instala undici y configura un Agente con la implementación de fetch correspondiente:

import { Agent, fetch } from 'undici';

const timeout = 20 * 60 * 1000;
const client = new OpenAI({
  timeout,
  fetch,
  fetchOptions: {
    dispatcher: new Agent({ headersTimeout: timeout, bodyTimeout: timeout }),
  },
});
webhookSecret

Por defecto es proces.env['OPENAI_WEBHOOK_SECRET'].

workloadIdentity

Configuración de identidad de carga de trabajo para autenticación de intercambio de tokens OAuth2. Mutuamente excluyente con apiKey.

x509Transport

Aprobado, Node.js congelado transporte de certificado solo necesario para la identidad de carga de trabajo X.509.

Detalles de las propiedades

azureConfig

Azure Agent endpoint configuration.

azureConfig?: AzureAgentConfig

Valor de propiedad

Detalles de las propiedades heredadas

adminAPIKey

Por defecto es proces.env['OPENAI_ADMIN_KEY'].

adminAPIKey?: string | null

Valor de propiedad

string | null

Heredado de OpenAIClientOptions.adminAPIKey

apiKey

Clave API usada para autenticación.

  • Acepta una cadena estática o una función asíncrona que se resuelve a una cadena.
  • Por defecto es proces.env['OPENAI_API_KEY'].
  • Cuando se proporciona una función, se invoca al construir cabeceras de autenticación de portadores para cada intento, incluyendo reintentos y llamadas directas buildRequest() . El resultado de cada invocación se utiliza para su propia petición.
  • La función debe devolver una cadena no vacía; de lo contrario, se lanza un OpenAIErrr.
  • Si la función se lanza, el error se envuelve en un OpenAIError con el error original disponible como cause.
  • Mutuamente excluyente con workloadIdentity.
apiKey?: string | ApiKeySetter | null

Valor de propiedad

string | ApiKeySetter | null

Heredado de OpenAIClientOptions.apiKey

baseURL

Anular la URL base predeterminada de la API, por ejemplo, "https://api.example.com/v2/"

Por defecto es proces.env['OPENAI_BASE_URL'].

baseURL?: string | null

Valor de propiedad

string | null

Heredado de OpenAIClientOptions.baseURL

credential

Credencial de certificado de primera clase creada con fromX509 .openai/auth/x509-transport

credential?: X509Credential

Valor de propiedad

X509Credential

Heredado de OpenAIClientOptions.credential

dangerouslyAllowBrowser

Por defecto, no se permite el uso de esta biblioteca en el lado del cliente, ya que corre el riesgo de exponer tus credenciales secretas de la API a los atacantes. Solo configura esta opción true si entiendes los riesgos y tienes las medidas adecuadas de mitigación.

dangerouslyAllowBrowser?: boolean

Valor de propiedad

boolean

Heredado de OpenAIClientOptions.dangerouslyAllowBrowser

dataResidency

Selecciona un endpoint regional de OpenAI. Esto anula una URL heredada o de la base del entorno y es mutuamente excluyente con una URL explícita baseURL o provider. La disponibilidad depende de tu proyecto y modelo; no se realiza ningún respaldo. null y undefined dejar sin cambios la resolución de URL base ordinaria.

dataResidency?: DataResidency | null

Valor de propiedad

DataResidency | null

Heredado de OpenAIClientOptions.dataResidency

defaultHeaders

Cabeceras predeterminadas para incluir en cada petición a la API.

Estos pueden eliminarse en solicitudes individuales estableciendo explícitamente la cabecera en null opciones de solicitud.

defaultHeaders?: HeadersLike

Valor de propiedad

HeadersLike

Heredado de OpenAIClientOptions.defaultHeaders

defaultQuery

Parámetros de consulta predeterminados para incluir en cada solicitud a la API.

Estos pueden eliminarse en solicitudes individuales estableciendo explícitamente el parámetro en undefined las opciones de solicitud.

defaultQuery?: Record<string, string | undefined>

Valor de propiedad

Record<string, string | undefined>

Heredado de OpenAIClientOptions.defaultQuery

fetch

Especifica una implementación de función personalizada fetch .

Si no se proporciona, esperamos que se fetch defina globalmente.

fetch?: Fetch

Valor de propiedad

Fetch

Heredado de OpenAIClientOptions.fetch

fetchOptions

Opciones adicionales RequestInit que se pasarán a fetch las llamadas. Las propiedades serán anuladas por solicitud fetchOptions.

fetchOptions?: MergedRequestInit

Valor de propiedad

MergedRequestInit

Heredado de OpenAIClientOptions.fetchOptions

logger

Pon el leñador.

Por defecto es globalThis.console.

logger?: Logger

Valor de propiedad

Logger

Heredado de OpenAIClientOptions.logger

logLevel

Establece el nivel del log.

Por defecto se pone en process.env['OPENAI_LOG'] o 'warn' si no está activado.

logLevel?: LogLevel

Valor de propiedad

LogLevel

Heredado de OpenAIClientOptions.logLevel

maxRetries

El número máximo de veces que el cliente intentará una solicitud en caso de fallo temporal, como un error de red o un error 5XX del servidor.

maxRetries?: number

Valor de propiedad

number

Heredado de OpenAIClientOptions.maxRetries

organization

Por defecto es proces.env['OPENAI_ORG_ID'].

organization?: string | null

Valor de propiedad

string | null

Heredado de OpenAIClientOptions.organization

project

Por defecto es proces.env['OPENAI_PROJECT_ID'].

project?: string | null

Valor de propiedad

string | null

Heredado de OpenAIClientOptions.project

provider

Configura este cliente para que utilice un proveedor de API de terceros. Mutuamente excluyentes con autenticación y baseURL opciones de alto nivel.

provider?: Provider

Valor de propiedad

Provider

Heredado de OpenAIClientOptions.provider

timeout

El tiempo máximo (en milisegundos) que el cliente debe esperar a una respuesta del servidor antes de expirar una sola petición.

Ten en cuenta que los tiempos de espera de las solicitudes se vuelven a intentar por defecto, así que en el peor de los casos puedes esperar mucho más tiempo antes de que la promesa tenga éxito o falle.

Node.js fetch aplica tiempos de espera independientes de respuesta y inactividad en el cuerpo, normalmente siendo de cinco minutos, incluso cuando este tiempo de espera es más largo. Para aumentarlos, instala undici y configura un Agente con la implementación de fetch correspondiente:

import { Agent, fetch } from 'undici';

const timeout = 20 * 60 * 1000;
const client = new OpenAI({
  timeout,
  fetch,
  fetchOptions: {
    dispatcher: new Agent({ headersTimeout: timeout, bodyTimeout: timeout }),
  },
});
timeout?: number

Valor de propiedad

number

Heredado de OpenAIClientOptions.timeout

webhookSecret

Por defecto es proces.env['OPENAI_WEBHOOK_SECRET'].

webhookSecret?: string | null

Valor de propiedad

string | null

Heredado de OpenAIClientOptions.webhookSecret

workloadIdentity

Configuración de identidad de carga de trabajo para autenticación de intercambio de tokens OAuth2. Mutuamente excluyente con apiKey.

workloadIdentity?: WorkloadIdentity | X509WorkloadIdentity

Valor de propiedad

WorkloadIdentity | X509WorkloadIdentity

Heredado de OpenAIClientOptions.workloadIdentity

x509Transport

Aprobado, Node.js congelado transporte de certificado solo necesario para la identidad de carga de trabajo X.509.

x509Transport?: X509Transport

Valor de propiedad

X509Transport

Heredado de OpenAIClientOptions.x509Transport