DOCS

使用教程

兼容 OpenAI 接口格式。任何支持自定义 Base URL 的客户端，改成我们的地址即可直接用。

获取 API Key
基础调用（curl / Python / Node）
可用模型
流式输出
常见客户端配置
常见问题

1. 获取 API Key

打开注册页，用邮箱注册并登录。
进入控制台，点「新建 Key」。
复制生成的 sk-lf- 开头的字符串 —— 它只显示一次，请立即保存。

Key 等同于你的账号密码，不要发到群里、不要提交到公开仓库。一旦泄露，立刻到控制台吊销并新建。

2. 基础调用

三个参数固定：Base URL、API Key、model。

curl

curl https://lingapifeng.dpdns.org/v1/chat/completions \
  -H "Authorization: Bearer sk-lf-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-luna",
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

Python（openai 官方库）

from openai import OpenAI

client = OpenAI(
    base_url="https://lingapifeng.dpdns.org/v1",
    api_key="sk-lf-你的Key",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5.5",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js（fetch）

const r = await fetch("https://lingapifeng.dpdns.org/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-lf-你的Key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gemini-2.5-flash",
    messages: [{ role: "user", content: "你好" }],
  }),
});
const data = await r.json();
console.log(data.choices[0].message.content);

3. 可用模型

模型名直接用上游原始 ID，不需要加前缀。以下为常用示例：

模型名	厂商	输入 $/M	输出 $/M
free-ling-3.0	免费体验	0	0
free-lfm-2.5	免费体验	0	0
deepseek-flash	DeepSeek	0.370	1.470
deepseek-v4-pro	DeepSeek	1.650	4.950
gpt-oss-20b	OpenAI	0.023	0.117
gpt-oss-120b	OpenAI	0.048	0.221
gpt-6-luna	OpenAI	0.130	0.650
gpt-4o-mini	OpenAI	0.195	0.780
deepseek-v4-flash	DeepSeek	0.103	0.207
gemini-2.5-flash	Google	0.390	3.250
claude-sonnet-5.5	Anthropic	2.60	13.00
claude-opus-5.5	Anthropic	5.20	26.00

价格以价格页为准；某个模型当前能不能用，直接调 GET /v1/models 看实时列表（上游没配置的模型不会出现）。

4. 流式输出

在请求体里加 "stream": true，服务端会按 SSE 逐字返回：

curl -N https://lingapifeng.dpdns.org/v1/chat/completions \
  -H "Authorization: Bearer sk-lf-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-luna","stream":true,"messages":[{"role":"user","content":"数到十"}]}'

标准 SSE 格式，以 data: 开头，最后一条是 data: [DONE]，所有 OpenAI SDK 都能直接解析。

5. 常见客户端配置

Cherry Studio / ChatBox / NextChat：模型服务选「OpenAI」，API 地址填 https://lingapifeng.dpdns.org/v1，Key 填你自己的。
Cline / Continue / RooCode：Provider 选「OpenAI Compatible」，Base URL 同上。
沉浸式翻译：翻译服务选「OpenAI」，自定义接口地址同上。
Cursor / Windsurf：需开启 Override OpenAI Base URL，填同样的地址。

注意：地址结尾的 /v1 必须保留；有些客户端会自动补 /v1，那就只填到域名。

6. 常见问题

返回 401 Unauthorized

Key 写错、已吊销或过期。检查 Authorization 头是否为 Bearer sk-lf-... 格式（Bearer 后面有空格）。

返回 402 / 提示余额不足

额度用完。到控制台看余额，联系管理员充值。

返回 429 Too Many Requests

两种可能：① 你调用太快，触发本站限速；② 上游模型当前繁忙。稍等几秒重试，或换一个模型。

返回 502 / 504

上游超时。长文本生成建议开启流式（stream），可显著降低超时概率。

支持 function calling / 多模态吗？

支持 function calling（tools 字段原样透传）。图片输入取决于所选模型是否支持，例如 gpt-6-luna 支持视觉输入。

本服务为第三方中转。请勿用于违法违规用途，模型输出内容由上游服务商生成，本站不对输出准确性负责。