客户端 SDK
我们的客户端 SDK 为象信 API 提供带类型的问题与答案，并按默认重试策略自动处理限流和临时故障。
选择一个 SDK，查看安装方法、示例和 API 细节。
Python
安装 Python 客户端 SDK，发出第一个请求。
JavaScript / TypeScript
安装 JavaScript 客户端 SDK，发出第一个带类型的请求。
两个 SDK 对照
| Python | JavaScript / TypeScript | |
|---|---|---|
| 安装 | pip install xiangxin-sdk | npm install @xiangxinai/sdk |
| 导入 | from xiangxin import XiangxinClient | import { XiangxinClient } from '@xiangxinai/sdk' |
| 运行环境 | Python ≥ 3.10 | Node.js ≥ 18、Deno、Bun、边缘函数（全局 fetch） |
| 调用 | client.system_one(state=..., questions=...) | client.systemOne({ state, questions }) |
| 写问题 | Noul(...)、Choice(...)、Score(...) 或字典 | noul()、choice()、score() 或普通对象 |
| 类型 | pydantic 模型；可继承 SystemOneResponse 声明字段 | 答案类型从问题自动推断，选项名是字面量联合 |
| 异步 | AsyncXiangxinClient | 所有方法本身返回 Promise |
| 响应头 | resp.request_id、with_raw_response | .withResponse() |
| 取消 | — | AbortSignal |
| 文档 | Python SDK | JavaScript SDK |
你也可以用任何语言直接调用 HTTP API。