官方算力接入 | 灵雀 Alauda

灵雀官方算力为短剧创作优化：角色四视图默认走 Seedream 线路，并在网关层自动注入性别锁、人种锁、Negative，减少西化与性别漂移。

使用步骤

登录会员中心，进入算力中心。
创建 sk-lq- API Key，在线充值或兑换充值码（按元计费）。
在算力中心点击「下载配置 JSON」，或在灵雀「AI 配置」中手动填写：
- Base URL: https://ai.dongqi.xin/v1（本地开发为 http://127.0.0.1:8787/v1）
- API Key: 你的 sk-lq-…
- 角色图模型: lmd-image-role
- 分镜图模型: lmd-image-seedream
- 文本模型: lmd-text-plus
- 视频模型: lmd-video-seedance（协议 volcengine，Base 同上）
导入后执行连接测试，再开始生成。

虚拟模型说明

模型 ID	用途	参考单价（元/次）
`lmd-image-role`	角色四视图（强化性别/人种锁）	0.22
`lmd-image-seedream`	分镜/通用文生图	0.20
`lmd-text-plus`	文本润色 / 提示词生成	0.03
`lmd-video-seedance`	Seedance 文生/图生视频	1.20

视频 API

灵雀 volcengine 协议会请求以下路径（与火山方舟一致，经网关转发）：

POST /v1/contents/generations/tasks — 创建任务（按元扣费）
GET /v1/contents/generations/tasks/{task_id} — 查询任务（免费）

OpenAI / Agnes 兼容别名：

POST /v1/videos/generations
GET /v1/videos/generations/{task_id} 或 GET /v1/videos/{task_id}

可选请求头

OpenAI 兼容客户端可附加：

X-LMD-Scene: role_four_view — 启用角色四视图 prompt 适配

API 令牌设置

在算力中心每个 Key 可点击「设置」，对标 ffir 令牌能力（灵雀精简版）：

过期时间 — 永不过期 / 快捷 1 天、1 月
额度上限 — 单 Key 消耗金额上限（元，仍受账号总算力余额约束）
模型白名单 — 限制仅可调 lmd-* 指定模型
IP 白名单 — 每行一个 IP，支持 192.168.1.* 前缀
启用/禁用 — 临时停用而不吊销

管理 API：PATCH /api/v1/relay/keys/:id

与第三方中转（如 ffir.cn）的区别：官方算力在网关层做灵雀场景 prompt 适配，并与会员账号、算力余额（元）打通。第三方中转需自行填写上游 Key，且无性别/人种优化。

管理员

管理后台「算力统计」页可查看余额合计、按模型/用户消耗、最近调用，并生成充值码。

# 生成 ¥10 充值码
node scripts/relay-topup-code.js 10

# 或管理 API
GET  /api/v1/admin/relay/stats
GET  /api/v1/admin/relay/usage?page=1
POST /api/v1/admin/relay/topup-codes  { "amount_yuan": 10, "count": 5 }
POST /api/v1/admin/relay/grant        { "user_id": "...", "amount_yuan": 5 }