开发者文档 · 灵梦墨 API

快速开始

从注册到发出第一个请求，大约需要 2 分钟。

1

注册并创建 API 密钥

进入控制台 →「API 密钥」→ 创建密钥。密钥形如 sk-xxxxxxxx，请妥善保管，不要提交到代码仓库。

2

充值额度

在控制台「充值」页面购买额度，可用方式与档位以页面展示为准。每个模型的价格可在模型目录查看实时换算参考价。

3

发送第一个请求

Base URL：https://lingmengmo.com/v1

先设置环境变量 LINGMENGMO_API_KEY，再执行下面的命令，避免把真实密钥写进命令历史。

curl https://lingmengmo.com/v1/chat/completions \
  -H "Authorization: Bearer $LINGMENGMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

💡 所有模型共用一个密钥、一个 Base URL，切换模型只需改 model 字段。

API 端点

Base URL：https://lingmengmo.com/v1（全站统一使用该地址）

方法	路径	说明
GET	/v1/models	列出当前可调用模型
POST	/v1/chat/completions	对话补全（OpenAI 兼容，支持 SSE 流式）
POST	/v1/completions	文本补全（兼容旧接口）
POST	/v1/embeddings	向量化（对支持该能力的模型开放）

认证

所有请求通过 Authorization: Bearer 头携带 API 密钥：

Authorization: Bearer $LINGMENGMO_API_KEY

支持 OpenAI SDK、LangChain 以及各类兼容客户端，只需替换 Base URL 与密钥。

对话补全

与 OpenAI Chat Completions 兼容，支持流式输出：

{
  "model": "deepseek-v4-flash",
  "messages": [
    {"role": "system", "content": "你是一个有帮助的助手"},
    {"role": "user", "content": "介绍一下灵梦墨 API"}
  ],
  "stream": true,
  "max_tokens": 1024
}

参数	类型	说明
model	string	必填，模型名称，见模型目录
messages	array	必填，对话消息列表
stream	bool	是否流式返回（SSE）
max_tokens	int	最大生成 Token 数
temperature	number	采样温度 0–2，默认 1

模型列表

调用 GET /v1/models 获取当前密钥可用的完整模型列表：

curl https://lingmengmo.com/v1/models \
  -H "Authorization: Bearer $LINGMENGMO_API_KEY"

返回示例（节选）：

{
  "object": "list",
  "data": [
    { "id": "deepseek-v4-flash", "object": "model", "owned_by": "deepseek" }
  ]
}

完整模型与实时价格见模型目录。

错误码与排障

错误响应统一为以下结构：

{
  "error": {
    "message": "Invalid token",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

状态码	场景	原因	处理方式
401	Invalid token	API Key 缺失、错误或已删除	检查 `Authorization` 头是否带 Bearer 前缀，必要时重新创建 Key
403	Forbidden	Key 无该模型权限、被禁用或 IP 白名单拦截	检查密钥权限与 IP 白名单配置，确认调用来源 IP
429	Too Many Requests	触发频率限制或并发上限	降低请求频率、增加重试退避，或调整额度
402	Insufficient Quota	额度耗尽	在控制台充值或兑换额度后重试
404	Model Not Found	模型名拼写错误或该模型未开放	对照模型目录使用准确模型名
502 / 超时	Upstream Unavailable	上游渠道故障或响应超时	稍后重试、切换等价模型，并查看服务状态

安全建议

密钥只在服务端使用，通过环境变量或密钥管理服务注入。
不要提交到 Git，不要写入前端代码、浏览器 localStorage 或客户端安装包。
为不同项目创建独立密钥，便于单独撤销与限额。
发现泄露时立即在控制台删除该密钥并重新签发。
为密钥设置额度上限与有效期，缩小潜在影响范围。

⚠ 任何示例都不应包含真实密钥；如你在第三方文章中看到明文 Key，请勿使用。

常见问题

为什么 /v1/models 返回 Invalid token？

该接口需要携带有效密钥。请确认请求头为 Authorization: Bearer sk-...，且密钥未被删除或禁用。

如何切换模型？

只改请求体里的 model 字段，Base URL 与密钥保持不变。

支持流式输出吗？

支持。设置 "stream": true 即可通过 SSE 接收增量内容。

余额与用量在哪里查看？

登录控制台后可查看余额、消耗明细与每次请求的 Token 用量。

退款政策？

退款规则持续完善中，暂不提供统一承诺，请通过技术支持逐笔沟通。