Authorization: Bearer $XINGJIANDU_API_KEY完整密钥只在创建成功时展示一次，列表仅返回前缀。开发者能力
API调用
使用同一手机号账号创建个人密钥，在服务端程序中调用星见度大模型。当前为受控测试，不收费，开放状态与配额均以服务端实时返回为准。
正在读取状态API开放状态和配额以服务端实时结果为准。
✦
正在核对登录状态
正在读取当前账号，请稍候。
调用说明
兼容接口示例
支持非流式JSON和审核后缓冲式SSE。网页只用于管理密钥，请从你的服务端发起调用。curl https://api.xingjd.com/v1/chat/completions \
-H "Authorization: Bearer $XINGJIANDU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "xingjiandu-llm-v3.2.1",
"messages": [{"role": "user", "content": "请给出门店内容规划建议"}],
"stream": false
}'固定模型：xingjiandu-llm-v3.2.1，不提供模型列表或选择器。
AI标识：直接使用返回的 choices[0].message.content，不要删除开头的“【AI生成】”。
跨域：浏览器来源仅允许后端配置的域名，不使用通配CORS。建议仅从服务端调用。
SSE：stream=true 时，服务端会先完成整段生成、内容安全审核和权限复核，再以SSE分块下发；这不是实时逐token输出。
接口约定
鉴权与请求参数
请求体只接受下列字段；密钥必须放在服务端请求头中，不要写入浏览器代码、移动端安装包、公开仓库或日志。POST /v1/chat/completionsContent-Type: application/jsonAPI只接受文本消息，不接受图片、音频或文件。stream: false成功返回一个完整JSON对象，HTTP状态为200。stream: true响应为text/event-stream；终帧后发送data: [DONE]。| 字段 | 要求 | 类型 | 说明 |
|---|---|---|---|
model | 必填 | string | 固定为 xingjiandu-llm-v3.2.1，其他值返回 model_not_supported。 |
messages | 必填 | array | 1至50条；role仅支持system、user、assistant，最后一条必须是user。 |
messages[].content | 必填 | string | 单条1至10000字符；总输入还受服务端实时上下文与API上限约束。 |
stream | 选填 | boolean | 默认false；false返回完整JSON，true返回审核后缓冲式SSE。 |
stream_options.include_usage | 选填 | boolean | 仅用于stream=true；为true时终帧包含usage。 |
max_tokens | 选填 | integer | 正整数；不得超过服务端当前输出上限。 |
非流式成功：choices[0].message.content，正文自带“【AI生成】”；同时返回 request_id、content_id、usage 和AI标识元数据。
SSE帧：各帧保持 id、request_id、content_id、model 和 created 一致；首帧含assistant角色和AI标识，终帧的 finish_reason 为stop或length，最后发送 data: [DONE]。
配额：分钟上限、滚动24小时上限、并发上限及当前调用数以页面实时状态为准。达到任一上限均返回HTTP 429；不要在客户端写死当前数值。
用量说明：usage 与平台成本数据仅用于内部估算和额度护栏，不构成计费结算凭证。失败请求也可能已发生上游资源消耗，平台不承诺“失败零成本”；当前受控测试仍不收费。
安全：输入与完整输出均经过内容安全检查。SSE也只会在完整输出审核通过后下发；安全服务不可用时失败关闭。
错误处理
HTTP状态与稳定错误码
非2xx响应的JSON结构为{"detail":{"code":"...","message":"..."}}。程序应优先按code分支，并记录request上下文，不要记录完整密钥或用户原文。| HTTP | code | 含义 |
|---|---|---|
| 400 | model_not_supported | model不是固定模型标识 |
| 400 | invalid_messages | 消息数量、角色或末条消息不符合要求 |
| 400 | max_tokens_exceeded / input_too_long | 输出上限或输入长度超限 |
| 400 | content_blocked | 输入或输出未通过内容安全审核 |
| 401 | invalid_api_key | 密钥无效、已吊销或格式错误 |
| 403 | model_chat_consent_required | 当前规则同意已失效 |
| 403 | model_api_account_blocked / model_api_access_revoked | 账号或调用期间的访问权限已失效 |
| 422 | 字段校验详情 | 请求体包含未知字段或字段类型不正确 |
| 429 | rate_limit | 分钟或滚动24小时配额已达到上限 |
| 429 | concurrency_limit | 当前账号并发调用数已达到上限 |
| 503 | model_api_disabled / model_api_not_configured | 个人API尚未开放或配置未完成 |
| 503 | model_unavailable / cost_limit_reached | 生成服务或平台当前用量不可用 |
| 503 | content_safety_unavailable | 内容安全服务暂不可用，失败关闭 |