开发者文档

一个 Base URL、一个密钥接入主流大模型。以下内容与线上接口行为保持一致,示例均可直接复制执行。

OpenAI 兼容 流式响应 统一计费 实时服务状态

快速开始

从开户到发出第一个请求,大约需要 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 兼容,支持流式输出:

POST /v1/chat/completions
{
  "model": "deepseek-v4-flash",
  "messages": [
    {"role": "system", "content": "你是一个有帮助的助手"},
    {"role": "user", "content": "介绍一下灵梦墨 API"}
  ],
  "stream": true,
  "max_tokens": 1024
}
参数类型说明
modelstring必填,模型名称,见模型目录
messagesarray必填,对话消息列表
streambool是否流式返回(SSE)
max_tokensint最大生成 Token 数
temperaturenumber采样温度 0–2,默认 1

模型列表

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

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

返回示例(节选):

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

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

错误码与排障

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

错误响应
{
  "error": {
    "message": "Invalid token",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}
状态码场景原因处理方式
401Invalid token API Key 缺失、错误或已删除 检查 Authorization 头是否带 Bearer 前缀,必要时重新创建 Key
402insufficient_quota 账户余额不足(网关将上游的 403 余额不足统一改写为 402) 充值后重试;响应体含 lm_code=INSUFFICIENT_BALANCE
403Forbidden IP 白名单拦截等网关侧拒绝 检查密钥的 IP 白名单与调用来源 IP
429Too Many Requests 触发频率限制或并发上限 降低请求频率、增加重试退避,或调整额度
402Insufficient Quota 额度耗尽 在控制台充值或兑换额度后重试
404Model Not Found 模型名拼写错误或该模型未开放 对照 模型目录 使用准确模型名
502 / 超时Upstream Unavailable 上游渠道故障或响应超时 稍后重试、切换等价模型,并查看 服务状态

安全建议

  • 密钥只在服务端使用,通过环境变量或密钥管理服务注入。
  • 不要提交到 Git,不要写入前端代码、浏览器 localStorage 或客户端安装包。
  • 为不同项目创建独立密钥,便于单独撤销与限额。
  • 发现泄露时立即在控制台删除该密钥并重新签发。
  • 为密钥设置额度上限与有效期,缩小潜在影响范围。
⚠ 任何示例都不应包含真实密钥;如你在第三方文章中看到明文 Key,请勿使用。

常见问题

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

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

如何切换模型?

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

支持流式输出吗?

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

余额与用量在哪里查看?

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

退款政策?

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