接口接口:TypeSafeClientConfig

客户端选项。显式值优先于环境变量,其次为 SDK 默认值。

属性

apiKey?

ts
optional apiKey?: string;

必需的 API 密钥;回退到 TYPESAFE_API_KEY。


baseURL?

ts
optional baseURL?: string;

API 根地址;回退到 TYPESAFE_BASE_URL,再回退到 https://api.typesafe.ai。


dangerouslyAllowBrowser?

ts
optional dangerouslyAllowBrowser?: boolean;

允许在浏览器中使用,这会将 API 密钥暴露给页面用户。默认值:false。


defaultHeaders?

ts
optional defaultHeaders?: Record<string, string>;

附加的请求头;单次调用指定的请求头优先。


defaultModel?

ts
optional defaultModel?: string;

默认模型;回退到 TYPESAFE_DEFAULT_MODEL,再回退到 jev-latest。


fetch?

ts
optional fetch?: Fetch;

用于传输配置或测试的自定义 HTTP fetch 实现。默认值:全局 fetch。


logger?

ts
optional logger?: Logger;

按 logLevel 及以上级别过滤的日志记录器。默认值:带前缀的 console。


logLevel?

ts
optional logLevel?: LogLevel;

日志级别;回退到 TYPESAFE_LOG_LEVEL,再回退到 warn。 info 记录请求摘要;debug 额外记录请求头和请求体。 已知的凭据请求头会被脱敏;请求体不会。


retry?

ts
optional retry?: Partial<RetryPolicy>;

重试覆盖项;省略的字段使用 RetryPolicy 中的默认值。


timeout?

ts
optional timeout?: number;

单次尝试的超时时间(毫秒),不设总重试预算。默认值:10000。