LINGJING API

接入指南

创建密钥、连接应用、查看用量。更新于 2026-09-15。

账户与 API Key

  1. 在账户页面注册或登录,确认邮箱验证已完成。
  2. 进入控制台查看模型和售价,补充可用余额。
  3. 在API 密钥页面为应用创建独立密钥,当场点击复制。

完整密钥仅在创建后短暂显示。列表里的省略前缀不能使用。不要填写 AWS 密钥、登录密码或第三方会员账号,也不要把密钥发给客服。

连接参数

协议OpenAI 兼容 Chat Completions,支持范围见下方
Base URLhttps://api.lingjing.win/v1
完整接口地址https://api.lingjing.win/v1/chat/completions
认证Authorization: Bearer YOUR_LINGJING_API_KEY
Haiku Agentclaude-haiku-4.5 支持文本、函数工具及工具结果、流式返回;总上下文 65536 Token,单次输出最高 4096。
其他首发模型GPT-OSS、Nova、Llama 保持文本非流式接口,应用上下文上限 8192。
请求 IDHaiku Agent 可省略 Idempotency-Key;省略时每次重试均为新请求。其他模型需提供唯一请求 ID。不要使用固定常量。

当前不支持 Anthropic Messages、Responses API、图片、音频、原生思考块或服务端工具。不能将灵境密钥当作 Claude Code、Codex 或 ChatGPT 的登录凭证。

WorkBuddy

5.5.6 基础流程已验证:Haiku 4.5 普通对话、测试文件创建及读取。验证不涵盖全部插件、终端任务和高级功能。

WorkBuddy 官方下载 · 官方模型设置说明

进入“设置 → 模型 → 添加模型”,选择自定义。

接口地址https://api.lingjing.win/v1/chat/completions
API Key自己创建的灵境密钥
模型名称claude-haiku-4.5
工具调用 / 自定义协议开启
图片输入 / 思考模式关闭
输入 / 输出61440 / 4096;短任务输出可设 1024

测试连接后保存,在新任务中选择此模型。保留默认文件与命令权限确认,不要全局自动批准。

系统提示词、工具定义和历史消息都会计费。本次验证每轮约 5 万输入 Token,即使指令很短也可能产生数美分费用。多轮任务会累计,以灵境账单为准。

其他客户端与兼容范围

Cherry Studio

2.0.14 的 Haiku 4.5 基础对话已由用户实测通过;完整 Agent 工具流程尚未验收。选择 OpenAI,Base URL 填 https://api.lingjing.win/v1/compat,模型填 claude-haiku-4.5,最大输出 4096,上下文 65536。此兼容模式关闭思考参数、限制超限输出、移除空思考占位;不裁剪输入历史。内置 Claude Code Agent 需启用 Cherry 本地 API 网关,仅监听 127.0.0.1。连续错误先停止任务,调用及重试按用量计费。

官方下载
Cline

CLI 3.0.62 已通过隔离接口完成真实模型文件读取、工具结果回传和结算;扩展端及公网直连待验收。选择 OpenAI Compatible,Base URL 填 https://api.lingjing.win/v1,模型填 claude-haiku-4.5,关闭自动批准。

官方安装
Aider

0.86.2 已通过隔离接口完成真实模型文件修改及结算,正式公网直连待验收。OpenAI 兼容不代表支持全部参数或功能。

官方安装

API 请求示例

先在自己的终端设置 LINGJING_API_KEY。实际运行按用量计费;本教程页面不读取密钥或调用模型。

启用 JavaScript 后可查看请求示例。

模型列表:GET /v1/models;余额:GET /v1/account,均需 Bearer 密钥。

费用与问题排查

401 · 认证失败

检查完整密钥是否复制正确、是否撤销;不能使用列表前缀。

400 · 参数或上下文不支持

保留错误文字、请求 ID 和客户端版本。减少历史或附件;不要单独提高客户端上限。

409 · 已有请求

相同请求 ID 不会重复调用。先查询原请求状态,不要盲目更换 ID 重试。

余额与预留

按输入计数和输出上限预留额度,再按上游实际用量结算。检查可消费余额;状态不明确的预留需要核实。

超时 / 429

降低并发、遵循 Retry-After,检查账单后再决定重试。不要提交未经脱敏的文件内容或密钥。

进入控制台