# 象信 AI

> 象信一号（xiangxin-1.0.0）系统一模型 API 文档：发送 state 与带类型的问题（Choice / Score / Noul），一次调用返回带校准概率的结构化答案。每个页面在 URL 后加 .md 可获取 Markdown 原文。

## 文档

- [介绍](https://docs.xiangxinai.cn/introduction.md): 象信一号是象信 AI 的系统一模型：发送状态和带类型的问题，拿回代码可以直接使用的结构化答案。
- [快速开始](https://docs.xiangxinai.cn/introduction/quickstart.md): 想直接上手？从 Playground、HTTP API、Python SDK 到编程智能体，这里是跑通第一个象信请求所需的全部内容。
- [与编程智能体一起使用](https://docs.xiangxinai.cn/introduction/coding-agents.md): 象信一号不是编程智能体背后的大模型；它是你让智能体写进产品里的决策组件。
- [应用场景](https://docs.xiangxinai.cn/concepts/use-case-map.md): 按行业整理的象信应用思路，每个场景附带可以直接改写成问题的判断示例。
- [系统一](https://docs.xiangxinai.cn/concepts/system-one.md): 系统一模型为软件做快速、结构化的判断。象信一号是象信 AI 的第一个系统一模型。
- [状态](https://docs.xiangxinai.cn/concepts/state.md): 什么是状态（state），如何组织它，以及怎样给系统一模型恰好够用的上下文。
- [原语（问题）](https://docs.xiangxinai.cn/primitives.md): 象信的三种问题类型 Choice、Score、Noul：怎么定义、怎么选、返回什么，以及如何在一次请求里问很多个问题。
- [Choice](https://docs.xiangxinai.cn/primitives/choice.md): 从一组你定义的选项中选出一个，返回选中项、每个选项的概率和置信度。
- [Score](https://docs.xiangxinai.cn/primitives/score.md): 按你定义的有序档位给内容打分，返回刻度上的位置、各档概率和置信度。
- [Noul](https://docs.xiangxinai.cn/primitives/noul.md): 让模型判断一个是/否问题，返回答案为"是"的概率。
- [进阶：结构化](https://docs.xiangxinai.cn/primitives/advanced.md): instructions、Choice 选项、Score 档位和 Noul 标准都可以写成 JSON 对象或数组，用结构来表达复杂的问题。
- [置信度](https://docs.xiangxinai.cn/confidence.md): 象信如何表达"有多确定"，置信度与概率有什么区别，以及如何用它控制系统行为。
- [如何用象信构建](https://docs.xiangxinai.cn/concepts/how-to-build-with-system-one.md): 让代码掌控流程，把窄而结构化的判断交给系统一模型——设计 AI 驱动软件的完整方法。
- [AI 入门](https://docs.xiangxinai.cn/introduction/machine-learning-primer.md): 为什么象信训练的是带校准概率的决策模型，而不是为生成好看的文字而优化。
- [模式总览](https://docs.xiangxinai.cn/patterns.md): 用象信一号搭建系统时最常用的四种架构模式，以及它们如何组合在一起。
- [推测式扇出](https://docs.xiangxinai.cn/patterns/fan-out.md): 把系统可能需要的问题——包括只在部分情况下才用得上的问题——一次性全部发出，再由代码挑选有用的答案。
- [置信度门控路由](https://docs.xiangxinai.cn/patterns/confidence-routing.md): 把"答案是什么"与"有多确定"当作两个独立维度：确定时自动执行，不确定时确认或升级。
- [组合评分](https://docs.xiangxinai.cn/patterns/composite-scoring.md): 把一个笼统的综合判断拆成若干原子评分，在代码里归一化、加权合成，权重随时可调。
- [意图路由](https://docs.xiangxinai.cn/patterns/intent-routing.md): 先用一个 Choice 判断请求属于哪一类，再把它分发给确定性代码、专用大模型或人工。

## 实战手册

- [实战手册](https://docs.xiangxinai.cn/cookbooks.md): 端到端的实战案例，展示象信怎样解决真实问题——从几个问题到完整的处理流水线。
- [自洽性：Noul](https://docs.xiangxinai.cn/cookbooks/consistency_noul_cookbook.md): 一份车险理赔单、14 个 Noul 问题、每个条件重复 15 次：象信一号每题概率的平均标准差为 0.0037，没有一题跨过 0.5；再把 0.30–0.70 的概率交给人工复核，同时保留原始数值。
- [自洽性：Choice](https://docs.xiangxinai.cn/cookbooks/consistency_choice_cookbook.md): 一条边界评论 × 8 道审核 Choice 重复 15 次，外加 COLD 数据集 60 条评论 × 5 次；象信的标签从未翻转，但加上 0.60 的「不确定」阈值后，自动处理的比例才是真正要权衡的量。
- [并行提问](https://docs.xiangxinai.cn/cookbooks/parallel_questions.md): 在《个人信息保护法》全文上跑 13 个问题的合规速查：一次请求问完比逐题请求便宜 11.3 倍，答案不变。
- [重排序](https://docs.xiangxinai.cn/cookbooks/rerank.md): 在 DuRetrieval 的 4,085 段中文网页语料上，BM25 为 80 个查询各取 30 个候选，再对每个「查询–候选」对问一个 Noul 重排，首位命中率从 66% 升到 81%，nDCG@10 从 0.54 升到 0.73。
- [逐行检索](https://docs.xiangxinai.cn/cookbooks/semantic_find.md): 给 GitHub 服务条款中文版的 212 行编号，用一个 Choice 在行号里找答案、一个 Noul 判断文档里到底有没有答案。35 个查询中，有答案的 24 个全部在前 3 名命中（第一名命中 75%，BM25 为 25%）；exists 概率把「有答案」和「没答案」完全分开。
- [结构恢复](https://docs.xiangxinai.cn/cookbooks/autoformat.md): 43 段 Vue 中文文档去掉格式、硬换行后，两次请求还原 Markdown：拼回断行的准确率 93.5%（纯标点规则 80.9%），块类型逐字正确率 72.4%，不如规则的 86.0%；象信拼行加规则分类的组合最好（87.1%）。
- [函数调用](https://docs.xiangxinai.cn/cookbooks/function_calling.md): 60 条中文行情指令、10 个普通 Python 函数：一次请求问出函数名和全部封闭集合参数，函数选对 98.3%，整次调用完全正确 83.3%；只自动执行置信度 ≥ 0.8 的 30%，这部分全对。
- [技能推荐](https://docs.xiangxinai.cn/cookbooks/skill_suggestion.md): 从 Hermes 智能体的 208 个真实技能里为每轮对话挑至多一个：两次象信请求先粗排、再复核前三名。131 条请求上，81 条有对应技能的推荐对 72 条、推错 2 条，50 条无技能可用的请求只误推 1 条。
- [知识图谱实体对齐](https://docs.xiangxinai.cn/cookbooks/entity_alignment.md): 中文与英文百科的 420 个产品候选对，每对一次象信请求（1 个 Score + 3 个 Noul）：按最近档位路由后，自动合并 118 对、精确率 99.2%、召回率 100%，另有 49 对送人工复核。
- [RAG 段落分类](https://docs.xiangxinai.cn/cookbooks/classifying_rag_passages.md): 在 T2Ranking 的 60 条真实搜索查询、720 个检索段落上，每段一次象信请求（4 个 Noul），由代码路由；进入提示词的段落精确率从 BM25 同等数量的 0.537 提到 0.638，并拦下植入的提示注入。
- [引用核查](https://docs.xiangxinai.cn/cookbooks/citation_check.md): 对照《个人信息保护法》原文核查 40 条引用：字符串匹配揪出捏造引文，一个 Choice 判断条文是否支撑结论；置信度 ≥ 0.8 自动通过的 25 条全部正确，2 处误判都被转给了人工。
- [大模型护栏](https://docs.xiangxinai.cn/cookbooks/llm_guardrails.md): 用公开中文安全数据集的 850 条消息做测试：大模型应用的入口和出口各发一次象信请求，阈值写在代码里。strict 策略下，风险请求与攻击的标记率为 78.5%（不含角色扮演组为 89.0%），150 条普通请求无一误报；风险回复拦截 81.7%，220 条正常回复只误拦 2 条。
- [日期抽取](https://docs.xiangxinai.cn/cookbooks/date_extraction_cookbook.md): 让象信读出日期的写法和各个部分（几月、几号、哪一年、昨天还是周一），再由代码拼成日期并按发文日推算相对日期。29 篇真实政府文件与外交部记者会实录、62 个日期：57 个正确，5 个错误的置信度都不高于 0.26。
- [预解析值抽取](https://docs.xiangxinai.cn/cookbooks/pre_parsed_value_extraction_cookbook.md): 正则先找出候选的邮箱、电话和金额，象信只负责选出问题要的那一个，代码原样复制并规范化。32 篇真实政府公告、134 个字段：文中有值的 112 个全部选对，置信度 ≥ 0.60 自动通过的 108 个无一出错。
- [层级分类](https://docs.xiangxinai.cn/cookbooks/hierarchical_classification.md): 沿申万行业分类（31 → 134 → 346 类）每层问一个 Choice，把 100 家 A 股公司的年报主营业务描述分到三级行业；并行束搜索（K=3）把三级准确率从贪心的 56% 提到 59%，救回 6 家、弄错 3 家。
- [基于置信度的分类](https://docs.xiangxinai.cn/cookbooks/classification_using_confidence.md): 用一个 Choice 把 160 家 A 股公司的年报主营业务描述分到 91 个行业大类，再读答案自带的置信度：有把握的一半报告大类（准确率 75%），没把握的一半退到上一级报告（从 51% 升到 63%），每家公司只需一次请求。
- [演示](https://docs.xiangxinai.cn/demos.md): 可交互的示例，展示象信能做到什么。
- [智能家居助手演示](https://docs.xiangxinai.cn/demos/smart-home.md): 一句中文指令、一次象信请求：20 个推测式问题并行求值，代码挑出有用的答案执行设备动作；44 条示例指令上 43 条全部字段正确。
- [无障碍访问 {#accessibility}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/best-practices__accessibility.md)
- [性能优化 {#performance}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/best-practices__performance.md)
- [生产部署 {#production-deployment}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/best-practices__production-deployment.md)
- [安全 {#security}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/best-practices__security.md)
- [KeepAlive {#keepalive}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/built-ins__keep-alive.md)
- [Suspense {#suspense}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/built-ins__suspense.md)
- [Teleport {#teleport}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/built-ins__teleport.md)
- [TransitionGroup {#transitiongroup}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/built-ins__transition-group.md)
- [Transition {#transition}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/built-ins__transition.md)
- [异步组件 {#async-components}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/components__async.md)
- [透传 Attributes {#fallthrough-attributes}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/components__attrs.md)
- [组件事件 {#component-events}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/components__events.md)
- [Props {#props}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/components__props.md)
- [依赖注入 {#provide-inject}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/components__provide-inject.md)
- [组件注册 {#component-registration}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/components__registration.md)
- [插槽 Slots {#slots}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/components__slots.md)
- [组件 v-model {#component-v-model}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/components__v-model.md)
- [创建一个 Vue 应用 {#creating-a-vue-application}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__application.md)
- [Class 与 Style 绑定 {#class-and-style-bindings}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__class-and-style.md)
- [组件基础 {#components-basics}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__component-basics.md)
- [计算属性 {#computed-properties}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__computed.md)
- [条件渲染 {#conditional-rendering}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__conditional.md)
- [事件处理 {#event-handling}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__event-handling.md)
- [表单输入绑定 {#form-input-bindings}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__forms.md)
- [生命周期钩子 {#lifecycle-hooks}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__lifecycle.md)
- [列表渲染 {#list-rendering}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__list.md)
- [响应式基础 {#reactivity-fundamentals}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__reactivity-fundamentals.md)
- [模板引用 {#template-refs}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__template-refs.md)
- [模板语法 {#template-syntax}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__template-syntax.md)
- [侦听器 {#watchers}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/essentials__watchers.md)
- [动画技巧 {#animation-techniques}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/extras__animation.md)
- [组合式 API 常见问答 {#composition-api-faq}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/extras__composition-api-faq.md)
- [深入响应式系统 {#reactivity-in-depth}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/extras__reactivity-in-depth.md)
- [响应性语法糖 {#reactivity-transform}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/extras__reactivity-transform.md)
- [渲染函数 & JSX {#render-functions-jsx}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/extras__render-function.md)
- [渲染机制 {#rendering-mechanism}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/extras__rendering-mechanism.md)
- [使用 Vue 的多种方式 {#ways-of-using-vue}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/extras__ways-of-using-vue.md)
- [Vue 与 Web Components {#vue-and-web-components}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/extras__web-components.md)
- [简介 {#introduction}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/introduction.md)
- [快速上手 {#quick-start}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/quick-start.md)
- [组合式函数 {#composables}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/reusability__composables.md)
- [自定义指令 {#custom-directives}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/reusability__custom-directives.md)
- [插件 {#plugins}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/reusability__plugins.md)
- [路由 {#routing}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/scaling-up__routing.md)
- [单文件组件 {#single-file-components}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/scaling-up__sfc.md)
- [服务端渲染 (SSR) {#server-side-rendering-ssr}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/scaling-up__ssr.md)
- [状态管理 {#state-management}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/scaling-up__state-management.md)
- [测试 {#testing}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/scaling-up__testing.md)
- [工具链 {#tooling}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/scaling-up__tooling.md)
- [TypeScript 与组合式 API {#typescript-with-composition-api}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/typescript__composition-api.md)
- [TypeScript 与选项式 API {#typescript-with-options-api}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/typescript__options-api.md)
- [搭配 TypeScript 使用 Vue {#using-vue-with-typescript}](https://docs.xiangxinai.cn/cookbooks/code/autoformat/data/raw/typescript__overview.md)
- [best-practices__accessibility_4](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/best-practices__accessibility_4.md)
- [best-practices__accessibility_5](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/best-practices__accessibility_5.md)
- [best-practices__performance_1](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/best-practices__performance_1.md)
- [best-practices__performance_3](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/best-practices__performance_3.md)
- [best-practices__performance_5](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/best-practices__performance_5.md)
- [built-ins__keep-alive_1](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/built-ins__keep-alive_1.md)
- [built-ins__keep-alive_4](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/built-ins__keep-alive_4.md)
- [built-ins__teleport_5](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/built-ins__teleport_5.md)
- [built-ins__transition-group_1](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/built-ins__transition-group_1.md)
- [built-ins__transition_9](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/built-ins__transition_9.md)
- [components__attrs_1](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/components__attrs_1.md)
- [components__events_1](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/components__events_1.md)
- [components__registration_3](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/components__registration_3.md)
- [essentials__component-basics_6](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/essentials__component-basics_6.md)
- [essentials__event-handling_7](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/essentials__event-handling_7.md)
- [essentials__event-handling_8](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/essentials__event-handling_8.md)
- [essentials__forms_3](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/essentials__forms_3.md)
- [essentials__list_8](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/essentials__list_8.md)
- [essentials__template-syntax_2](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/essentials__template-syntax_2.md)
- [extras__composition-api-faq_1](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/extras__composition-api-faq_1.md)
- [extras__composition-api-faq_2](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/extras__composition-api-faq_2.md)
- [extras__composition-api-faq_3](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/extras__composition-api-faq_3.md)
- [extras__composition-api-faq_5](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/extras__composition-api-faq_5.md)
- [extras__reactivity-transform_6](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/extras__reactivity-transform_6.md)
- [extras__render-function_2](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/extras__render-function_2.md)
- [extras__rendering-mechanism_3](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/extras__rendering-mechanism_3.md)
- [extras__ways-of-using-vue_3](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/extras__ways-of-using-vue_3.md)
- [extras__ways-of-using-vue_5](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/extras__ways-of-using-vue_5.md)
- [extras__web-components_4](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/extras__web-components_4.md)
- [introduction_2](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/introduction_2.md)
- [introduction_4](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/introduction_4.md)
- [quick-start_3](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/quick-start_3.md)
- [reusability__composables_7](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/reusability__composables_7.md)
- [scaling-up__sfc_2](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/scaling-up__sfc_2.md)
- [scaling-up__ssr_1](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/scaling-up__ssr_1.md)
- [scaling-up__ssr_3](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/scaling-up__ssr_3.md)
- [scaling-up__state-management_1](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/scaling-up__state-management_1.md)
- [scaling-up__state-management_4](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/scaling-up__state-management_4.md)
- [scaling-up__testing_5](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/scaling-up__testing_5.md)
- [scaling-up__testing_7](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/scaling-up__testing_7.md)
- [scaling-up__tooling_10](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/scaling-up__tooling_10.md)
- [scaling-up__tooling_3](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/scaling-up__tooling_3.md)
- [scaling-up__tooling_7](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/markdown/scaling-up__tooling_7.md)
- [walkthrough](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/walkthrough.md)
- [walkthrough_v1_split](https://docs.xiangxinai.cn/cookbooks/code/autoformat/results/walkthrough_v1_split.md)
- [tables](https://docs.xiangxinai.cn/cookbooks/code/consistency_noul_cookbook/results/tables.md)
- [GitHub 服务条款](https://docs.xiangxinai.cn/cookbooks/code/semantic_find/data/github_tos_zh.raw.md)

## 参考

- [模型](https://docs.xiangxinai.cn/models.md): 象信一号的版本号、价格、速率限制、上下文长度、别名、定价与额度，以及模型列表接口。
- [API 参考](https://docs.xiangxinai.cn/api.md): 象信评估接口 POST /v1/systemone 的完整 HTTP 参考：请求、问题类型、响应、答案类型与错误。
- [智能体 Skill](https://docs.xiangxinai.cn/agent-skill.md): 给 Claude Code、Codex、Cursor 等编程智能体安装象信 Skill，让它们写出正确、地道的象信集成代码。
- [法律](https://docs.xiangxinai.cn/legal.md): 象信AI 的用户协议、隐私政策、可接受使用政策与数据处理说明，生效日期 2026 年 10 月 1 日。
- [象信一号 1.0 已知短板](https://docs.xiangxinai.cn/model-jaggedness/xiangxin-1.0.md): 象信一号 1.0 目前已知的薄弱环节，以及每一种情况下更可靠的做法。
- [客户端 SDK](https://docs.xiangxinai.cn/sdk.md): 安装象信客户端 SDK，在应用里使用带类型的问题与答案。
- [象信 Python SDK](https://docs.xiangxinai.cn/sdk/python.md): 安装象信 Python SDK，用异步或同步客户端调用象信一号。
- [用法](https://docs.xiangxinai.cn/sdk/python/usage.md): 使用象信 Python SDK 的常见写法与模式。
- [更新日志](https://docs.xiangxinai.cn/sdk/python/changelog.md): 象信 Python SDK 各版本的变更记录。
- [API 参考](https://docs.xiangxinai.cn/sdk/python/api.md): 象信 API 的 Python 客户端参考。
- [异步客户端](https://docs.xiangxinai.cn/sdk/python/api/clients/async.md): 用 AsyncXiangxinClient 提问、列出模型，并配置异步的象信 API 请求。
- [同步客户端](https://docs.xiangxinai.cn/sdk/python/api/clients/sync.md): 用 XiangxinClient 提问、列出模型，并配置同步的象信 API 请求。
- [问题](https://docs.xiangxinai.cn/sdk/python/api/types/questions.md): Python SDK 中的 state、问题对象（Noul / Choice / Score）与问题字典。
- [答案与响应](https://docs.xiangxinai.cn/sdk/python/api/types/responses.md): Python SDK 中 system_one 的响应、各类答案、用量与模型列表的数据结构。
- [重试](https://docs.xiangxinai.cn/sdk/python/api/retries.md): 用 RetryPolicy 配置 SDK 的重试次数、可重试状态码、指数退避与 retry-after 处理。
- [通用类型](https://docs.xiangxinai.cn/sdk/python/api/types/common.md): Python SDK 中 state、instructions 与描述共用的 JSON 类型别名。
- [异常](https://docs.xiangxinai.cn/sdk/python/api/exceptions.md): Python SDK 的异常层级、各异常的属性与处理建议。
- [常量](https://docs.xiangxinai.cn/sdk/python/api/constants.md): Python SDK 公开的环境变量名与客户端默认值。
- [JavaScript SDK](https://docs.xiangxinai.cn/sdk/javascript.md): 象信 AI 官方 JavaScript / TypeScript SDK（@xiangxinai/sdk），在 Node.js、Deno、Bun 与边缘运行时中调用象信一号。
- [更新日志](https://docs.xiangxinai.cn/sdk/javascript/changelog.md): 象信 AI JavaScript / TypeScript SDK（@xiangxinai/sdk）各版本的变更记录。
- [API 参考](https://docs.xiangxinai.cn/sdk/javascript/api.md): @xiangxinai/sdk 导出的全部类、接口、类型别名、变量与函数，由 SDK 源码中的 TSDoc 注释生成。
- [可接受使用政策](https://docs.xiangxinai.cn/acceptable-use.md): 使用象信AI 时禁止的用途与行为：违法活动、未成年人保护、干扰服务，以及违规处理与举报方式。
- [数据处理说明与零留存](https://docs.xiangxinai.cn/data-processing.md): 象信AI 代客户处理 API 数据时的角色、处理范围、保存期限、零内容留存（ZDR）、安全措施、事件通知与受托方。
- [隐私政策](https://docs.xiangxinai.cn/privacy.md): 象信AI 隐私政策：收集哪些信息、如何使用、不使用客户数据训练模型、请求内容最多保存 30 天、数据存放在中国大陆、你的权利与联系方式。
- [Class: APIConnectionError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/APIConnectionError.md): 没有拿到 HTTP 响应：DNS 失败、连接被拒绝或中断、响应体读取中断等。
- [Class: APIError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/APIError.md): 服务端返回了不成功（非 2xx）的 HTTP 响应。
- [Class: APIPromise<T>](https://docs.xiangxinai.cn/sdk/javascript/api/classes/APIPromise.md): 解析结果的 Promise，同时可以拿到 HTTP 响应。直接 await 得到解析后的数据；调用 .withResponse() 额外得到 Response 与请求 ID。非 2xx 响应会以 APIError 拒绝。
- [Class: APIResponseValidationError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/APIResponseValidationError.md): HTTP 成功，但响应体不是预期的结构。
- [Class: APITimeoutError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/APITimeoutError.md): 单次尝试超过了配置的超时时间。
- [Class: APIUserAbortError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/APIUserAbortError.md): 调用方通过 AbortSignal 取消了请求。不会重试。
- [Class: AuthenticationError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/AuthenticationError.md): 401：API 密钥缺失、无效或已禁用。
- [Class: BadRequestError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/BadRequestError.md): 400：请求格式错误。
- [Class: InsufficientBalanceError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/InsufficientBalanceError.md): 402：组织余额不足，请到控制台充值。不会自动重试。
- [Class: InternalServerError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/InternalServerError.md): 其他 5xx：服务端内部错误。
- [Class: NotFoundError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/NotFoundError.md): 404：资源不存在，例如未知模型。
- [Class: OverloadedError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/OverloadedError.md): 529：服务过载或模型后端暂不可用，稍后重试即可。
- [Class: PermissionDeniedError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/PermissionDeniedError.md): 403：无权访问。
- [Class: RateLimitError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/RateLimitError.md): 429：超出速率限制。
- [Class: UnprocessableEntityError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/UnprocessableEntityError.md): 422：请求未通过服务端校验（选项过多、超出 token 上限等）。不会自动重试。
- [Class: XiangxinClient](https://docs.xiangxinai.cn/sdk/javascript/api/classes/XiangxinClient.md): 象信 AI API 客户端。
- [Class: XiangxinError](https://docs.xiangxinai.cn/sdk/javascript/api/classes/XiangxinError.md): 所有 SDK 错误的基类；配置错误（如缺少 API 密钥）也直接抛出此类。
- [Function: choice()](https://docs.xiangxinai.cn/sdk/javascript/api/functions/choice.md): 创建单选题。选项名会被推断为字面量，答案的 choice 因此带有精确类型。
- [Function: noul()](https://docs.xiangxinai.cn/sdk/javascript/api/functions/noul.md): 创建是非题（noul = “no or yes”），答案是“成立”的概率。
- [Function: score()](https://docs.xiangxinai.cn/sdk/javascript/api/functions/score.md): 创建打分题。criteria 由低到高排列，第 i 项是 i 分的描述；至少两档。
- [Interface: ChoiceAnswer<T>](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/ChoiceAnswer.md): 单选题答案。
- [Interface: ChoiceQuestion<T>](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/ChoiceQuestion.md): 单选题：在若干命名选项中选出最可能的一个。
- [Interface: Logger](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/Logger.md): 与 console 兼容的日志接口。
- [Interface: ModelCard](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/ModelCard.md): 单个可用模型的元数据。
- [Interface: Models](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/Models.md): 模型资源：client.models。
- [Interface: NoulAnswer](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/NoulAnswer.md): 是非题答案。
- [Interface: NoulCriteria](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/NoulCriteria.md): Noul 问题中“是 / 否”两种结果的可选描述。
- [Interface: NoulQuestion](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/NoulQuestion.md): 是非题：答案是“成立”的概率。
- [Interface: Questions](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/Questions.md): 问题名 → 问题；答案用同样的名字返回。
- [Interface: RequestOptions](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/RequestOptions.md): 单次调用的选项，覆盖客户端设置。
- [Interface: RetryPolicy](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/RetryPolicy.md): 重试配置。客户端与单次调用都可以只传部分字段，未传的字段沿用上一层设置。
- [Interface: ScoreAnswer<T>](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/ScoreAnswer.md): 打分题答案。
- [Interface: ScoreQuestion<T>](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/ScoreQuestion.md): 打分题：按有序量表给出期望分数。
- [Interface: SystemOneRequest<Q>](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/SystemOneRequest.md): systemOne 的请求参数。
- [Interface: SystemOneRequestPayload](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/SystemOneRequestPayload.md): POST /v1/systemone 的请求体（模型已解析）。
- [Interface: SystemOneResult<Q>](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/SystemOneResult.md): systemOne 的结果。
- [Interface: Usage](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/Usage.md): 本次请求的 token 用量。
- [Interface: WithResponse<T>](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/WithResponse.md): 解析后的数据、HTTP 响应与请求 ID。
- [Interface: XiangxinClientConfig](https://docs.xiangxinai.cn/sdk/javascript/api/interfaces/XiangxinClientConfig.md): 客户端配置。显式传入的值优先于环境变量，其次是 SDK 默认值。
- [Type Alias: Answer](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/Answer.md): 任意一种答案。
- [Type Alias: ChoiceCriteria](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/ChoiceCriteria.md): 选项名 → 描述（null 表示不加描述）。最多 255 个选项。
- [Type Alias: Description](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/Description.md): 选项或档位的描述；null 表示不加描述。
- [Type Alias: EntryType](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/EntryType.md): 文本、JSON 对象或数组，或 null；用于 instructions 与各项描述。
- [Type Alias: EnvVar](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/EnvVar.md): ENV 中任意一个环境变量名。
- [Type Alias: Fetch](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/Fetch.md): 与全局 fetch 兼容的实现。
- [Type Alias: JsonObject](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/JsonObject.md): JSON 对象。
- [Type Alias: JsonValue](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/JsonValue.md): 任意 JSON 值。
- [Type Alias: LogLevel](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/LogLevel.md): 日志级别；off 关闭日志。
- [Type Alias: Question](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/Question.md): 以 type 区分的问题。
- [Type Alias: ResultFor<T>](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/ResultFor.md): 由问题类型推出答案类型，保留 Choice 的选项名与 Score 的档位。
- [Type Alias: ScoreCriteria](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/ScoreCriteria.md): 从 0 分起、由低到高的各档描述，至少两档（API 接受 2–10 档）。
- [Type Alias: ScoreLegend<T>](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/ScoreLegend.md): 档位 → 该档描述。
- [Type Alias: ScoreOf<T>](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/ScoreOf.md): 量表的档位键：定长元组得到各下标的字符串字面量（\"0\" | \"1\" | …），否则为 number。
- [Type Alias: State](https://docs.xiangxinai.cn/sdk/javascript/api/type-aliases/State.md): 要判断的内容：文本、JSON 对象或数组。
- [Variable: DEFAULT_BASE_URL](https://docs.xiangxinai.cn/sdk/javascript/api/variables/DEFAULT_BASE_URL.md): 默认 API 根地址。
- [Variable: DEFAULT_MODEL](https://docs.xiangxinai.cn/sdk/javascript/api/variables/DEFAULT_MODEL.md): 默认模型。
- [Variable: DEFAULT_RETRY_POLICY](https://docs.xiangxinai.cn/sdk/javascript/api/variables/DEFAULT_RETRY_POLICY.md): 默认重试策略。
- [Variable: DEFAULT_TIMEOUT_MS](https://docs.xiangxinai.cn/sdk/javascript/api/variables/DEFAULT_TIMEOUT_MS.md): 每次尝试的默认超时（毫秒）。
- [Variable: ENV](https://docs.xiangxinai.cn/sdk/javascript/api/variables/ENV.md): 客户端读取的环境变量名。显式传入的配置永远优先于环境变量；空白值会被忽略。
- [Variable: LOG_LEVELS](https://docs.xiangxinai.cn/sdk/javascript/api/variables/LOG_LEVELS.md): 支持的日志级别，从最详细到最安静。
- [Variable: MODEL_MS_HEADER](https://docs.xiangxinai.cn/sdk/javascript/api/variables/MODEL_MS_HEADER.md): 模型推理耗时（毫秒）响应头。
- [Variable: REQUEST_ID_HEADER](https://docs.xiangxinai.cn/sdk/javascript/api/variables/REQUEST_ID_HEADER.md): 请求 ID 响应头。
- [Variable: TOTAL_MS_HEADER](https://docs.xiangxinai.cn/sdk/javascript/api/variables/TOTAL_MS_HEADER.md): 网关总耗时（毫秒）响应头。
- [Variable: VERSION](https://docs.xiangxinai.cn/sdk/javascript/api/variables/VERSION.md): SDK 版本号。
- [用户协议](https://docs.xiangxinai.cn/terms.md): 象信AI 用户协议：账户与组织、API 密钥、预付费与额度、知识产权、免责与责任限制、法律适用与争议解决。

## 其他

- [社区与支持](https://docs.xiangxinai.cn/community.md): 加入象信 AI 微信交流群、邮件联系团队或在 GitHub 反馈问题。

## 工具

- [象信智能体 Skill（SKILL.md）](https://docs.xiangxinai.cn/skills/xiangxin/SKILL.md): 给编程智能体的象信 API 使用指南