接口总览
所有接口使用同一把 Key,按积分计费,失败自动退款。
基础信息
| 项目 | 说明 |
|---|---|
| Base URL | — |
| 鉴权方式 | Authorization: Bearer sk-lingko-xxxxxxxx |
| 请求格式 | application/json |
| 计费单位 | 积分(图片按张,视频按秒) |
| 失败处理 | 提交即预扣,失败自动退回 |
| 获取 Key | 卡密兑换页 → 输入卡密 → 得到 Key |
快速开始
第一步 打开 兑换页,输入卡密(LK- 普通 / VIP- 会员),得到一串 sk-lingko-…。只显示一次。
第二步 调用接口(也可以直接在下面的在线调试台里试)。
curl
Python
Node.js
# 生成一张图 curl -X POST "{BASE}/v1/images/generations" \ -H "Authorization: Bearer sk-lingko-xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "model": "z-image", "prompt": "一只橘猫趴在窗台上晒太阳", "resolution": "1K", "ratio": "1:1" }'
import requests BASE = "{BASE}" KEY = "sk-lingko-xxxxxxxx" H = {"Authorization": f"Bearer {KEY}"} resp = requests.post( f"{BASE}/v1/images/generations", headers=H, json={ "model": "z-image", "prompt": "一只橘猫趴在窗台上晒太阳", "resolution": "1K", "ratio": "1:1", }, timeout=300, ) data = resp.json() print(data["data"][0]["url"]) print("消耗", data["usage"]["points_cost"], "积分")
const BASE = "{BASE}"; const KEY = "sk-lingko-xxxxxxxx"; const r = await fetch(`${BASE}/v1/images/generations`, { method: "POST", headers: { "Authorization": `Bearer ${KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ model: "z-image", prompt: "一只橘猫趴在窗台上晒太阳", resolution: "1K", ratio: "1:1", }), }); const data = await r.json(); console.log(data.data[0].url);
返回结构
{"created":1793683775,"data":[{"url":"https://…","backup_url":"…","revised_prompt":"…"}],"usage":{"points_cost":1}}
在线调试台
不用写代码,填 Key 直接在这里跑。请求走的是同一个正式接口,会真实扣积分。
API Playground
准备中…
查看请求 / 响应 JSON
—
接口清单
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /v1/models | 模型目录(价格 / 清晰度 / 参考上限) |
| GET | /v1/balance | 余额、会员状态、折扣状态 |
| POST | /v1/images/generations | 生成图片(同步) |
| POST | /v1/images/generations/async | 生成图片(异步,立即返回任务 ID) |
| GET | /v1/images/jobs/{id} | 查询图片任务 |
| POST | /v1/videos/generations | 生成视频(同步) |
| POST | /v1/videos/generations/async | 生成视频(异步) |
| GET | /v1/videos/jobs/{id} | 查询视频任务 |
| GET | /api/video-capacity | 当前卡密在各档位能生成多少秒 |
| GET | /api/history | 生成历史(含备份链接) |
| GET | /api/download/{id}?i=0 | 下载原文件(同源,附件形式) |
| POST | /api/discount/redeem | 核销积分折扣卡 |
| GET | /api/discount/status | 查询折扣状态 |
模型清单
以下数据实时读取接口,平台上新模型会自动出现。点击卡片查看完整参数与调用示例。
图片生成
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID,见上方模型清单 |
prompt | string | 是 | 画面描述 |
n | int | 否 | 张数 1~4,默认 1 |
resolution | string | 否 | 1K / 2K / 4K,须在该模型支持列表内 |
ratio | string | 否 | 1:1 16:9 9:16 3:4 4:3 |
quality | string | 否 | low / medium / high,仅 GPT 系列支持 |
size | string | 否 | OpenAI 风格 1024x1024,会自动换算 |
referenceImages | string[] | 否 | 参考图 URL(图生图),最多 4 张 |
异步任务
同步接口适合单张,异步接口适合批量:先提交拿 id,再轮询。
① 提交
② 轮询
curl -X POST "{BASE}/v1/images/generations/async" \ -H "Authorization: Bearer sk-xxx" \ -H "Content-Type: application/json" \ -d '{"model":"z-image","prompt":"a cat","resolution":"1K"}' # 202 Accepted # {"id":"978f9c81…","object":"image.generation","status":"queued", # "query":"/v1/images/jobs/978f9c81…"}
curl "{BASE}/v1/images/jobs/{task_id}" \ -H "Authorization: Bearer sk-xxx" # {"id":"…","status":"succeeded","model":"z-image","created":1793…, # "data":[{"url":"https://…","original_url":"https://…", # "backup_url":"/files/xxx.png?t=签名", # "width":768,"height":768}],"error":null}
注意
轮询间隔建议 3~5 秒;图片 5~60 秒,视频 30 秒~5 分钟。
状态终值
succeeded / failed。
上游 url 约 24 小时过期,长期保存请用 backup_url。
视频生成
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 视频模型 ID |
prompt | string | 是 | 画面描述 |
resolution | string | 否 | 各模型不同,见模型卡片 |
duration | int | 否 | 秒数,须在模型范围内且不超号池容量 |
ratio | string | 否 | 16:9 9:16 1:1 4:3 3:4 |
mode | string | 否 | text / firstlast / reference |
referenceImages | string[] | 否 | 首尾帧模式下第 1 张首帧、第 2 张尾帧 |
referenceVideos | string[] | 否 | 参考视频,价格翻倍 |
referenceAudios | string[] | 否 | 参考音频,不能单独使用 |
三种模式
文生视频
首尾帧
参考生视频
{
"model": "hm-wan30",
"prompt": "海浪拍打礁石,慢镜头,电影感",
"resolution": "720P",
"duration": 5,
"ratio": "16:9",
"mode": "text"
}{
"model": "hm-wan30",
"prompt": "从白天过渡到黄昏",
"mode": "firstlast",
"referenceImages": [
"https://…/首帧.jpg",
"https://…/尾帧.jpg"
],
"resolution": "720P",
"duration": 5
}{
"model": "hm-seedance-25",
"prompt": "人物转身挥手",
"mode": "reference",
"referenceImages": ["https://…/人物.jpg"],
"referenceAudios": ["https://…/配音.mp3"],
"resolution": "720P",
"duration": 5
}价格与时长
两个限制叠加
① 卡内积分(能付多少) ② 号池单号能力(能做多长)
实际可生成时长取两者较小值。提交前先查
实际可生成时长取两者较小值。提交前先查
GET /api/video-capacity,
超了返回 409 pool_capacity。
| 公式 | 说明 |
|---|---|
| 客户扣费 = 每秒单价 × 秒数 | 不同模型、不同清晰度单价不同 |
带 referenceVideos | 总价 × 2 |
会员模型
会员卡密(VIP- 前缀)兑换后 vip=1,额外解锁:
| 能力 | 普通卡 | 会员卡 |
|---|---|---|
| Wan 3.0 / H3 / Wan Prime | 受号池 50 分限制 | 最长 30 秒 |
| Kling 4.0 | 403 | 720P / 1080P |
| Seedance 2.0 | 403 | 480P 低至 26 分/秒,最长 15 秒 |
| Seedance 2.5(官方 / 定制) | 403 | 最高 4K / 30 秒 |
| 可用号池 | ≤50 分账号 | + 大积分号(>50 分) |
查会员状态
curl "{BASE}/v1/balance" -H "Authorization: Bearer sk-xxx" # {"vip":1,"quota":5000,"used":0,"remain":5000,"discount":null} # 普通卡调用会员模型: # 403 {"error":{"message":"该模型为会员专区专属,请使用会员卡密","type":"vip_only"}}
预扣与退款
| 阶段 | 行为 |
|---|---|
| 提交 | 立即扣除所需积分,防止欠费 |
| 生成中 | 不额外扣费 |
| 成功 | 返回结果,扣费生效 |
| 失败 | 积分原路退回,无需申请 |
余额不足
402 {"error":{"message":"积分不足(本次需 90 分)","type":"insufficient_quota","need":90}}
折扣卡
核销
查状态
curl -X POST "{BASE}/api/discount/redeem" \ -H "Authorization: Bearer sk-xxx" \ -H "Content-Type: application/json" \ -d '{"code":"DC-XXXX-XXXX-XXXX"}' # {"ok":true,"rate":0.85,"hours":1,"expire_at":1793888381.26} # 失败:{"ok":false,"error":"折扣卡不存在"}
curl "{BASE}/api/discount/status" \ -H "Authorization: Bearer sk-xxx" # {"ok":true,"active":true,"rate":0.85,"left":3599}
下载结果
同源下载
curl -OJ "{BASE}/api/download/{task_id}?i=0" \ -H "Authorization: Bearer sk-xxx" # Content-Disposition: attachment; filename="z-image_20261106_0355.png"
错误码
| HTTP | type | 含义 | 怎么办 |
|---|---|---|---|
| 401 | invalid_api_key | Key 无效 | 检查是否复制完整 |
| 402 | insufficient_quota | 积分不足 | 充值或换更便宜的模型 |
| 403 | vip_only | 需要会员卡 | 换非会员模型 |
| 409 | pool_capacity | 时长超号池 | 读 max_seconds 改小重试 |
| 400 | invalid_request_error | 参数错误 | 以 message 文本为准 |
| 500 | — | 服务端异常 | 未扣费,直接重试 |
注意
部分 400 只返回
{"error":{"message":"prompt 不能为空"}},没有 type 字段。
接入方式
中转站 / 客户端
MCP(Agent)
# New API / One API / Chatbox / LobeChat 等 类型 OpenAI 图片 Base URL {BASE} 密钥 sk-lingko-xxxxxxxx 模型 z-image / seedream-v45 / nano-banana-2 …
{
"mcpServers": {
"lingko": {
"command": "python",
"args": ["/path/to/lingko_mcp.py"],
"env": {
"LINGKO_BASE": "{BASE}",
"LINGKO_KEY": "sk-lingko-xxxxxxxx"
}
}
}
}Agent 规范
把本文档交给 AI Agent,它应按以下流程服务客户:
| 阶段 | Agent 做什么 |
|---|---|
| 0 引导 | 教客户在兑换页拿 Key,拿到后先 GET /v1/balance 验证 |
| 1 介绍 | 用大白话说明可用模型与余额,不甩 JSON |
| 2 问询 | 问模型 → 问分辨率比例 → 仅 GPT 系列问画质 |
| 3 确认 | 复述需求与费用,客户同意后才提交 |
| 4 报告 | 生成完给结果 + 最新余额 |
硬规则
没 Key 不生成 · 没确认不提交 · 每次报余额 · 价格查接口不许估 ·
视频先查容量 · 失败说明已退款 · 不给客户看原始 JSON。