{"openapi":"3.1.0","info":{"title":"灵途灵感公开接口","version":"1.6.0","description":"灵途内容灵感发现。接口保留现有鉴权、会员 Agent 额度、频率限制和已发布内容边界。图片生成与图文提取另见能力指南，不是新增的本站公开 API。"},"servers":[{"url":"https://idea.link2.cn"}],"tags":[{"name":"案例搜索与阅读","description":"获取筛选分类，搜索灵感，读取已发布案例的完整图文。"},{"name":"公开复刻作品","description":"查看案例关联的已发布复刻列表与作品详情。"},{"name":"图片生成与图文提取","description":"上传参考图、查询模型与展示价格，直接提交和查询创作任务。"},{"name":"复刻投稿","description":"上传复刻成品、提交审核，并查看本人的投稿与审核结果。"},{"name":"产品档案","description":"管理本人产品、Markdown 文档与私有图片。"}],"paths":{"/api/products":{"get":{"operationId":"listProductProfiles","summary":"本人产品列表与容量","description":"返回全部未归档产品，无分页；容量以字节计，已用包含上传预占。\n\n额度：不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。\n\n同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。\n\n仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。\n\n产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。\n\n创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。","tags":["产品档案"],"security":[{"userApiKey":[]}],"parameters":[],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["items","storage"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","name","description","audience","sellingPoints","revision"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"audience":{"type":"string"},"sellingPoints":{"type":"string"},"revision":{"type":"integer","minimum":0}}}},"storage":{"type":"object","required":["usedBytes","capacity","membershipCapacity","remainingBytes"],"properties":{"usedBytes":{"type":"integer","minimum":0},"capacity":{"type":"integer","minimum":0},"membershipCapacity":{"type":"integer","minimum":0},"remainingBytes":{"type":"integer","minimum":0}}}}},"example":{"items":[{"id":"example-product","name":"随行杯","description":"","audience":"","sellingPoints":"","revision":0}],"storage":{"usedBytes":1024,"capacity":20971520,"membershipCapacity":20971520,"remainingBytes":20970496}}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。","x-cli-examples":[]},"post":{"operationId":"createProductProfile","summary":"创建产品档案","description":"至少提供 name，自动创建唯一产品文档；description、audience、sellingPoints 用于初始正文。\n\n额度：不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。\n\n同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。\n\n仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。\n\n产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。\n\n创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。","tags":["产品档案"],"security":[{"userApiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"default":"","type":"string","maxLength":10000},"audience":{"default":"","type":"string","maxLength":5000},"sellingPoints":{"default":"","type":"string","maxLength":10000},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"archived":{"type":"boolean"}},"required":["name"],"additionalProperties":false},"example":{"name":"随行杯"}}}},"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}}},"example":{"id":"example-product"}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。","x-cli-examples":[]}},"/api/products/{id}":{"get":{"operationId":"getProductProfile","summary":"产品详情","description":"返回产品名称和版本、文档及其独立版本、图片清单和容量。旧产品首次读取会补建默认文档。\n\n额度：不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。\n\n同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。\n\n仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。\n\n产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。\n\n创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。","tags":["产品档案"],"security":[{"userApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"本人产品列表或创建结果中的 ID。","schema":{"type":"string"},"example":"example-product"}],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["product","document","images","storage"],"properties":{"product":{"type":"object","required":["id","name","revision"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"revision":{"type":"integer","minimum":0}}},"document":{"type":"object","required":["title","body","revision"],"properties":{"title":{"type":"string"},"body":{"type":"string"},"revision":{"type":"integer","minimum":0}}},"images":{"type":"array","items":{"type":"object","required":["id","title","uploadedBy","uploadedAt","imageUrl"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"uploadedBy":{"anyOf":[{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}},{"type":"null"}]},"uploadedAt":{"type":"string","format":"date-time"},"imageUrl":{"type":"string"}}}},"storage":{"type":"object","required":["usedBytes","capacity","membershipCapacity","remainingBytes"],"properties":{"usedBytes":{"type":"integer","minimum":0},"capacity":{"type":"integer","minimum":0},"membershipCapacity":{"type":"integer","minimum":0},"remainingBytes":{"type":"integer","minimum":0}}}}},"example":{"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}}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。","x-cli-examples":[]},"patch":{"operationId":"updateProductProfile","summary":"修改或归档产品","description":"必须提供 name 和最新产品 revision；archived:true 归档。省略 description、audience、sellingPoints 会置空这些结构化字段；已有文档和图片保留，正文需通过文档接口修改。\n\n额度：不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。\n\n同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。\n\n仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。\n\n产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。\n\n创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。","tags":["产品档案"],"security":[{"userApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"本人产品列表或创建结果中的 ID。","schema":{"type":"string"},"example":"example-product"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"default":"","type":"string","maxLength":10000},"audience":{"default":"","type":"string","maxLength":5000},"sellingPoints":{"default":"","type":"string","maxLength":10000},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"archived":{"type":"boolean"}},"required":["name","revision"],"additionalProperties":false},"example":{"name":"随行杯（新版）","revision":0}}}},"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}}},"example":{"id":"example-product"}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。","x-cli-examples":[]}},"/api/products/{id}/document":{"get":{"operationId":"downloadProductDocument","summary":"下载产品文档","description":"以附件形式返回 UTF-8 Markdown 正文；文档 revision 从产品详情读取。\n\n额度：不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。\n\n同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。\n\n仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。\n\n产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。\n\n创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。","tags":["产品档案"],"security":[{"userApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"本人产品列表或创建结果中的 ID。","schema":{"type":"string"},"example":"example-product"}],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"text/markdown":{"schema":{"type":"string"},"example":"# 随行杯\n\n## 产品介绍\n\n轻便易携带"}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。","x-cli-examples":[]},"patch":{"operationId":"updateProductDocument","summary":"保存产品文档","description":"提交全文 body（最多 30000 字符，首尾空白会清理）和最新文档 revision，成功返回递增版本。请求 JSON 最大 200000 字节。\n\n额度：不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。\n\n同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。\n\n仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。\n\n产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。\n\n创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。","tags":["产品档案"],"security":[{"userApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"本人产品列表或创建结果中的 ID。","schema":{"type":"string"},"example":"example-product"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"body":{"default":"","type":"string","maxLength":30000},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["body","revision"],"additionalProperties":false},"example":{"body":"# 随行杯\n\n## 产品介绍\n\n轻便易携带","revision":0}}}},"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["title","body","revision"],"properties":{"title":{"type":"string"},"body":{"type":"string"},"revision":{"type":"integer","minimum":0}}},"example":{"title":"产品文档.md","body":"# 随行杯\n\n## 产品介绍\n\n轻便易携带","revision":1}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。","x-cli-examples":[]}},"/api/products/{id}/images":{"post":{"operationId":"uploadProductImage","summary":"上传产品私有图片","description":"multipart/form-data 每次一张 file，可选 title（1–200 字符）；JPEG/PNG/WebP 最大 10 MiB，服务端验证真实图片。批量上传须逐张请求；上传人和时间由服务端记录。\n\n额度：不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。\n\n同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。\n\n仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。\n\n产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。\n\n创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。","tags":["产品档案"],"security":[{"userApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"本人产品列表或创建结果中的 ID。","schema":{"type":"string"},"example":"example-product"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"},"title":{"type":"string","minLength":1,"maxLength":200}}},"example":{"file":"@./outputs/cover.webp"}}}},"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["id","title","uploadedBy","uploadedAt","imageUrl"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"uploadedBy":{"anyOf":[{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}},{"type":"null"}]},"uploadedAt":{"type":"string","format":"date-time"},"imageUrl":{"type":"string"}}},"example":{"id":"example-image","title":"产品图","uploadedBy":{"id":"example-identity","name":"示例用户"},"uploadedAt":"2026-10-27T00:00:00.000Z","imageUrl":"/api/products/example-product/images/example-image"}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。","x-cli-examples":[]}},"/api/products/{id}/images/{materialId}":{"get":{"operationId":"readProductImage","summary":"读取产品私有图片","description":"校验本人产品和图片关联后返回原始图片字节；不会重定向或暴露存储地址。Content-Type 按实际图片格式返回。\n\n额度：不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。\n\n同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。\n\n仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。\n\n产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。\n\n创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。","tags":["产品档案"],"security":[{"userApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"本人产品列表或创建结果中的 ID。","schema":{"type":"string"},"example":"example-product"},{"name":"materialId","in":"path","required":true,"description":"产品详情 images 数组中的 id。","schema":{"type":"string"},"example":"example-image"}],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"},"example":"（原始图片二进制字节）"},"image/png":{"schema":{"type":"string","format":"binary"},"example":"（原始图片二进制字节）"},"image/webp":{"schema":{"type":"string","format":"binary"},"example":"（原始图片二进制字节）"}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。","x-cli-examples":[]},"delete":{"operationId":"deleteProductImage","summary":"删除产品图片","description":"删除本人产品与图片的关联。无其他产品、素材或快照引用时释放容量并清理原图；仍被引用时 releasedBytes 为 0。同一产品的同一图片重复删除返回成功，已归档产品不可删除图片。\n\n额度：不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。\n\n同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。\n\n仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。\n\n产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。\n\n创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。","tags":["产品档案"],"security":[{"userApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"本人产品列表或创建结果中的 ID。","schema":{"type":"string"},"example":"example-product"},{"name":"materialId","in":"path","required":true,"description":"产品详情 images 数组中的 id。","schema":{"type":"string"},"example":"example-image"}],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["ok","releasedBytes"],"properties":{"ok":{"type":"boolean","const":true},"releasedBytes":{"type":"integer","minimum":0}}},"example":{"ok":true,"releasedBytes":1024}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。","x-cli-examples":[]}},"/api/products/{id}/images/{materialId}/reference-url":{"post":{"operationId":"createProductImageReferenceUrl","summary":"生成 AI 参考图临时链接","description":"校验当前用户、未归档产品和图片关联后，生成仅限该图片 GET 读取的 TOS HTTPS 预签名 URL。固定有效期 3600 秒，无需请求体，不接受指定存储路径、有效期或公开权限；原图 ACL 保持私有。每次 AI 调用前按需生成，过期重新申请；不要将临时地址作为长期图片地址。\n\n额度：不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。\n\n同时支持网页登录会话和 Authorization: Bearer 用户 API Key。带 Authorization 时只校验 Key，失败不会回退到 Cookie；Cookie 写入必须提供同源 Origin。\n\n仅可访问本人产品；所有响应（包括错误及图片）均为 private, no-store。图片 URL 是相对本站的受保护地址，下载时仍需携带 Bearer，不能直接作为第三方生图服务的 image_urls；应在提交任务前调用 reference-url 接口生成限时参考链接。\n\n产品 revision 与文档 revision 独立。冲突返回 409，需重新读取后合并；归档保留文件及占用容量，并停止文件读写。容量不足返回 413。\n\n创建与上传不提供幂等去重，超时后先查询核对，不自动重试。当前使用下方 cURL / HTTP 示例调用。\n\n返回的 url 可直接放入生图请求的 image_urls，AI 抓图无需携带本站 Cookie 或 API Key。有效期内持有链接者均可读取，已下载的副本不能撤回；归档或撤销 API Key 不会使已签发的 TOS 链接立即失效，到期后失效。\n\n不扣共享算力、不增加存储用量；签名链接响应禁止缓存。重试尚未提交的 AI 任务前重新获取链接；已提交或结果不确定的计费任务应先查询，不能因链接过期自动重复提交。","tags":["产品档案"],"security":[{"userApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"本人产品列表或创建结果中的 ID。","schema":{"type":"string"},"example":"example-product"},{"name":"materialId","in":"path","required":true,"description":"产品详情 images 数组中的 id。","schema":{"type":"string"},"example":"example-image"}],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["url","expiresIn","expiresAt"],"properties":{"url":{"type":"string","format":"uri"},"expiresIn":{"type":"integer","const":3600},"expiresAt":{"type":"string","format":"date-time"}}},"example":{"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"}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 次数或共享算力；文档与图片占用会员存储空间。写入每用户每分钟 60 次，图片上传另限 25 次；Bearer 还受全局用户频率限制。","x-cli-examples":[]}},"/api/agent/creation/media":{"post":{"operationId":"uploadCreationMedia","summary":"上传生成参考图片","description":"将本地商品或参考图片上传供生成读取；multipart/form-data 的 file 字段，单张最大 10 MB，按真实字节验证 JPEG/PNG/WebP 静态图和尺寸。\n\n额度：不消耗 Agent 次数或共享算力；每用户每分钟最多上传 25 张\n\n只需灵途用户 API Key；不需要产品服务器密钥。上传使用已有媒体存储规则，不发起生图、不自动投稿。\n\n返回 URL 可公开访问，用于 image_urls；只上传有权公开的素材，不上传明确私密的图片。\n\nKey 只发送到当前平台，上传不跟随重定向、不自动重试；收到未知响应时先保留本地档案。\n\n创建、上传、提交还共享每用户每分钟 30 次创作写入上限。","tags":["图片生成与图文提取"],"security":[{"userApiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}},"example":{"file":"@./product.png"}}}},"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["id","url","width","height"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"example":{"id":"own-product-image","url":"https://media.example/product.png","width":1080,"height":1440}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 次数或共享算力；每用户每分钟最多上传 25 张","x-cli-examples":["lingtu inspiration images upload ./product.png --request-timeout 60s --json"]}},"/api/agent/creation/models":{"get":{"operationId":"creationModels","summary":"图片模型与规格","description":"读取可用模型及 priced_combinations；规格原样使用。\n\n额度：不消耗 Agent 读取额度或共享算力\n\n模型规格以目录为准，每张图片固定 30 算力；终端只使用灵途用户 API Key。","tags":["图片生成与图文提取"],"security":[{"userApiKey":[]}],"parameters":[],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object"}}}},"example":{"items":[]}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 读取额度或共享算力","x-cli-examples":["lingtu inspiration images models --json"]}},"/api/agent/creation/tasks":{"post":{"operationId":"createAndSubmitCreation","summary":"提交创作任务","description":"一次提交 requestId、kind、input 和 maxCredits。服务端内部获取实时报价、预占算力并发起生成或提取，无需单独报价。maxCredits 为算力上限，最多一位小数；requestId 必须在调用前持久化。\n\n额度：按申请张数预占，按实际交付结算；明确失败释放\n\n更新与抓取每次 3 算力，图片生成每张 30 算力；价格由服务端计算，不接受客户端自定单价。\n\n展示价格不计 Agent 读取额度；提交预占共享算力，抓取成功扣 3 算力；生图按申请张数预占、实际交付张数结算，多余预占释放，明确失败释放全部预占。\n\n用户要求生成或提取后直接提交，不询问预算、不确认报价或金额；maxCredits 由 Agent 内部填写，用户主动指定的上限仍须遵守。重复提交只恢复原任务；超时不能换 UUID 重提。创建/提交合计每用户每分钟最多 30 次。\n\n任务为私有数据。GET 可能推进原任务、完成入库和结算，但不新建付费提取或生图任务。\n\n模型目录中的单价仅用于预计费用展示；正式提交始终在服务端校验价格和预算。请求失败时保持同 UUID 和参数；已提交或结果未知时查询原 UUID，不能换 ID 重发。","tags":["图片生成与图文提取"],"security":[{"userApiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","const":"tiktok"},"input":{"type":"object","properties":{"url":{"type":"string","maxLength":2000,"format":"uri"}},"required":["url"],"additionalProperties":false},"maxCredits":{"type":"string","pattern":"^(0|[1-9]\\d{0,14})(\\.\\d)?$"}},"required":["requestId","kind","input","maxCredits"],"additionalProperties":false},{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","const":"image"},"input":{"type":"object","properties":{"model":{"type":"string","minLength":1,"maxLength":100},"prompt":{"type":"string","minLength":1},"size":{"type":"string","minLength":1},"resolution":{"type":"string","minLength":1},"quality":{"type":"string","minLength":1},"n":{"type":"integer","minimum":1,"maximum":4},"image_urls":{"maxItems":16,"type":"array","items":{"type":"string","maxLength":4000,"format":"uri"}}},"required":["model","prompt","size","resolution","quality","n"],"additionalProperties":false},"maxCredits":{"type":"string","pattern":"^(0|[1-9]\\d{0,14})(\\.\\d)?$"}},"required":["requestId","kind","input","maxCredits"],"additionalProperties":false}]},"example":{"requestId":"11111111-1111-4111-8111-111111111111","kind":"tiktok","input":{"url":"https://www.tiktok.com/@example_creator/photo/1234567890"},"maxCredits":"3"}}}},"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object"},"example":{"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"}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"按申请张数预占，按实际交付结算；明确失败释放","x-cli-examples":["使用下方 cURL 示例直接提交；旧版 CLI 的 quote/submit 两步命令已停用。"]}},"/api/agent/creation/tasks/{id}":{"get":{"operationId":"readCreation","summary":"查询、恢复创作任务","description":"读取本用户原任务；完成 TikTok 图集下载后原子入库待审核。图片转存并结算确认后返回持久 images 链接和灵途 chargedCredits，不自动发布复刻作品。\n\n额度：不消耗 Agent 读取额度，不再次提交上游付费请求；可完成既有算力结算\n\n更新与抓取每次 3 算力，图片生成每张 30 算力；价格由服务端计算，不接受客户端自定单价。\n\n展示价格不计 Agent 读取额度；提交预占共享算力，抓取成功扣 3 算力；生图按申请张数预占、实际交付张数结算，多余预占释放，明确失败释放全部预占。\n\n用户要求生成或提取后直接提交，不询问预算、不确认报价或金额；maxCredits 由 Agent 内部填写，用户主动指定的上限仍须遵守。重复提交只恢复原任务；超时不能换 UUID 重提。创建/提交合计每用户每分钟最多 30 次。\n\n任务为私有数据。GET 可能推进原任务、完成入库和结算，但不新建付费提取或生图任务。\n\nprocessing/submitting 等状态每 15 秒查询；completed 完成；failed 停止；pending、outcome_unknown 或 billingState=reconciliation_required 需要核对，不能重新生成。\n\n算力冻结 30 分钟，活跃查询按需续期，最长 24 小时；长期不查询而过期的任务标记待对账，不自动追加扣费。\n\nTikTok 返回 caseId、入库时 caseStatus、完整 images/正文/来源。仅支持完整 1–20 张图集；视频文件暂不下载。缺失分类须补齐后走原有审核，不自动发布。","tags":["图片生成与图文提取"],"security":[{"userApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"提交前持久化的 UUID；仅本用户可访问。","schema":{"type":"string","format":"uuid"},"example":"11111111-1111-4111-8111-111111111111"}],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object"},"example":{"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"}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 读取额度，不再次提交上游付费请求；可完成既有算力结算","x-cli-examples":["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"]}},"/api/agent/remake-submissions/media":{"post":{"operationId":"uploadRemakeSubmissionMedia","summary":"上传复刻图片","description":"multipart/form-data 的 file 字段上传单张 JPEG、PNG、WebP 静态图片，最大 10 MB，返回 mediaId 使用的 id。\n\n额度：不消耗 Agent 读取额度或共享算力\n\n每用户每分钟最多上传 25 张。上传不等于投稿成功；只有审核通过的作品才进入公开作品列表。\n\n生成结果须先下载到本地，再逐张上传；不能把上游临时图片链接当成 mediaId。","tags":["复刻投稿"],"security":[{"userApiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}},"example":{"file":"@./outputs/cover.webp"}}}},"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["id","url","width","height"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"example":{"id":"uploaded-media-id","url":"https://media.example/cover.webp","width":1080,"height":1440}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 读取额度或共享算力","x-cli-examples":["curl 上传本地图片，见请求示例；目前没有对应 lingtu CLI 子命令。"]}},"/api/agent/remake-submissions":{"post":{"operationId":"submitRemake","summary":"提交复刻图文审核","description":"上传图片后，用返回的 id 填写 inputs/outputs 的 mediaId。作品名称、商品名、成品标题和正文必填，只能使用本人上传的图片。\n\n额度：不消耗 Agent 读取额度或共享算力\n\n仅使用自己的图片和有权公开的文案。每组输入与成品各最多 20 张，成品至少一张。产品素材、提示词及工具选填。\n\n提交仅进入待审核，通过后公开；当前没有算力奖励，也不消耗 Agent 读取额度或共享算力。\n\nrequestId 是客户端持久化 UUID；超时保持同 UUID 和相同内容重试。更改内容使用新 UUID。退回后可重新提交，待审核及已通过的成品图不能重复投稿。\n\nreferenceVersionId 选填，省略时固定本次提交时的公开参考版本；显式提供时须属于本案例历史已发布版本。\n\n每用户每分钟最多提交 10 次；上报既有成品，不发起生图或付费任务。","tags":["复刻投稿"],"security":[{"userApiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"referenceVersionId":{"type":"string","minLength":1,"maxLength":191},"name":{"type":"string","minLength":1,"maxLength":200},"productName":{"type":"string","minLength":1,"maxLength":200},"productDescription":{"default":"","type":"string","maxLength":10000},"requirements":{"default":"","type":"string","maxLength":10000},"prompt":{"default":"","type":"string","maxLength":30000},"toolNotes":{"default":"","type":"string","maxLength":10000},"creationDate":{"default":"","type":"string","maxLength":10},"outputTitle":{"type":"string","minLength":1,"maxLength":200},"outputBody":{"type":"string","minLength":1,"maxLength":30000},"tags":{"default":"","type":"string","maxLength":2000},"commentGuide":{"default":"","type":"string","maxLength":10000},"notes":{"default":"","type":"string","maxLength":30000},"inputs":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"mediaId":{"type":"string","minLength":1,"maxLength":191},"name":{"default":"","type":"string","maxLength":100},"matches":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"referenceMediaId":{"type":"string","minLength":1,"maxLength":191},"note":{"default":"","type":"string","maxLength":500}},"required":["referenceMediaId"]}}},"required":["mediaId"]}},"outputs":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"mediaId":{"type":"string","minLength":1,"maxLength":191},"name":{"default":"","type":"string","maxLength":100},"matches":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"referenceMediaId":{"type":"string","minLength":1,"maxLength":191},"note":{"default":"","type":"string","maxLength":500}},"required":["referenceMediaId"]}}},"required":["mediaId"]}},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"caseId":{"type":"string","minLength":1,"maxLength":191}},"required":["name","productName","outputTitle","outputBody","outputs","requestId","caseId"],"additionalProperties":false},"example":{"requestId":"11111111-1111-4111-8111-111111111111","caseId":"example-case","name":"清洁产品复刻","productName":"清洁用品","outputTitle":"清洁前后对比","outputBody":"使用自己的商品素材完成图文复刻。","outputs":[{"mediaId":"uploaded-media-id"}]}}}},"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"caseId":{"type":"string"},"status":{"type":"string"}}},"example":{"id":"example-remake","caseId":"example-case","status":"pending"}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 读取额度或共享算力","x-cli-examples":["curl 提交投稿 JSON 文件，见请求示例；目前没有对应 lingtu CLI 子命令。"]},"get":{"operationId":"listOwnRemakeSubmissions","summary":"查询自己的复刻投稿","description":"只返回当前账号的投稿及审核说明，按提交时间倒序，每页 20 组。\n\n额度：不消耗 Agent 读取额度或共享算力\n\n仅使用自己的图片和有权公开的文案。每组输入与成品各最多 20 张，成品至少一张。产品素材、提示词及工具选填。\n\n提交仅进入待审核，通过后公开；当前没有算力奖励，也不消耗 Agent 读取额度或共享算力。\n\nrequestId 是客户端持久化 UUID；超时保持同 UUID 和相同内容重试。更改内容使用新 UUID。退回后可重新提交，待审核及已通过的成品图不能重复投稿。\n\nreferenceVersionId 选填，省略时固定本次提交时的公开参考版本；显式提供时须属于本案例历史已发布版本。","tags":["复刻投稿"],"security":[{"userApiKey":[]}],"parameters":[{"name":"page","in":"query","description":"页码，1–10000。","schema":{"type":"integer","minimum":1,"maximum":10000}},{"name":"status","in":"query","description":"可选 pending / published / rejected / offline。","schema":{"type":"string"}}],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object"},"example":{"items":[],"total":0,"page":1,"pageSize":20}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 读取额度或共享算力","x-cli-examples":["curl 查询自己的投稿，见请求示例。"]}},"/api/agent/remake-submissions/{id}":{"get":{"operationId":"getOwnRemakeSubmission","summary":"查询自己的投稿详情","description":"包含完整成品、文案、固定参考和 reviewNote。其他账号访问返回 404。\n\n额度：不消耗 Agent 读取额度或共享算力\n\n仅使用自己的图片和有权公开的文案。每组输入与成品各最多 20 张，成品至少一张。产品素材、提示词及工具选填。\n\n提交仅进入待审核，通过后公开；当前没有算力奖励，也不消耗 Agent 读取额度或共享算力。\n\nrequestId 是客户端持久化 UUID；超时保持同 UUID 和相同内容重试。更改内容使用新 UUID。退回后可重新提交，待审核及已通过的成品图不能重复投稿。\n\nreferenceVersionId 选填，省略时固定本次提交时的公开参考版本；显式提供时须属于本案例历史已发布版本。","tags":["复刻投稿"],"security":[{"userApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"提交接口返回的投稿 ID。","schema":{"type":"string"},"example":"example-case"}],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"example-remake","status":"pending","reviewNote":"","creator":"示例创作者"}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 读取额度或共享算力","x-cli-examples":["curl 查询投稿详情，见请求示例。"]}},"/api/facets":{"get":{"operationId":"listInspirationFilters","summary":"分类与筛选值","description":"获取系统现有分类名称及父子关系，供搜索筛选使用。示例分类不代表生产实际值。\n\n额度：不消耗 Agent 额度\n\n无需登录或 API Key。\n\n分类通过名称精确筛选；请先读取实际值，不根据示例猜测分类。","tags":["案例搜索与阅读"],"security":[],"parameters":[],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["kind","name","parent"],"properties":{"kind":{"type":"string"},"name":{"type":"string"},"parent":{"type":"string"}}}},"example":[{"kind":"industry","name":"示例行业","parent":""}]}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"不消耗 Agent 额度","x-cli-examples":["lingtu inspiration filters --json"]}},"/api/agent/search":{"post":{"operationId":"searchInspiration","summary":"搜索内容灵感","description":"关键词、AI 或自动搜索已发布案例。自动模式由服务端决定策略，关键词无结果可转 AI，同一次调用仍只计一次额度。\n\n额度：每次成功请求消耗 1 次 Agent 额度；零结果和翻页也计次\n\n请求体上限为 8000 字节；q 为 1–500 字符，实际走关键词策略时最多 200 字符；AI 意图解析通常要求至少两个字符。\n\npage 是数字字符串，每页最多 24 项，不能传数字类型。filters 支持 industry、productType、creationType、category1、category2、from、to；creationType 为 AI 或 实拍，日期为 YYYY-MM-DD。\n\nsort 支持 relevance、date-desc、date-asc、number-desc、views、likes、saves、comments、shares；关键词模式的 relevance 使用现有默认排序，AI 模式使用匹配顺序。\n\n新搜索和翻页使用新的 UUID requestId。同次请求重试沿用原 requestId 与全部原参数，修改参数会产生冲突；失败请求可能需要重新提交，不能承诺所有失败都可复用。\n\nAI 翻页必须携带原 searchId、q 和原筛选条件；结果属于原用户，有效期约 30 分钟，过期返回 410。关键词翻页重新传原条件和页码。\n\n不自动翻页或重试。服务端 AI 搜索处理预算约 30 秒，CLI 示例使用 60 秒请求超时；超时不代表请求未处理。\n\n搜索结果只含预览，正文为空且最多一张图片；需要分析完整内容时另调案例详情。","tags":["案例搜索与阅读"],"security":[{"userApiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":500},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"preference":{"default":"auto","type":"string","enum":["auto","keyword","ai"]},"filters":{"default":{},"type":"object","properties":{"industry":{"type":"string","maxLength":100},"productType":{"type":"string","maxLength":100},"creationType":{"type":"string","enum":["AI","实拍"]},"category1":{"type":"string","maxLength":100},"category2":{"type":"string","maxLength":100},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}},"sort":{"type":"string","enum":["relevance","date-desc","date-asc","number-desc","views","likes","saves","comments","shares"]},"page":{"type":"string","maxLength":6,"pattern":"^\\d+$"},"searchId":{"type":"string","maxLength":191}},"required":["q","requestId"]},"example":{"q":"突出清洁效果的前后对比案例","preference":"auto","requestId":"11111111-1111-4111-8111-111111111111","filters":{},"page":"1"}}}},"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["items","total","page","pages"],"properties":{"items":{"type":"array","maxItems":24,"items":{"type":"object","required":["id","title","body","images","coverOnly","metrics","fetchedAt"],"properties":{"id":{"type":"string"},"number":{"type":["integer","null"]},"featured":{"type":"integer"},"title":{"type":"string"},"originalUrl":{"type":"string"},"industry":{"type":"string"},"productType":{"type":"string"},"creationType":{"type":"string"},"category1":{"type":"string"},"category2":{"type":"string"},"contentType":{"type":"string"},"highlights":{"type":"string"},"body":{"type":"string","const":""},"originalAuthor":{"type":"string"},"sourceDate":{"type":"string"},"images":{"type":"array","maxItems":1,"items":{"type":"object","required":["id","url","width","height"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"coverOnly":{"type":"boolean","description":"仅收录封面时为 true，不能推断缺失图片内容。"},"submitter":{"type":"string"},"favoriteCount":{"type":"integer"},"hasSourceData":{"type":"boolean"},"metrics":{"type":"object","properties":{"views":{"type":["string","null"],"description":"十进制整数字符串或 null；不是实时数据，null 不等于零。"},"likes":{"type":["string","null"],"description":"十进制整数字符串或 null；不是实时数据，null 不等于零。"},"comments":{"type":["string","null"],"description":"十进制整数字符串或 null；不是实时数据，null 不等于零。"},"shares":{"type":["string","null"],"description":"十进制整数字符串或 null；不是实时数据，null 不等于零。"},"saves":{"type":["string","null"],"description":"十进制整数字符串或 null；不是实时数据，null 不等于零。"}}},"fetchedAt":{"type":["string","null"],"description":"指标采集时间；未获取时为 null。"},"matchReason":{"type":"string"}},"description":"搜索摘要：body 清空，images 最多一张；完整内容需要单独读取案例。"}},"total":{"type":"integer"},"page":{"type":"integer","minimum":1},"pages":{"type":"integer","minimum":1},"searchId":{"type":"string"},"searchLogId":{"type":"string"},"fallbackFromSearchId":{"type":"string"},"understanding":{"type":"string"},"query":{"type":"string"}}},"example":{"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":"突出清洁效果的前后对比案例"}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"每次成功请求消耗 1 次 Agent 额度；零结果和翻页也计次","x-cli-examples":["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"]}},"/api/agent/cases/{id}":{"get":{"operationId":"getInspirationCase","summary":"案例详情与 Markdown","description":"读取当前已发布案例的完整资料，包含正文、已收录图片、原作者与历史表现。\n\n额度：每次成功的新读取消耗 1 次 Agent 额度；同操作标识可用于同次重试\n\n只返回已发布版本；下架或不存在返回 404。详情与搜索摘要不同，不可用摘要推断未读取的正文或图片。\n\nformat=markdown 成功时 Content-Type 为 text/markdown，不是 JSON；错误仍为 JSON。CLI --json 将正文放入 data.content。\n\n同一个 Idempotency-Key 不能改案例或格式。读取重试仍重新校验当前身份与权限，不绕过撤销或限流。\n\nmetrics 中的数值为字符串，null 表示未获取；fetchedAt 为采集时间，不能当作实时表现。coverOnly=true 时不能推断原帖未收录部分。","tags":["案例搜索与阅读"],"security":[{"userApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"搜索结果返回的案例 ID。","schema":{"type":"string"},"example":"example-case"},{"name":"format","in":"query","description":"json 为默认；markdown 返回纯 Markdown 文本。","schema":{"type":"string","enum":["json","markdown"],"default":"json"}},{"name":"Idempotency-Key","in":"header","description":"可选的同次读取标识。CLI 使用 1–200 个安全 ASCII 字符；重试保持标识、资源及格式不变。未传入视为新调用。","schema":{"type":"string"},"example":"11111111-1111-4111-8111-111111111111"}],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["id","title","body","images","coverOnly","metrics","fetchedAt"],"properties":{"id":{"type":"string"},"number":{"type":["integer","null"]},"featured":{"type":"integer"},"title":{"type":"string"},"originalUrl":{"type":"string"},"industry":{"type":"string"},"productType":{"type":"string"},"creationType":{"type":"string"},"category1":{"type":"string"},"category2":{"type":"string"},"contentType":{"type":"string"},"highlights":{"type":"string"},"body":{"type":"string"},"originalAuthor":{"type":"string"},"sourceDate":{"type":"string"},"images":{"type":"array","items":{"type":"object","required":["id","url","width","height"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"coverOnly":{"type":"boolean","description":"仅收录封面时为 true，不能推断缺失图片内容。"},"submitter":{"type":"string"},"favoriteCount":{"type":"integer"},"hasSourceData":{"type":"boolean"},"metrics":{"type":"object","properties":{"views":{"type":["string","null"],"description":"十进制整数字符串或 null；不是实时数据，null 不等于零。"},"likes":{"type":["string","null"],"description":"十进制整数字符串或 null；不是实时数据，null 不等于零。"},"comments":{"type":["string","null"],"description":"十进制整数字符串或 null；不是实时数据，null 不等于零。"},"shares":{"type":["string","null"],"description":"十进制整数字符串或 null；不是实时数据，null 不等于零。"},"saves":{"type":["string","null"],"description":"十进制整数字符串或 null；不是实时数据，null 不等于零。"}}},"fetchedAt":{"type":["string","null"],"description":"指标采集时间；未获取时为 null。"},"matchReason":{"type":"string"}}},"example":{"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}},"text/markdown":{"schema":{"type":"string"},"example":"# 清洁用品前后对比（示例）\n\n案例链接：https://idea.link2.cn/cases/example-case\n\n原作者：example_creator\n\n以下为示例参考素材。\n"}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"每次成功的新读取消耗 1 次 Agent 额度；同操作标识可用于同次重试","x-cli-examples":["lingtu inspiration cases get example-case --json","lingtu inspiration cases get example-case --format markdown","lingtu inspiration cases get example-case --format markdown --json"]}},"/api/cases/{caseId}/remakes":{"get":{"operationId":"listInspirationRemakes","summary":"已发布复刻列表","description":"列出案例下已经发布的复刻作品摘要，包含名称、日期和成品封面。\n\n额度：Bearer 调用每次成功的新读取消耗 1 次 Agent 额度\n\nAgent 使用 Bearer 用户 API Key。网站的 Cookie 会话兼容方式不是本次 CLI 的认证方式。\n\n父案例和复刻都必须已发布；空列表表示暂无公开作品。未启用复刻模块时可能返回 503。\n\n按需读取，避免为每条搜索结果额外消耗额度。","tags":["公开复刻作品"],"security":[{"userApiKey":[]}],"parameters":[{"name":"caseId","in":"path","required":true,"description":"搜索结果返回的案例 ID。","schema":{"type":"string"},"example":"example-case"},{"name":"Idempotency-Key","in":"header","description":"可选的同次读取标识。CLI 使用 1–200 个安全 ASCII 字符；重试保持标识、资源及格式不变。未传入视为新调用。","schema":{"type":"string"},"example":"11111111-1111-4111-8111-111111111111"}],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","name","creationDate","cover"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"creationDate":{"type":"string"},"cover":{"anyOf":[{"type":"object","required":["id","url","width","height"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},{"type":"null"}]}}}}}},"example":{"items":[{"id":"example-remake","name":"清洁用品对比复刻（示例）","creationDate":"2026-10-03","cover":null}]}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"Bearer 调用每次成功的新读取消耗 1 次 Agent 额度","x-cli-examples":["lingtu inspiration remakes list example-case --json"]}},"/api/cases/{caseId}/remakes/{remakeId}":{"get":{"operationId":"getInspirationRemake","summary":"已发布复刻详情","description":"读取一份已发布作品的输入、成品、实际提示词及对应的固定参考版本。\n\n额度：Bearer 调用每次成功的新读取消耗 1 次 Agent 额度\n\n仅返回已发布作品，不包含草稿、下架版本或素材库私有内容。\n\nreferenceVersionId 指向作品创作时的固定参考版本，可能与案例当前发布版本不同。\n\n未记录的工具、模型或提示词不能自行补全为事实。","tags":["公开复刻作品"],"security":[{"userApiKey":[]}],"parameters":[{"name":"caseId","in":"path","required":true,"description":"搜索结果返回的案例 ID。","schema":{"type":"string"},"example":"example-case"},{"name":"remakeId","in":"path","required":true,"description":"复刻列表返回的作品 ID。","schema":{"type":"string"},"example":"example-remake"},{"name":"Idempotency-Key","in":"header","description":"可选的同次读取标识。CLI 使用 1–200 个安全 ASCII 字符；重试保持标识、资源及格式不变。未传入视为新调用。","schema":{"type":"string"},"example":"11111111-1111-4111-8111-111111111111"}],"responses":{"200":{"description":"成功；直接返回业务数据，不套 code/data 包装。","content":{"application/json":{"schema":{"type":"object","required":["id","versionId","referenceVersionId","name","inputs","outputs","reference"],"properties":{"id":{"type":"string"},"versionId":{"type":"string"},"referenceVersionId":{"type":"string"},"name":{"type":"string"},"productName":{"type":"string"},"productDescription":{"type":"string"},"requirements":{"type":"string"},"prompt":{"type":"string"},"toolNotes":{"type":"string"},"creationDate":{"type":"string"},"outputTitle":{"type":"string"},"outputBody":{"type":"string"},"tags":{"type":"string"},"commentGuide":{"type":"string"},"notes":{"type":"string"},"inputs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"mediaId":{"type":"string"},"name":{"type":"string"},"image":{"type":"object","required":["id","url","width","height"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"matches":{"type":"array","items":{"type":"object","properties":{"referenceMediaId":{"type":"string"},"note":{"type":"string"}}}}}}},"outputs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"mediaId":{"type":"string"},"name":{"type":"string"},"image":{"type":"object","required":["id","url","width","height"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"matches":{"type":"array","items":{"type":"object","properties":{"referenceMediaId":{"type":"string"},"note":{"type":"string"}}}}}}},"reference":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"body":{"type":"string"},"originalAuthor":{"type":"string"},"originalUrl":{"type":"string"},"images":{"type":"array","items":{"type":"object","required":["id","url","width","height"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}},"librarySnapshotId":{"type":"string","const":""},"librarySnapshot":{"type":"null"},"libraryAccess":{"type":"boolean"}}},"example":{"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}}}},"default":{"description":"失败时为 JSON，code、quota 等字段可能省略。","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"searchLogId":{"type":"string"},"membershipUrl":{"type":"string"},"quota":{"type":"object","required":["metric","remaining","limit","resetAt"],"properties":{"metric":{"type":"string"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"error":"Agent 额度不足","code":"QUOTA_EXCEEDED","quota":{"metric":"agent","remaining":0,"limit":100,"resetAt":"2026-10-27T00:00:00+08:00"},"membershipUrl":"/membership"}}}}},"x-agent-quota":"Bearer 调用每次成功的新读取消耗 1 次 Agent 额度","x-cli-examples":["lingtu inspiration remakes get example-case example-remake --json"]}}},"externalDocs":{"description":"完整 Agent 文档，含图片生成与图文提取指南","url":"https://idea.link2.cn/docs/api.md"},"x-capability-guides":[{"title":"图文复刻","url":"https://idea.link2.cn/docs/remake.md","scope":"供 Agent 阅读的复刻指南：使用用户自己的产品素材，参考案例逐页策划、生成、验收并交付。用户只需提供案例链接与素材。"},{"title":"图片生成","url":"https://idea.link2.cn/docs/image-generation.md","scope":"支持灵途用户 API Key 创建图片任务。先查模型与展示价格，携带算力预算直接提交；图片每张 30 算力。"},{"title":"图文提取","url":"https://idea.link2.cn/docs/content-extraction.md","scope":"支持读取已发布案例，并通过灵途用户 API Key 提取 TikTok 链接、完整图集入库待审核。抓取每次 3 算力，提交时携带算力预算。"}],"components":{"securitySchemes":{"userApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ltak_ 用户 API Key","description":"在 https://login.lingtuzaowu.com/account/api-keys 创建并授权灵途灵感。"}}}}