mnapis

整卡渲染

?format=png|pdf &width=320–1200。标题+文字+摘录图+插图+独立脑图手写的合成长图/PDF。超 3600 万像素拒绝。用于看整卡/视觉校对，不代批量文本读取。代价最高，按需用。

GET
/notes/{id}/render

?format=png|pdf &width=320–1200。标题+文字+摘录图+插图+独立脑图手写的合成长图/PDF。超 3600 万像素拒绝。用于看整卡/视觉校对，不代批量文本读取。代价最高，按需用。

Authorization

bearerAuth
AuthorizationBearer <token>

安装脚本写入 ~/.config/mn-bridge/token，或环境变量 MN_BRIDGE_TOKEN。不要带 Origin 头。

In: header

Path Parameters

id*string

卡片 noteid

Query Parameters

format?string

png|pdf

Value in

  • "png"
  • "pdf"
width?integer

320–1200

Response Body

curl -X GET "https://example.com/notes/string/render"
Empty

读卡片二进制项 GET

?maxEdge=64–4096（默认 2048）&layers=composite|base(0.42 起，base 省旧 mask 位图，按 occlusionBaseContentPath 用)。摘录/插图/手写回合成图；音视频回原始二进制。MCP mn_call 中图片以 image 内容返回。

批量读卡 POST

Body {noteIds:[…]} ≤200/次。返回 texts[]（对象数组 {index,text,excerpt,noteid,kind}，index 0=卡正文，1..N=子笔记；稀疏，空留白 kind:blank 也返回）、parts[]（视觉顺序全量，含 contentPath/mimeType/ocrText；0.42 起图片遮挡项带 occlusion 与 occlusionBaseContentPath）、metadata{colorIndex,fillIndex}、hashtags/hashtagPaths。texts 为空先看 parts。