⌕
⤓
◐
Infinitecrt · API

图片与视频生成接口文档

兼容 OpenAI Images 协议,覆盖 27 个图片与视频模型。 支持同步 / 异步调用、参考素材、会员专属模型,并提供本文档内嵌的在线调试台。

← 返回控制台

接口总览

所有接口使用同一把 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查询折扣状态

模型清单

以下数据实时读取接口,平台上新模型会自动出现。点击卡片查看完整参数与调用示例。

全部
图片
视频
会员专属
通用
⌕

图片生成

参数类型必填说明
modelstring是模型 ID,见上方模型清单
promptstring是画面描述
nint否张数 1~4,默认 1
resolutionstring否1K / 2K / 4K,须在该模型支持列表内
ratiostring否1:1 16:9 9:16 3:4 4:3
qualitystring否low / medium / high,仅 GPT 系列支持
sizestring否OpenAI 风格 1024x1024,会自动换算
referenceImagesstring[]否参考图 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。

视频生成

参数类型必填说明
modelstring是视频模型 ID
promptstring是画面描述
resolutionstring否各模型不同,见模型卡片
durationint否秒数,须在模型范围内且不超号池容量
ratiostring否16:9 9:16 1:1 4:3 3:4
modestring否text / firstlast / reference
referenceImagesstring[]否首尾帧模式下第 1 张首帧、第 2 张尾帧
referenceVideosstring[]否参考视频,价格翻倍
referenceAudiosstring[]否参考音频,不能单独使用

三种模式

文生视频
首尾帧
参考生视频
{
  "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.0403720P / 1080P
Seedance 2.0403480P 低至 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"

错误码

HTTPtype含义怎么办
401invalid_api_keyKey 无效检查是否复制完整
402insufficient_quota积分不足充值或换更便宜的模型
403vip_only需要会员卡换非会员模型
409pool_capacity时长超号池读 max_seconds 改小重试
400invalid_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。
Infinitecrt · API 文档 模型数据实时同步 —
⌕ESC