灵途内容灵感发现

获取系统现有分类名称及父子关系，供搜索筛选使用。示例分类不代表生产实际值。

认证

无需认证

额度

不消耗 Agent 额度

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/facets'

lingtu inspiration filters --json

成功响应

[
  {
    "kind": "industry",
    "name": "示例行业",
    "parent": ""
  }
]

调用说明

• 无需登录或 API Key。
• 分类通过名称精确筛选；请先读取实际值，不根据示例猜测分类。

关键词、AI 或自动搜索已发布案例。自动模式由服务端决定策略，关键词无结果可转 AI，同一次调用仍只计一次额度。

认证

Bearer 用户 API Key

额度

每次成功请求消耗 1 次 Agent 额度；零结果和翻页也计次

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/agent/search' \
  -X POST \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"q":"突出清洁效果的前后对比案例","preference":"auto","requestId":"11111111-1111-4111-8111-111111111111","filters":{},"page":"1"}'

lingtu inspiration search --query '突出清洁效果的前后对比案例' --mode auto --request-timeout 60s --json
lingtu inspiration search --query '突出清洁效果的前后对比案例' --mode auto --search-id example-search --page 2 --request-timeout 60s --json

{
  "q": "突出清洁效果的前后对比案例",
  "preference": "auto",
  "requestId": "11111111-1111-4111-8111-111111111111",
  "filters": {},
  "page": "1"
}

成功响应

{
  "items": [
    {
      "id": "example-case",
      "number": 1,
      "featured": 0,
      "title": "清洁用品前后对比（示例）",
      "originalUrl": "https://www.tiktok.com/@example_creator/photo/1234567890",
      "industry": "示例行业",
      "productType": "示例商品类型",
      "creationType": "实拍",
      "category1": "示例一级类目",
      "category2": "示例二级类目",
      "contentType": "前后对比",
      "highlights": "通过同一位置的清洁前后对比说明效果。",
      "body": "",
      "originalAuthor": "example_creator",
      "sourceDate": "2026-10-01",
      "images": [
        {
          "id": "example-image",
          "url": "https://media.example/image.webp",
          "width": 1080,
          "height": 1440
        }
      ],
      "coverOnly": true,
      "submitter": "编辑精选",
      "favoriteCount": 0,
      "metrics": {
        "views": "12000",
        "likes": "300",
        "comments": null,
        "shares": null,
        "saves": null
      },
      "fetchedAt": "2026-10-02T00:00:00.000Z",
      "hasSourceData": true,
      "matchReason": "案例说明记录了前后对比手法。"
    }
  ],
  "total": 1,
  "page": 1,
  "pages": 1,
  "searchId": "example-search",
  "searchLogId": "example-log",
  "understanding": "查找展示清洁效果的案例",
  "query": "突出清洁效果的前后对比案例"
}

调用说明

• 请求体上限为 8000 字节；q 为 1–500 字符，实际走关键词策略时最多 200 字符；AI 意图解析通常要求至少两个字符。
• page 是数字字符串，每页最多 24 项，不能传数字类型。filters 支持 industry、productType、creationType、category1、category2、from、to；creationType 为 AI 或 实拍，日期为 YYYY-MM-DD。
• sort 支持 relevance、date-desc、date-asc、number-desc、views、likes、saves、comments、shares；关键词模式的 relevance 使用现有默认排序，AI 模式使用匹配顺序。
• 新搜索和翻页使用新的 UUID requestId。同次请求重试沿用原 requestId 与全部原参数，修改参数会产生冲突；失败请求可能需要重新提交，不能承诺所有失败都可复用。
• AI 翻页必须携带原 searchId、q 和原筛选条件；结果属于原用户，有效期约 30 分钟，过期返回 410。关键词翻页重新传原条件和页码。
• 不自动翻页或重试。服务端 AI 搜索处理预算约 30 秒，CLI 示例使用 60 秒请求超时；超时不代表请求未处理。
• 搜索结果只含预览，正文为空且最多一张图片；需要分析完整内容时另调案例详情。

读取当前已发布案例的完整资料，包含正文、已收录图片、原作者与历史表现。

认证

Bearer 用户 API Key

额度

每次成功的新读取消耗 1 次 Agent 额度；同操作标识可用于同次重试

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/agent/cases/example-case' \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -H 'Idempotency-Key: 11111111-1111-4111-8111-111111111111'

lingtu inspiration cases get example-case --json
lingtu inspiration cases get example-case --format markdown
lingtu inspiration cases get example-case --format markdown --json

成功响应

{
  "id": "example-case",
  "number": 1,
  "featured": 0,
  "title": "清洁用品前后对比（示例）",
  "originalUrl": "https://www.tiktok.com/@example_creator/photo/1234567890",
  "industry": "示例行业",
  "productType": "示例商品类型",
  "creationType": "实拍",
  "category1": "示例一级类目",
  "category2": "示例二级类目",
  "contentType": "前后对比",
  "highlights": "通过同一位置的清洁前后对比说明效果。",
  "body": "示例文案，用于展示接口结构，不是真实案例。",
  "originalAuthor": "example_creator",
  "sourceDate": "2026-10-01",
  "images": [
    {
      "id": "example-image",
      "url": "https://media.example/image.webp",
      "width": 1080,
      "height": 1440
    }
  ],
  "coverOnly": true,
  "submitter": "编辑精选",
  "favoriteCount": 0,
  "metrics": {
    "views": "12000",
    "likes": "300",
    "comments": null,
    "shares": null,
    "saves": null
  },
  "fetchedAt": "2026-10-02T00:00:00.000Z",
  "hasSourceData": true
}

# 清洁用品前后对比（示例）

案例链接：https://idea.link2.cn/cases/example-case

原作者：example_creator

以下为示例参考素材。

调用说明

• 只返回已发布版本；下架或不存在返回 404。详情与搜索摘要不同，不可用摘要推断未读取的正文或图片。
• format=markdown 成功时 Content-Type 为 text/markdown，不是 JSON；错误仍为 JSON。CLI --json 将正文放入 data.content。
• 同一个 Idempotency-Key 不能改案例或格式。读取重试仍重新校验当前身份与权限，不绕过撤销或限流。
• metrics 中的数值为字符串，null 表示未获取；fetchedAt 为采集时间，不能当作实时表现。coverOnly=true 时不能推断原帖未收录部分。

列出案例下已经发布的复刻作品摘要，包含名称、日期和成品封面。

认证

Bearer 用户 API Key

额度

Bearer 调用每次成功的新读取消耗 1 次 Agent 额度

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/cases/example-case/remakes' \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -H 'Idempotency-Key: 11111111-1111-4111-8111-111111111111'

lingtu inspiration remakes list example-case --json

成功响应

{
  "items": [
    {
      "id": "example-remake",
      "name": "清洁用品对比复刻（示例）",
      "creationDate": "2026-10-03",
      "cover": null
    }
  ]
}

调用说明

• Agent 使用 Bearer 用户 API Key。网站的 Cookie 会话兼容方式不是本次 CLI 的认证方式。
• 父案例和复刻都必须已发布；空列表表示暂无公开作品。未启用复刻模块时可能返回 503。
• 按需读取，避免为每条搜索结果额外消耗额度。

读取一份已发布作品的输入、成品、实际提示词及对应的固定参考版本。

认证

Bearer 用户 API Key

额度

Bearer 调用每次成功的新读取消耗 1 次 Agent 额度

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/cases/example-case/remakes/example-remake' \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -H 'Idempotency-Key: 11111111-1111-4111-8111-111111111111'

lingtu inspiration remakes get example-case example-remake --json

成功响应

{
  "id": "example-remake",
  "versionId": "example-version",
  "referenceVersionId": "example-reference",
  "name": "清洁用品对比复刻（示例）",
  "productName": "示例清洁用品",
  "productDescription": "示例商品资料",
  "requirements": "前后对比",
  "prompt": "示例记录，不代表推荐提示词。",
  "toolNotes": "未记录具体工具",
  "creationDate": "2026-10-03",
  "outputTitle": "示例成品标题",
  "outputBody": "示例成品文案",
  "tags": "前后对比",
  "commentGuide": "",
  "notes": "",
  "inputs": [],
  "outputs": [],
  "reference": {
    "id": "example-reference",
    "title": "清洁用品前后对比（示例）",
    "body": "示例文案，用于展示接口结构，不是真实案例。",
    "originalAuthor": "example_creator",
    "originalUrl": "https://www.tiktok.com/@example_creator/photo/1234567890",
    "images": []
  },
  "librarySnapshotId": "",
  "librarySnapshot": null,
  "libraryAccess": true
}

调用说明

• 仅返回已发布作品，不包含草稿、下架版本或素材库私有内容。
• referenceVersionId 指向作品创作时的固定参考版本，可能与案例当前发布版本不同。
• 未记录的工具、模型或提示词不能自行补全为事实。

将本地商品或参考图片上传供生成读取；multipart/form-data 的 file 字段，单张最大 10 MB，按真实字节验证 JPEG/PNG/WebP 静态图和尺寸。

认证

Bearer 用户 API Key

额度

不消耗 Agent 次数或共享算力；每用户每分钟最多上传 25 张

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/agent/creation/media' \
  -X POST \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -F 'file=@./outputs/cover.webp'

lingtu inspiration images upload ./product.png --request-timeout 60s --json

{
  "file": "@./product.png"
}

成功响应

{
  "id": "own-product-image",
  "url": "https://media.example/product.png",
  "width": 1080,
  "height": 1440
}

调用说明

• 只需灵途用户 API Key；不需要产品服务器密钥。上传使用已有媒体存储规则，不发起生图、不自动投稿。
• 返回 URL 可公开访问，用于 image_urls；只上传有权公开的素材，不上传明确私密的图片。
• Key 只发送到当前平台，上传不跟随重定向、不自动重试；收到未知响应时先保留本地档案。
• 创建、上传、提交还共享每用户每分钟 30 次创作写入上限。

读取可用模型及 priced_combinations；规格原样使用。

认证

Bearer 用户 API Key

额度

不消耗 Agent 读取额度或共享算力

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/agent/creation/models' \
  -H "Authorization: Bearer $LINGTU_API_KEY"

lingtu inspiration images models --json

成功响应

{
  "items": []
}

调用说明

• 模型规格以目录为准，每张图片固定 30 算力；终端只使用灵途用户 API Key。

一次提交 requestId、kind、input 和 maxCredits。服务端内部获取实时报价、预占算力并发起生成或提取，无需单独报价。maxCredits 为算力上限，最多一位小数；requestId 必须在调用前持久化。

认证

Bearer 用户 API Key

额度

按申请张数预占，按实际交付结算；明确失败释放

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/agent/creation/tasks' \
  -X POST \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"requestId":"11111111-1111-4111-8111-111111111111","kind":"tiktok","input":{"url":"https://www.tiktok.com/@example_creator/photo/1234567890"},"maxCredits":"3"}'

使用下方 cURL 示例直接提交；旧版 CLI 的 quote/submit 两步命令已停用。

{
  "requestId": "11111111-1111-4111-8111-111111111111",
  "kind": "tiktok",
  "input": {
    "url": "https://www.tiktok.com/@example_creator/photo/1234567890"
  },
  "maxCredits": "3"
}

成功响应

{
  "id": "11111111-1111-4111-8111-111111111111",
  "kind": "tiktok",
  "state": "processing",
  "billingState": "held",
  "priceCredits": "3.0",
  "chargedCredits": null,
  "caseId": null,
  "caseStatus": null,
  "result": null,
  "submittedAt": "2026-10-27T11:50:00.000Z"
}

调用说明

• 更新与抓取每次 3 算力，图片生成每张 30 算力；价格由服务端计算，不接受客户端自定单价。
• 展示价格不计 Agent 读取额度；提交预占共享算力，抓取成功扣 3 算力；生图按申请张数预占、实际交付张数结算，多余预占释放，明确失败释放全部预占。
• 用户要求生成或提取后直接提交，不询问预算、不确认报价或金额；maxCredits 由 Agent 内部填写，用户主动指定的上限仍须遵守。重复提交只恢复原任务；超时不能换 UUID 重提。创建/提交合计每用户每分钟最多 30 次。
• 任务为私有数据。GET 可能推进原任务、完成入库和结算，但不新建付费提取或生图任务。
• 模型目录中的单价仅用于预计费用展示；正式提交始终在服务端校验价格和预算。请求失败时保持同 UUID 和参数；已提交或结果未知时查询原 UUID，不能换 ID 重发。

读取本用户原任务；完成 TikTok 图集下载后原子入库待审核。图片转存并结算确认后返回持久 images 链接和灵途 chargedCredits，不自动发布复刻作品。

认证

Bearer 用户 API Key

额度

不消耗 Agent 读取额度，不再次提交上游付费请求；可完成既有算力结算

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/agent/creation/tasks/11111111-1111-4111-8111-111111111111' \
  -H "Authorization: Bearer $LINGTU_API_KEY"

lingtu inspiration tasks get '<ref>' --request-timeout 5m --json
lingtu inspiration tasks wait '<ref>' --request-timeout 5m --json
lingtu inspiration tasks download '<图片任务ref>' --directory ./outputs --json

成功响应

{
  "id": "11111111-1111-4111-8111-111111111111",
  "kind": "tiktok",
  "state": "processing",
  "billingState": "held",
  "priceCredits": "3.0",
  "chargedCredits": null,
  "caseId": null,
  "caseStatus": null,
  "result": null,
  "submittedAt": "2026-10-27T11:50:00.000Z"
}

调用说明

• 更新与抓取每次 3 算力，图片生成每张 30 算力；价格由服务端计算，不接受客户端自定单价。
• 展示价格不计 Agent 读取额度；提交预占共享算力，抓取成功扣 3 算力；生图按申请张数预占、实际交付张数结算，多余预占释放，明确失败释放全部预占。
• 用户要求生成或提取后直接提交，不询问预算、不确认报价或金额；maxCredits 由 Agent 内部填写，用户主动指定的上限仍须遵守。重复提交只恢复原任务；超时不能换 UUID 重提。创建/提交合计每用户每分钟最多 30 次。
• 任务为私有数据。GET 可能推进原任务、完成入库和结算，但不新建付费提取或生图任务。
• processing/submitting 等状态每 15 秒查询；completed 完成；failed 停止；pending、outcome_unknown 或 billingState=reconciliation_required 需要核对，不能重新生成。
• 算力冻结 30 分钟，活跃查询按需续期，最长 24 小时；长期不查询而过期的任务标记待对账，不自动追加扣费。
• TikTok 返回 caseId、入库时 caseStatus、完整 images/正文/来源。仅支持完整 1–20 张图集；视频文件暂不下载。缺失分类须补齐后走原有审核，不自动发布。

multipart/form-data 的 file 字段上传单张 JPEG、PNG、WebP 静态图片，最大 10 MB，返回 mediaId 使用的 id。

认证

Bearer 用户 API Key

额度

不消耗 Agent 读取额度或共享算力

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/agent/remake-submissions/media' \
  -X POST \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -F 'file=@./outputs/cover.webp'

curl 上传本地图片，见请求示例；目前没有对应 lingtu CLI 子命令。

{
  "file": "@./outputs/cover.webp"
}

成功响应

{
  "id": "uploaded-media-id",
  "url": "https://media.example/cover.webp",
  "width": 1080,
  "height": 1440
}

调用说明

• 每用户每分钟最多上传 25 张。上传不等于投稿成功；只有审核通过的作品才进入公开作品列表。
• 生成结果须先下载到本地，再逐张上传；不能把上游临时图片链接当成 mediaId。

上传图片后，用返回的 id 填写 inputs/outputs 的 mediaId。作品名称、商品名、成品标题和正文必填，只能使用本人上传的图片。

认证

Bearer 用户 API Key

额度

不消耗 Agent 读取额度或共享算力

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/agent/remake-submissions' \
  -X POST \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"requestId":"11111111-1111-4111-8111-111111111111","caseId":"example-case","name":"清洁产品复刻","productName":"清洁用品","outputTitle":"清洁前后对比","outputBody":"使用自己的商品素材完成图文复刻。","outputs":[{"mediaId":"uploaded-media-id"}]}'

curl 提交投稿 JSON 文件，见请求示例；目前没有对应 lingtu CLI 子命令。

{
  "requestId": "11111111-1111-4111-8111-111111111111",
  "caseId": "example-case",
  "name": "清洁产品复刻",
  "productName": "清洁用品",
  "outputTitle": "清洁前后对比",
  "outputBody": "使用自己的商品素材完成图文复刻。",
  "outputs": [
    {
      "mediaId": "uploaded-media-id"
    }
  ]
}

成功响应

{
  "id": "example-remake",
  "caseId": "example-case",
  "status": "pending"
}

调用说明

• 仅使用自己的图片和有权公开的文案。每组输入与成品各最多 20 张，成品至少一张。产品素材、提示词及工具选填。
• 提交仅进入待审核，通过后公开；当前没有算力奖励，也不消耗 Agent 读取额度或共享算力。
• requestId 是客户端持久化 UUID；超时保持同 UUID 和相同内容重试。更改内容使用新 UUID。退回后可重新提交，待审核及已通过的成品图不能重复投稿。
• referenceVersionId 选填，省略时固定本次提交时的公开参考版本；显式提供时须属于本案例历史已发布版本。
• 每用户每分钟最多提交 10 次；上报既有成品，不发起生图或付费任务。

只返回当前账号的投稿及审核说明，按提交时间倒序，每页 20 组。

认证

Bearer 用户 API Key

额度

不消耗 Agent 读取额度或共享算力

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/agent/remake-submissions' \
  -H "Authorization: Bearer $LINGTU_API_KEY"

curl 查询自己的投稿，见请求示例。

成功响应

{
  "items": [],
  "total": 0,
  "page": 1,
  "pageSize": 20
}

调用说明

• 仅使用自己的图片和有权公开的文案。每组输入与成品各最多 20 张，成品至少一张。产品素材、提示词及工具选填。
• 提交仅进入待审核，通过后公开；当前没有算力奖励，也不消耗 Agent 读取额度或共享算力。
• requestId 是客户端持久化 UUID；超时保持同 UUID 和相同内容重试。更改内容使用新 UUID。退回后可重新提交，待审核及已通过的成品图不能重复投稿。
• referenceVersionId 选填，省略时固定本次提交时的公开参考版本；显式提供时须属于本案例历史已发布版本。

包含完整成品、文案、固定参考和 reviewNote。其他账号访问返回 404。

认证

Bearer 用户 API Key

额度

不消耗 Agent 读取额度或共享算力

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/agent/remake-submissions/example-case' \
  -H "Authorization: Bearer $LINGTU_API_KEY"

curl 查询投稿详情，见请求示例。

成功响应

{
  "id": "example-remake",
  "status": "pending",
  "reviewNote": "",
  "creator": "示例创作者"
}

调用说明

• 仅使用自己的图片和有权公开的文案。每组输入与成品各最多 20 张，成品至少一张。产品素材、提示词及工具选填。
• 提交仅进入待审核，通过后公开；当前没有算力奖励，也不消耗 Agent 读取额度或共享算力。
• requestId 是客户端持久化 UUID；超时保持同 UUID 和相同内容重试。更改内容使用新 UUID。退回后可重新提交，待审核及已通过的成品图不能重复投稿。
• referenceVersionId 选填，省略时固定本次提交时的公开参考版本；显式提供时须属于本案例历史已发布版本。

返回全部未归档产品，无分页；容量以字节计，已用包含上传预占。

认证

Bearer 用户 API Key

额度

不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/products' \
  -H "Authorization: Bearer $LINGTU_API_KEY"

成功响应

{
  "items": [
    {
      "id": "example-product",
      "name": "随行杯",
      "description": "",
      "audience": "",
      "sellingPoints": "",
      "revision": 0
    }
  ],
  "storage": {
    "usedBytes": 1024,
    "capacity": 20971520,
    "membershipCapacity": 20971520,
    "remainingBytes": 20970496
  }
}

调用说明

• 同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。
• 仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。
• 产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。
• 创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。

至少提供 name，自动创建唯一产品文档；description、audience、sellingPoints 用于初始正文。

认证

Bearer 用户 API Key

额度

不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/products' \
  -X POST \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"name":"随行杯"}'

{
  "name": "随行杯"
}

成功响应

{
  "id": "example-product"
}

调用说明

• 同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。
• 仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。
• 产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。
• 创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。

返回产品名称和版本、文档及其独立版本、图片清单和容量。旧产品首次读取会补建默认文档。

认证

Bearer 用户 API Key

额度

不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/products/example-product' \
  -H "Authorization: Bearer $LINGTU_API_KEY"

成功响应

{
  "product": {
    "id": "example-product",
    "name": "随行杯",
    "revision": 0
  },
  "document": {
    "title": "产品文档.md",
    "body": "# 随行杯\n\n## 产品介绍\n\n轻便易携带",
    "revision": 0
  },
  "images": [
    {
      "id": "example-image",
      "title": "产品图",
      "uploadedBy": {
        "id": "example-identity",
        "name": "示例用户"
      },
      "uploadedAt": "2026-10-27T00:00:00.000Z",
      "imageUrl": "/api/products/example-product/images/example-image"
    }
  ],
  "storage": {
    "usedBytes": 1024,
    "capacity": 20971520,
    "membershipCapacity": 20971520,
    "remainingBytes": 20970496
  }
}

调用说明

• 同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。
• 仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。
• 产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。
• 创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。

必须提供 name 和最新产品 revision；archived:true 归档。省略 description、audience、sellingPoints 会置空这些结构化字段；已有文档和图片保留，正文需通过文档接口修改。

认证

Bearer 用户 API Key

额度

不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/products/example-product' \
  -X PATCH \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"name":"随行杯（新版）","revision":0}'

{
  "name": "随行杯（新版）",
  "revision": 0
}

成功响应

{
  "id": "example-product"
}

调用说明

• 同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。
• 仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。
• 产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。
• 创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。

以附件形式返回 UTF-8 Markdown 正文；文档 revision 从产品详情读取。

认证

Bearer 用户 API Key

额度

不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/products/example-product/document' \
  -H "Authorization: Bearer $LINGTU_API_KEY"

成功响应

# 随行杯

## 产品介绍

轻便易携带

调用说明

• 同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。
• 仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。
• 产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。
• 创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。

提交全文 body（最多 30000 字符，首尾空白会清理）和最新文档 revision，成功返回递增版本。请求 JSON 最大 200000 字节。

认证

Bearer 用户 API Key

额度

不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/products/example-product/document' \
  -X PATCH \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"body":"# 随行杯\n\n## 产品介绍\n\n轻便易携带","revision":0}'

{
  "body": "# 随行杯\n\n## 产品介绍\n\n轻便易携带",
  "revision": 0
}

成功响应

{
  "title": "产品文档.md",
  "body": "# 随行杯\n\n## 产品介绍\n\n轻便易携带",
  "revision": 1
}

调用说明

• 同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。
• 仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。
• 产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。
• 创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。

multipart/form-data 每次一张 file，可选 title（1–200 字符）；JPEG/PNG/WebP 最大 10 MiB，服务端验证真实图片。批量上传须逐张请求；上传人和时间由服务端记录。

认证

Bearer 用户 API Key

额度

不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/products/example-product/images' \
  -X POST \
  -H "Authorization: Bearer $LINGTU_API_KEY" \
  -F 'file=@./outputs/cover.webp'

{
  "file": "@./outputs/cover.webp"
}

成功响应

{
  "id": "example-image",
  "title": "产品图",
  "uploadedBy": {
    "id": "example-identity",
    "name": "示例用户"
  },
  "uploadedAt": "2026-10-27T00:00:00.000Z",
  "imageUrl": "/api/products/example-product/images/example-image"
}

调用说明

• 同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。
• 仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。
• 产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。
• 创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。

校验本人产品和图片关联后返回原始图片字节；不会重定向或暴露存储地址。Content-Type 按实际图片格式返回。

认证

Bearer 用户 API Key

额度

不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/products/example-product/images/example-image' \
  -H "Authorization: Bearer $LINGTU_API_KEY"

成功响应

（原始图片二进制字节）

（原始图片二进制字节）

（原始图片二进制字节）

调用说明

• 同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。
• 仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。
• 产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。
• 创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。

校验当前用户、未归档产品和图片关联后，生成仅限该图片 GET 读取的 TOS HTTPS 预签名 URL。固定有效期 3600 秒，无需请求体，不接受指定存储路径、有效期或公开权限；原图 ACL 保持私有。每次 AI 调用前按需生成，过期重新申请；不要将临时地址作为长期图片地址。

认证

Bearer 用户 API Key

额度

不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/products/example-product/images/example-image/reference-url' \
  -X POST \
  -H "Authorization: Bearer $LINGTU_API_KEY"

成功响应

{
  "url": "https://example-bucket.tos-cn-beijing.volces.com/baokuan/library/example-space/example-image.png?X-Tos-Expires=3600&X-Tos-Signature=example-signature",
  "expiresIn": 3600,
  "expiresAt": "2026-10-27T03:00:00.000Z"
}

调用说明

• 同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。
• 仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。
• 产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。
• 创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。
• 返回的 url 可直接放入生图请求的 image_urls，AI 抓图无需携带本站 Cookie 或 API Key。有效期内持有链接者均可读取，已下载的副本不能撤回；归档或撤销 API Key 不会使已签发的 TOS 链接立即失效，到期后失效。
• 不扣共享算力、不增加存储用量；签名链接响应禁止缓存。重试尚未提交的 AI 任务前重新获取链接；已提交或结果不确定的计费任务应先查询，不能因链接过期自动重复提交。

删除本人产品与图片的关联。无其他产品、素材或快照引用时释放容量并清理原图；仍被引用时 releasedBytes 为 0。同一产品的同一图片重复删除返回成功，已归档产品不可删除图片。

认证

Bearer 用户 API Key

额度

不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。

请求参数

调用示例

curl --fail-with-body 'https://idea.link2.cn/api/products/example-product/images/example-image' \
  -X DELETE \
  -H "Authorization: Bearer $LINGTU_API_KEY"

成功响应

{
  "ok": true,
  "releasedBytes": 1024
}

调用说明

• 同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。
• 仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。
• 产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。
• 创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。