灵栈 AI 用量教程：调用 DeepSeek 与 AI 生图

灵栈提供一个和 OpenAI 格式兼容的 AI 接口。聊天用 DeepSeek 模型，消耗灵能；生图每天有免费额度，不消耗灵能。两者用同一个地址、同一把密钥。

一、准备：灵能和密钥

登录灵栈，打开「个人中心 → AI 用量」。
获得灵能（只有聊天要用，生图不扣灵能）：
- 用积分兑换：100 积分换 1000 灵能，每批 60 天有效，先用快过期的。
- 或者在「兑换码」里输入兑换码。
新建密钥：在同一页的「密钥」里新建一把，密钥以 lzk_ 开头。
- 密钥只显示一次，请马上复制保存。丢了就撤销，再建一把新的。
- 修改账号密码会撤销你所有的密钥。
- 不要把密钥发给别人，也不要贴到公开的地方，拿到密钥的人能用你的灵能。

二、接口地址

用途	地址
接口根地址	`https://api.lingzhanskill.com/v1`
聊天	`POST /v1/chat/completions`
文生图	`POST /v1/images/generations`
图生图	`POST /v1/images/edits`
查看可用模型	`GET /v1/models`
查今天还能生成几张图	`GET /v1/images/quota`

每个请求都要带上请求头：Authorization: Bearer 你的密钥

模型名	用途
`deepseek-v4-flash`	聊天：问答、写作、翻译、编程（扣灵能）
`gpt-image-2.5-flare`	生图：文生图、图生图（每天免费）

三、聊天（DeepSeek）

在客户端里使用（以 Cherry Studio 为例）

打开设置 → 模型服务 → 添加，类型选 OpenAI（或"OpenAI 兼容"）。
API 地址填 https://api.lingzhanskill.com。如果客户端要求地址带 /v1，就填 https://api.lingzhanskill.com/v1。
API 密钥填你的 lzk_ 密钥。
添加模型 deepseek-v4-flash，然后就能开始对话。

其他支持"OpenAI 兼容接口"的工具（编辑器插件、翻译工具、自己写的程序）填法一样：地址、密钥、模型名三项。

用 curl 调用（macOS / Linux）

curl https://api.lingzhanskill.com/v1/chat/completions \
  -H "Authorization: Bearer 你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "用三句话介绍一下你自己"}]
  }'

想要边生成边显示，加上 "stream": true。

用 Python 调用

先安装：pip install openai

from openai import OpenAI

client = OpenAI(api_key="你的密钥", base_url="https://api.lingzhanskill.com/v1")

reply = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "用三句话介绍一下你自己"}],
)
print(reply.choices[0].message.content)

Windows 用户推荐用 Python 或客户端调用。如果直接在 PowerShell 里拼中文请求，中文容易变成问号。

计费说明

按实际用量扣灵能：输入和输出都算，命中缓存的输入更便宜。
请求失败、一个字都没生成出来时，不扣灵能。
灵能不够时，接口返回 402，兑换后就能继续用。

四、AI 生图（每天免费）

规则

每人每天免费 5 张，不扣灵能，北京时间零点重置。同一个账号的几把密钥共用这 5 张。
文生图和图生图共用这个额度。
分辨率固定为 1024×1024，一次生成一张。
生成一张大约要 30～80 秒，请把超时设到 3 分钟以上。
生成失败或被拒绝的不算次数。
模型名是 gpt-image-2.5-flare，可以不填，不填就用这个。
生成的图片带有 AI 生成标识。不要去掉标识，也不要把它当成真实照片使用。
不能生成违法、色情、暴力或冒充真实人物的图片。

文生图：curl

curl https://api.lingzhanskill.com/v1/images/generations \
  -H "Authorization: Bearer 你的密钥" \
  -H "Content-Type: application/json" \
  --max-time 300 \
  -d '{"model": "gpt-image-2.5-flare", "prompt": "一只穿宇航服的橘猫站在月球表面，简洁插画风格", "size": "1024x1024"}'

返回结果大致是这样：

{
  "created": 1793627647,
  "data": [{"url": "https://lingzhanskill.com/api/v1/generated/xxxx-1.png"}],
  "remaining_today": 4
}

url 就是图片地址，在浏览器里打开就能看到和下载。remaining_today 是今天还剩几张。

想直接拿到图片数据，在请求里加上 "response_format": "b64_json"，返回结果会多一个 b64_json 字段。

文生图：Python

from openai import OpenAI

client = OpenAI(api_key="你的密钥", base_url="https://api.lingzhanskill.com/v1", timeout=300)

result = client.images.generate(
    model="gpt-image-2.5-flare",
    prompt="一只穿宇航服的橘猫站在月球表面，简洁插画风格",
    size="1024x1024",
)
print(result.data[0].url)

图生图：上传一张参考图，说明要怎么改

支持 PNG、JPG、WebP，最大 7 MB，长边不超过 4096 像素。
一次只能上传一张。参考图只能直接上传，不能填网址。

curl：

curl https://api.lingzhanskill.com/v1/images/edits \
  -H "Authorization: Bearer 你的密钥" \
  --max-time 300 \
  -F "model=gpt-image-2.5-flare" \
  -F "[email protected]" \
  -F "prompt=保留人物和姿势，把背景换成雪山" \
  -F "size=1024x1024"

Python：

from openai import OpenAI

client = OpenAI(api_key="你的密钥", base_url="https://api.lingzhanskill.com/v1", timeout=300)

with open("photo.png", "rb") as f:
    result = client.images.edit(
        model="gpt-image-2.5-flare",
        image=f,
        prompt="保留人物和姿势，把背景换成雪山",
        size="1024x1024",
    )
print(result.data[0].url)

查看今天还剩几张

curl https://api.lingzhanskill.com/v1/images/quota -H "Authorization: Bearer 你的密钥"

在网页上也能看：「个人中心 → AI 用量」会显示"今天还能免费生成 X 张图"。

五、让 AI 助手帮你调用

如果你在用 Claude Code、Codex 这类 AI 助手，并且已经接入灵栈，可以直接对它说：

"用灵栈的 deepseek-v4-flash 帮我把这段话翻译成英文"
"用灵栈帮我生成一张海边灯塔的图"
"用灵栈把这张照片的背景换成雪山"

它会按灵栈的说明自己调用接口，把结果交给你。

六、常见问题

返回	意思	怎么办
401	密钥不对、过期或被撤销	检查密钥，或新建一把
402	灵能不足，或有欠账	去「AI 用量」兑换灵能
403 `scope_missing`	这把密钥没有"调用模型"权限	在「密钥」里给它勾上
403 `images_disabled`	生图暂时关闭	等开放后再用
404 `model_not_found`	模型名写错了	聊天用 `deepseek-v4-flash`，生图用 `gpt-image-2.5-flare`
422 `image_refused`	生图内容不被接受	换个说法再试，不扣次数
422 `size_not_supported` / `one_image_only`	分辨率或张数不对	只用 1024x1024，一次一张
429	今天的免费图用完了，或同一把密钥同时发的请求超过 2 个	明天再来，或等上一个请求结束
503	服务暂时繁忙	稍后重试

如果生图一直没结果，先检查超时是不是设得太短。生成一张图要几十秒，超时短于 3 分钟就容易被当成失败。