API服务说明

一、服务边界

API仅向已获授权并持有有效访问凭据的个人账号提供固定的星见度大模型文本对话能力，模型标识为xingjiandu-llm-v3.2.1；不提供模型选择、其他模型降级或匿名调用。当前为受控测试，不收费；公开注册、API开放状态和额度均以服务端实时返回为准，页面不承诺可自助注册。

二、账号与凭证

• 个人账号须先使用本人有权使用的手机号完成短信验证码核验，并完成18+年龄自我声明及当前规则同意；短信核验不等同于身份或年龄认证，平台不会为此采集身份证、人脸或其他生物识别信息。
• 访问凭证创建后仅完整展示一次，平台后端仅保存不可逆摘要；凭证列表只显示名称、前缀、状态和使用时间。
• 有效凭证可暂时停用并再次启用；停用后不能调用接口，但不会丢失该凭证记录。吊销为不可逆操作，吊销后如需调用须重新创建凭证。
• 每个账号的有效凭证数量受服务端上限约束；停用、启用和吊销均只作用于当前账号下的指定凭证。

三、请求与响应

• 请求使用POST /v1/chat/completions，并通过Authorization: Bearer xjd_sk_*鉴权；请求只接受规定的文本对话结构、长度和频率，未知字段或超出边界会被拒绝。
• stream=false返回完整JSON；stream=true返回SSE。SSE会先在服务端完整生成并完成输出审核、权限复核，再按分块格式下发，因此不是实时逐token输出。
• API响应正文首部包含“【AI生成】”，并同时返回AI生成元数据，调用方不得删除、遮挡或弱化该标识。
• 分钟、滚动24小时与并发配额由服务端动态下发，达到上限返回HTTP 429；服务关闭、模型不可用或安全检查失败时返回明确错误，不返回模拟回答。

四、安全与审计

输入和完整输出均经过内容安全检查；安全服务不可用时失败关闭。平台执行用户级与全局限流，并对必要的请求元数据和安全事件进行脱敏审计。访问凭据不得出现在网页源码、公开仓库、日志、前端存储或客户端可共享内容中。

五、用量与成本口径

响应中的usage与平台成本数据仅用于内部估算和额度护栏，不构成计费结算凭证。请求即使失败也可能已发生上游资源消耗，平台不承诺“失败零成本”；当前受控测试仍不收费，后续如调整将依法另行公示。