LINGJING API
接入指南
创建密钥、连接应用、查看用量。更新于 2026-09-15。
账户与 API Key
完整密钥仅在创建后短暂显示。列表里的省略前缀不能使用。不要填写 AWS 密钥、登录密码或第三方会员账号,也不要把密钥发给客服。
连接参数
| 协议 | OpenAI 兼容 Chat Completions,支持范围见下方 |
|---|---|
| Base URL | https://api.lingjing.win/v1 |
| 完整接口地址 | https://api.lingjing.win/v1/chat/completions |
| 认证 | Authorization: Bearer YOUR_LINGJING_API_KEY |
| Haiku Agent | claude-haiku-4.5 支持文本、函数工具及工具结果、流式返回;总上下文 65536 Token,单次输出最高 4096。 |
| 其他首发模型 | GPT-OSS、Nova、Llama 保持文本非流式接口,应用上下文上限 8192。 |
| 请求 ID | Haiku Agent 可省略 Idempotency-Key;省略时每次重试均为新请求。其他模型需提供唯一请求 ID。不要使用固定常量。 |
当前不支持 Anthropic Messages、Responses API、图片、音频、原生思考块或服务端工具。不能将灵境密钥当作 Claude Code、Codex 或 ChatGPT 的登录凭证。
WorkBuddy
5.5.6 基础流程已验证:Haiku 4.5 普通对话、测试文件创建及读取。验证不涵盖全部插件、终端任务和高级功能。
进入“设置 → 模型 → 添加模型”,选择自定义。
| 接口地址 | https://api.lingjing.win/v1/chat/completions |
|---|---|
| API Key | 自己创建的灵境密钥 |
| 模型名称 | claude-haiku-4.5 |
| 工具调用 / 自定义协议 | 开启 |
| 图片输入 / 思考模式 | 关闭 |
| 输入 / 输出 | 61440 / 4096;短任务输出可设 1024 |
测试连接后保存,在新任务中选择此模型。保留默认文件与命令权限确认,不要全局自动批准。
系统提示词、工具定义和历史消息都会计费。本次验证每轮约 5 万输入 Token,即使指令很短也可能产生数美分费用。多轮任务会累计,以灵境账单为准。
其他客户端与兼容范围
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。连续错误先停止任务,调用及重试按用量计费。
CLI 3.0.62 已通过隔离接口完成真实模型文件读取、工具结果回传和结算;扩展端及公网直连待验收。选择 OpenAI Compatible,Base URL 填 https://api.lingjing.win/v1,模型填 claude-haiku-4.5,关闭自动批准。
0.86.2 已通过隔离接口完成真实模型文件修改及结算,正式公网直连待验收。OpenAI 兼容不代表支持全部参数或功能。
官方安装API 请求示例
先在自己的终端设置 LINGJING_API_KEY。实际运行按用量计费;本教程页面不读取密钥或调用模型。
启用 JavaScript 后可查看请求示例。模型列表:GET /v1/models;余额:GET /v1/account,均需 Bearer 密钥。
费用与问题排查
检查完整密钥是否复制正确、是否撤销;不能使用列表前缀。
保留错误文字、请求 ID 和客户端版本。减少历史或附件;不要单独提高客户端上限。
相同请求 ID 不会重复调用。先查询原请求状态,不要盲目更换 ID 重试。
按输入计数和输出上限预留额度,再按上游实际用量结算。检查可消费余额;状态不明确的预留需要核实。
降低并发、遵循 Retry-After,检查账单后再决定重试。不要提交未经脱敏的文件内容或密钥。