← 返回文档首页

领风平台 API 接入文档

按协议接入领风网关 · 先打通文本，再按场景扩展

先看这个：你要准备 3 样东西

没有 Key、或应用里没启用模型，后面任何示例都会失败。

准备项从哪里拿长什么样
接口地址（Base URL）固定使用https://api.lingfengtoken.com/v1
API Key控制台 → 应用管理 → 应用 → API Key → 创建sk-lf- 开头的一长串
模型 ID应用详情 → 模型权限里已启用的名称须与请求里 model 字段完全一致

1在控制台完成配置

按顺序做完，再往下看命令行示例。大约 3 分钟。

1）创建应用

控制台 → 应用管理 → 新建应用，进入应用详情。

2）启用模型

应用详情 → 模型权限，勾选要用的模型并保存；记下模型 ID 原文（区分大小写）。

3）创建 Key

同一应用 → API Key → 创建，立刻复制完整明文。列表里带 * 的是脱敏，不能当真实 Key。

再往下前自检

  • □已有 sk-lf- 开头的完整 Key
  • □该 Key 所属应用里，目标模型已启用
  • □已抄下模型 ID（区分大小写）

2打通第一次调用（文本对话）

绝大多数业务从这里开始。先把这条跑通，再考虑图片 / 视频。

你要调用的接口

项值
方法POST
完整 URLhttps://api.lingfengtoken.com/v1/chat/completions
请求头Authorization: Bearer <你的 sk-lf Key>
请求头Content-Type: application/json

请求体要填什么

字段填什么
model应用里已启用的模型 ID
messages对话内容（至少一条 user）
stream第一次建议 false

一键示例

把示例里的 Key 和 model 换成你的，在终端执行：

curl · Chat Completions
curl -X POST "https://api.lingfengtoken.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-lf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "你好，请用一句话介绍你自己"}],
    "stream": false
  }'

怎样算成功？

现象含义你该做什么
返回 JSON，含 choices / 回复文字成功可接入 SDK 或业务代码
401 / KEY_INVALIDKey 不对或未带 Bearer检查头格式与完整明文 Key
403 / APP_MODEL_NOT_ALLOWED应用未启用该 model回模型权限勾选，或改正拼写
402 / BALANCE_INSUFFICIENT余额不足联系领风运营入账

用 OpenAI 官方 SDK 时怎么填

SDK 配置项填领风的值
base_url / baseURLhttps://api.lingfengtoken.com/v1
api_key你的 sk-lf-…
model应用里已启用的模型 ID

3需要流式回复时

第一次建议先用 stream: false。确认能通后，再改成流式。终端会一段段吐出数据；结束时通常有 data: [DONE]。

curl · streaming
curl -N -X POST "https://api.lingfengtoken.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-lf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "hi"}],
    "stream": true
  }'

4按场景选别的协议

文本跑通后再看。模型族不同，路径往往不同——选错路径是最常见的失败原因。

我想做的事用哪条路方法与路径Base
普通文本对话Chat CompletionsPOST /v1/chat/completionshttps://api.lingfengtoken.com/v1
Codex / Responses 客户端ResponsesPOST /v1/responseshttps://api.lingfengtoken.com/v1
OpenAI 系图片（如 gpt-image）ImagesPOST /v1/images/generationshttps://api.lingfengtoken.com/v1
豆包 Seedream 出图豆包图片POST /doubao/v1/images/generationshttps://lingfengtoken.com/api
豆包视频任务豆包视频POST /doubao/v1/videos/generations/submithttps://lingfengtoken.com/api
通义出图 / 万相视频通义前缀/qwen/api/v1/services/aigc/...https://lingfengtoken.com/api
可灵文生视频KlingPOST /v1/kling/text-to-video/submithttps://lingfengtoken.com/api/v1
Vidu 文生视频ViduPOST /v1/vidu/text-to-video/submithttps://lingfengtoken.com/api/v1
Gemini 原生（含出图）GeminiPOST /gemini/v1beta/models/{model}:generateContenthttps://lingfengtoken.com/api

Responses（Codex 等）

工具要求 wire_api = responses 时使用。

curl
curl -X POST "https://api.lingfengtoken.com/v1/responses" \
  -H "Authorization: Bearer sk-lf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-codex",
    "input": "ping",
    "max_output_tokens": 64
  }'
配置项值
base_urlhttps://api.lingfengtoken.com/v1
api_key你的 sk-lf-…
wire_apiresponses

OpenAI 系图片

豆包 Seedream 请改用下一节，不要打本地址。

curl
curl -X POST "https://api.lingfengtoken.com/v1/images/generations" \
  -H "Authorization: Bearer sk-lf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "a simple red apple",
    "size": "1024x1024"
  }'

豆包图片（Seedream 等）

完整 URL = https://lingfengtoken.com/api + /doubao/...；视频需 submit 后再查询 taskId。

curl
curl -X POST "https://lingfengtoken.com/api/doubao/v1/images/generations" \
  -H "Authorization: Bearer sk-lf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-0",
    "prompt": "a simple red apple",
    "size": "1024x1024",
    "response_format": "url",
    "watermark": false
  }'

通义图片

部分模型要求 messages[].content 为数组，不要只传纯字符串。

curl
curl -X POST "https://lingfengtoken.com/api/qwen/api/v1/services/aigc/image-generation/generation" \
  -H "Authorization: Bearer sk-lf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2.0-glb",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [{"text": "a simple red apple"}]
        }
      ]
    },
    "parameters": { "size": "1024*1024" }
  }'

可灵文生视频

先 submit，再用 describe 轮询。字段名常为 PascalCase；Duration 有时需字符串。

curl
curl -X POST "https://lingfengtoken.com/api/v1/kling/text-to-video/submit" \
  -H "Authorization: Bearer sk-lf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "Model": "kling-v2-5-turbo",
    "Prompt": "a cat walking on the street",
    "Duration": "5"
  }'

Gemini 原生（含出图）

鉴权仍用 Bearer sk-lf，不要用 x-goog-api-key。将 URL 中模型名换成应用里已启用的 ID。

curl
curl -X POST "https://lingfengtoken.com/api/gemini/v1beta/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer sk-lf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "Generate a tiny solid red square icon, minimal"}]
      }
    ]
  }'

常用工具怎么接

工具能不能用怎么配
Cherry Studio能Provider 选 OpenAI 兼容；Base URL = https://api.lingfengtoken.com/v1；Key = sk-lf-…
OpenCode能opencode.json 里 baseURL、apiKey 改成领风
OpenAI Codex CLI能wire_api=responses；Base / Key 同上
Claude Code（Anthropic 原生）暂不能需要 /claude 原生路径，领风未开放；请改用 OpenAI 兼容方式

计费

问题答案
扣什么币？USD，从企业账户余额扣
价格看哪里？控制台「可用模型」页的展示价格
余额不够？返回 BALANCE_INSUFFICIENT；联系领风运营入账（控制台不能自助充值）

出错了怎么办？

错误码人话处理
KEY_INVALIDKey 无效或没带对检查 Authorization: Bearer sk-lf-…
KEY_DISABLEDKey 被禁用在控制台启用或新建 Key
APP_DISABLED应用不可用检查应用是否启用
APP_MODEL_NOT_ALLOWED应用未开这个模型去模型权限勾选，或改正 model
BALANCE_INSUFFICIENT余额不足联系领风入账

错误 JSON 示例：

error response
{
  "error": {
    "code": "APP_MODEL_NOT_ALLOWED",
    "message": "应用未授权调用模型 gpt-4o",
    "type": "billing_error"
  }
}

领风暂未开放的能力

能力请改用
Claude Messages 原生 /claude/v1/messages改用 POST /v1/chat/completions + 同一 sk-lf，模型用应用里已启用的 Claude ID
通用 /v1/videos按模型族改用豆包视频 / 通义视频 / 可灵 / Vidu

附录：地址一览

用途Base URL
OpenAI 兼容（推荐）https://api.lingfengtoken.com/v1
OpenAI 兼容（等价）https://lingfengtoken.com/api/v1
豆包 / 通义 / Gemini 前缀https://lingfengtoken.com/api

鉴权（唯一）：

Authorization: Bearer sk-lf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

请一律使用 Bearer sk-lf。不要使用 x-api-key 或 x-goog-api-key。

多语言 Chat 示例

Python
import requests

resp = requests.post(
    "https://api.lingfengtoken.com/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-lf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-4o-mini",
        "messages": [{"role": "user", "content": "你好"}],
    },
    timeout=60,
)
print(resp.status_code, resp.json())
Node.js
const res = await fetch("https://api.lingfengtoken.com/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk-lf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "你好" }],
  }),
});
console.log(await res.json());