开发者文档

玄霖问易提供 OpenAI 兼容的易学知识问答接口，可将万卷古籍支撑的专业回答接入您的网站或应用。

接口地址

POST https://api.xuanlinyi.com/v1/chat/completions

OpenAI 兼容协议。支持中、英、德、西、日、韩、俄七种语言提问，自动以您的语言回答。

鉴权

在请求头携带您的 API Key：

Authorization: Bearer sk-xl-xxxxxxxxxxxxxxxx

Key 在个人中心的“开发者功能”中创建。

请求示例

curl -X POST https://api.xuanlinyi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xl-xxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"xuanlin-qa","messages":[{"role":"user","content":"论建禄格的取用"}]}'

参数

参数	说明
messages	必填。对话消息，取最后一条 user 消息为问题。
max_tokens	可选，默认 1800，上限 4096；计费前会按该上限预留余额，结算后退回差额。
temperature	可选，默认 0.15，范围 0-1.5。
stream	暂不支持流式。

响应

标准 OpenAI 格式，额外返回 xuanlin 字段：回答语言、专业领域、资料检索条数、历法校验状态、本次花费与剩余余额。资料库原文片段不会通过接口返回。

错误码

HTTP	code	含义
401	invalid_api_key	Key 缺失或无效
402	insufficient_balance	余额不足
429	rate_limited	触发限流（60 次/分钟/Key）
502	upstream_error	生成服务暂时不可用

计费说明

项目	标准
匿名网页问答	免费。每个浏览器访客每天 5 次；网络地址仅设较高的防滥用安全阈值。
注册体验金	注册即送 ¥10，用于体验网页问答与 API 调用。
网页问答（注册用户）	按 token 计费：输入 ¥0.015 / 1K、输出 ¥0.060 / 1K；标准档单次最高 ¥0.30，深度档单次最高 ¥0.60。
API 调用	与网页问答同单价，但不适用网页档位封顶，按实际 token 从余额扣费。
余额不足	网页问答退回每日 5 次免费额度；API 请求返回 402 错误。
充值	Stripe 安全支付，最低 ¥10。充值后自动恢复全部权限。

计费公式：原始费用（元）= 输入 tokens ÷ 1000 × 0.015 + 输出 tokens ÷ 1000 × 0.060。网页问答再按所选档位封顶；API 按原始费用结算。

费用示例：一次典型问答（约 4,000 输入 tokens + 800 输出 tokens）约 ¥0.11。

余额查询：登录后在个人中心实时查看余额、调用次数与消费明细。更多问题见常见问题。

版权说明

回答内容来自公开资料的整理。如认为内容侵犯您的权益，请通过版权申诉页提交删除请求。