外观

象信控制台
接口

Interface: XiangxinClientConfig

客户端配置。显式传入的值优先于环境变量，其次是 SDK 默认值。

Interface: XiangxinClientConfig ​

Client options. Explicit values take precedence over environment variables, then SDK defaults.

属性 ​

apiKey? ​

ts
optional apiKey?: string;

API 密钥（必填），默认读取 XIANGXIN_API_KEY。 / API key; falls back to XIANGXIN_API_KEY.

baseURL? ​

ts
optional baseURL?: string;

API 根地址，默认读取 XIANGXIN_BASE_URL，否则为 https://api.xiangxinai.cn。 / API root; falls back to XIANGXIN_BASE_URL, then https://api.xiangxinai.cn.

dangerouslyAllowBrowser? ​

ts
optional dangerouslyAllowBrowser?: boolean;

允许在浏览器中使用。这会把 API 密钥暴露给页面访问者，默认 false。 请改用服务端代理。 / Allow use in browsers, exposing the API key. Default false.

defaultHeaders? ​

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

附加到每个请求的请求头（不能覆盖 Authorization / Accept）。 / Extra headers for every request.

defaultModel? ​

ts
optional defaultModel?: string;

请求省略 model 时使用的模型，默认读取 XIANGXIN_DEFAULT_MODEL，否则为 xiangxin-latest。 / Default model; falls back to XIANGXIN_DEFAULT_MODEL, then xiangxin-latest.

fetch? ​

ts
optional fetch?: Fetch;

自定义 fetch（代理、测试等），默认使用全局 fetch。 / Custom fetch; defaults to global fetch.

logger? ​

ts
optional logger?: Logger;

日志器，默认带前缀的 console。 / Logger; defaults to a prefixed console.

logLevel? ​

ts
optional logLevel?: LogLevel;

日志级别，默认读取 XIANGXIN_LOG，否则为 warn。info 每个请求一行摘要， debug 额外输出请求头与正文（鉴权头会被隐去，正文不会）。 / Log level; falls back to XIANGXIN_LOG, then warn.

retry? ​

ts
optional retry?: Partial<RetryPolicy>;

重试策略的部分覆盖。 / Partial retry overrides.

timeout? ​

ts
optional timeout?: number;

每次尝试的超时（毫秒），默认 30000。 / Timeout per attempt in ms. Default 30000.