功能与文档

灵犀 · 开发者服务平台

功能范围

下表为平台当前已开放与规划中的能力。实际可调用的模型、参数与额度，以控制台与价格页面公示为准。

能力说明状态
统一接口接入 OpenAI 兼容的请求格式，一套调用代码接入多家服务商的模型能力；支持文本对话、图像处理、语音合成、向量等能力方向。 已开放
多服务商路由与故障切换 按模型配置主备服务商，主渠道超时或异常时自动切换备选，减少单点故障影响。 已开放
在线工具 开箱即用的网页工具，无需自行集成 SDK；支持模板化工作流。 已开放
额度计费与用量明细 以额度（积分）计费，调用后实时扣减，控制台可查逐笔消耗与失败记录。 已开放
开发者文档与 API 参考 请求参数、返回结构、错误码、限流规则的完整说明。 建设中
可复用模板工作流 把常用调用流程固化为可复用的模板，含定价与分享机制。 规划中
组织与团队协作 子账号、权限分配、团队用量汇总与配额管理。 规划中

上表描述的是技术接入形态与工作流能力。具体模型类型、模态覆盖与生成类能力的对外说明，以平台取得相应备案或许可并在站内公示后为准；公示前不对相关能力作出描述或承诺。

快速开始

第一步 · 注册与获取额度

  1. 使用手机号或邮箱注册账号，完成身份验证。
  2. 进入控制台领取初始免费额度。额度为平台计费单位，用于抵扣调用消耗。
  3. 在控制台「访问凭证」页创建 API Key。密钥仅在创建时完整展示，请妥善保存。

请勿将 API Key 提交到公开代码仓库或在前端代码中硬编码。发现密钥泄露请立即删除并重新创建，同时通过 lixinwork@163.com 通知我们。

第二步 · 确认可用模型与计费

  1. 控制台「模型列表」页列出当前可调用的模型标识、上下文长度与额度消耗标准。
  2. 调用前可先用控制台的在线试用做一次小流量验证。

第三步 · 发起调用

  1. 按下方「接口调用」示例发起请求。
  2. 在控制台「用量明细」查看逐笔调用记录、耗时与扣减额度；调用失败的记录会单独标注。

接口调用

基础地址

BASE_URL=https://lingxitoken.com/v1

接入地址以控制台「模型列表」页公示的 base_url 为准；不同接入通道可能使用不同的访问域名，配置时直接复制控制台给出的地址即可。

示例：文本对话（OpenAI 兼容格式）

curl -s "$BASE_URL/chat/completions" \
  -H "Authorization: Bearer $LINGXI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<控制台模型列表中的模型标识>",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

示例：Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LINGXI_API_KEY"],
    base_url="https://lingxitoken.com/v1",
)

resp = client.chat.completions.create(
    model="<控制台模型列表中的模型标识>",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

返回与错误处理

状态码含义处理建议
200调用成功，额度已按实际消耗扣减正常处理返回内容
400请求参数不合法按错误信息修正参数后重试
401API Key 无效或已失效检查密钥是否被删除或轮换
429触发限流或额度不足按响应头提示退避重试，或在控制台调整限额
5xx服务端或上游异常平台已配置主备自动切换；仍失败请稍后重试

调用成功并返回结果的计为已消耗；因平台侧原因导致调用失败且未返回结果的，不予扣减。失败记录会在控制台「用量明细」中单独标注，核实后按《退款与计费规则》处理。

限流与并发

默认限流阈值与并发上限按账号与模型分别设定，具体数值在控制台「模型列表」页展示。超出阈值会返回 429。

常见问题

Q1 · 额度怎么算？

平台以额度（积分）作为计费单位。不同模型的额度消耗标准以控制台「模型列表」页与价格页面公示为准。实际扣减以后台调用记录为准。

Q2 · 调用失败了为什么还扣了额度？

请先在控制台「用量明细」查看该笔记录的状态。系统对失败记录有单独标记，标记为异常的记录会按《退款与计费规则》退还或补发额度。若标记正常但您认为异常，请把请求 ID（request_id）与时间发给我们核实。

Q3 · 额度能退吗？

未消耗的额度可申请退款；已消耗部分不予退还；因平台原因造成的失败与错误扣费，核实后予以退还。详见《退款与计费规则》。

Q4 · 怎么开发票？

充值时填写的开票信息会用于开具与实际支付金额一致的发票。退款后的红冲按适用规定处理。

Q5 · 换了服务器会影响我的 Key 吗？

不会。API Key 与账号绑定，平台基础设施调整不影响您的密钥有效性。平台侧如因安全原因轮换密钥，会通过站内消息与邮件提前通知。

Q6 · 支持哪些客户端？

任何支持 OpenAI 兼容请求格式的客户端均可直接接入，包括 OpenAI 官方 SDK、各类第三方工具的"自定义 OpenAI 接口"配置方式，以及标准 HTTP 客户端。

Q7 · 平台会留存我提交的内容吗？

平台按完成服务所必需的最短期限保存处理过程数据，默认不将您的输入内容用于模型训练，具体见《隐私政策》第三条。

Q8 · 遇到问题找谁？

请通过 lixinwork@163.com 联系，我们将在 15 个工作日内响应。涉及版权与侵权投诉的，请按《投诉举报与侵权通知处理规则》提交材料，可获得更快处理。

运营主体：浙江数智产融科技有限公司（统一社会信用代码 91330102MA2KH2541C）
灵犀AI 为浙江数智产融科技有限公司旗下产品品牌
浙ICP备2026077439号