客户端选项。显式值优先于环境变量,其次为 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。