笔记扫码发布

接口信息

URL: http://plugin.aiconductor.fun/api/xhs_note_publish

方法: POST / GET

Content-Type: application/json

鉴权: 请求头 Authorization: Bearer <api_key>（兼容 body/query 中 api_key 参数）

功能说明

生成小红书扫码发布 H5 页面与二维码，支持图文/视频两种笔记类型。可选将素材转存到云端（转存后链接 7 天内有效）。按次计费（0.05元/次，如需转存素材0.1元/次）

请求参数

参数名	类型	必填	默认值	说明
type	string	是		笔记类型：`"normal"`（图文）或 `"video"`（视频）
title	string	否	""	笔记标题，中文字符计 1 个，英文/数字计 0.5 个，最多 20
content	string	否	""	笔记正文，最多 1000 字符
images	string[]	normal 必填		图片公网 URL 列表，最多 18 张
video	string	video 必填		视频公网 URL
cover	string	否		视频封面图公网 URL（仅 video 类型有效）
transfer_to_oss	bool	否	false	是否将素材转存到云端（`true` / `false`），上传至云端素材更稳定

鉴权参数：api_key 通过请求头 Authorization: Bearer <api_key> 传递，不再列入请求参数表。

响应参数

参数名	类型	说明
success	boolean	是否成功
message	string	响应消息
data	object	发布页数据
data.id	string	笔记唯一标识（UUID）
data.url	string	发布页 H5 在线地址
data.qrcode	string	二维码 base64（data:image/png;base64,...），手机扫码即可打开发布页
data.transfer_to_oss	boolean	是否执行了 OSS 转存
data.media	object	最终使用的素材列表
data.media.images	string[]	图片 URL 列表
data.media.video	string	视频 URL（video 类型）
data.media.cover	string	封面图 URL（video 类型，选填）
billing	object	计费信息
billing.service_fee	float	服务费
billing.discount_applied	boolean	是否应用折扣
billing.balance_before	float	扣费前余额
billing.balance_after	float	扣费后余额
billing.currency	string	货币类型（CNY）
billing.transaction_id	string	交易ID

请求示例

图文笔记（不含 OSS 转存）

视频笔记（含 OSS 转存）

注意事项

素材 URL 必须为公网可访问的 http(s) 地址，内网 IP 和 localhost 将被拒绝

视频文件上限 200MB，图片文件上限 32MB，超出上限返回错误

转存到 OSS 后的素材链接有效期 7 天，过期自动清理

生成的 H5 页面支持移动端扫码后在浏览器中点击"发布到小红书"按钮自动唤起 App

采用后扣费模式，仅页面生成成功时才扣费；参数校验失败或素材下载失败不扣费

图文笔记支持多张图片左右滑动预览，桌面端展示手机模拟框 + 扫码面板

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "type": "normal",
    "title": "美食分享",
    "content": "今天做了一道美味的菜\n大家觉得怎么样？",
    "images": [
      "https://aiconductor.oss-cn-shanghai.aliyuncs.com/uploads/6575b71cbe8148818db3a7b8e869d922.png"
    ]
  }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "success": true,
    "message": "发布页生成成功",
    "data": {
        "id": "6cd90813-a88d-4a73-9983-34ae13373ac9",
        "url": "https://oss.aiconductor.fun/temporary_7/xhs_note_publish/6cd90813-a88d-4a73-9983-34ae13373ac9/index.html",
        "qrcode": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAeoAAAHqAQAAAADjFjCXAAAELklEQVR4nO2dy43rRhBFT5kEZtkEHMCEQmXgkB5eSM6ACmUCGKC5FECivOiv3tuRMmRZtxYDkeIBRaBQn9vFHnNO2PWPMzQIFy5cuHDhwoULfyxu2UaA3fK5abd0eG1frOXSy+PuLvxN8dnd3SPAOgKrmXsc3Gwa3C7sZjYNDgzu7u73+Mm7C39TfM3hyy4MDsHdLuuIL4B7zH8AKDHxgXcX/l74+NuZcEsZ1ll3Y45gAAbDZvPfD727cOEAXCdShOM6AddpN1+Ce3PHf/Puwt8CL7EuOLBCruvC92iECNfLh9sc9xEY3AB6Xfmln134k/GrmZlNwBwHtx9fH878NWI/IsCaD4E9tbAPvbvwN8NTrOvDV7iZXyfMWaF9grDh95c++8cLf1GcpIPMEUiySByShuJL8PKJwdshVT7x5aWfXfiz8M7rsif5hi9ho5zbkv8x+5aROQ6eFD55nfBDVjTfoQS8UA+TcjxUh6vnfEOxTvhpfPab+c/PLYsmc6yLYRNVKs7nyirF4+4u/M3wErSoqw8pueYFilTmLZCzLmFLZZ4yrPDjVtcmhs0IW5XvNmDNYwBOiOm0s470WvFLP7vwZ+Glh4htubU1sjXgeYt/ucJTXSf8hHU9bOpc60DJXNqM3D7E4phJQ5HXCT9sTS9hjlmWA4bO9ZKbLeRYlxsOeZ3wo5YKOYPB7fq5AeyjA/j1r+/RWSeAcbPZd0t13ex7qf9e+tmFPwuvel2ZNOnOBfcU/7zqdVnNQ3qd8DPWZdiUPkNZjKhuliSVmmuzuCKvE37YcjdRO4fqcKXWg/LFVhte6XXCT1lOlaGk1JRXi5qS4p+3QyAtkMnrhB+3zuvqcv+v/rdUla59Ul0n/Lh1SbMqwm3mJF9SRgD6T/I64YfNO4vQVh/Kimy5bmk+Ccqwws9Y7iZir6GUL/JAXetcm1QsrxN+3Lo3Ew2GjbTSv05wvQye30eM++isH26Eb3PYyyD7Sz+78Gfhv9Z1eZEfSnItPWzpXNtosWKd8KPWZdiFfvAkO1wE8hhxbm7zdfI64YetBbJc14Uq3wGtmvM6eKK6TvijYt3QLcYW5aQM2c1tvg7KVjzyOuGHrcQ6ryn17kWdpgg30aStV8jrhB+yLsMu6UzRi5e7XcOyaAJ6M1H4Q1Vib5MmG3eFXI51KSbOEdV1wk/jba9OX9jN/WsE1g83+3TPu9ul7RRHWiP73/jxwl8Vn8uKmF3ChuWtE2/WqyRlgeLxdxf+Zni/z0mq1yI1uQ55lngB2hhxmS9WhhX+WHz9cLuELW+dmOq6rzFPGv/8vGk3bOEn7PcdYgEj3MxZ/yzptL2PvY7YHOt+Yi/97MKfhXd6XdldYrgbQakbUHRSsfQ64eesKXLkt2B7r+uk4oWyFYrqOuHncNN/rxMuXLhw4cKFC/9f4P8AvEA+iNSFUzwAAAAASUVORK5CYII=",
        "transfer_to_oss": false,
        "media": {
            "images": [
                "https://aiconductor.oss-cn-shanghai.aliyuncs.com/uploads/6575b71cbe8148818db3a7b8e869d922.png"
            ],
            "video": null,
            "cover": null
        }
    },
    "billing": {
        "service_fee": 0.05,
        "discount_applied": true,
        "balance_before": 482.5695,
        "balance_after": 482.5195,
        "currency": "CNY",
        "transaction_id": 1926931
    }
}

接口信息#

功能说明#

请求参数#

响应参数#

请求示例#

图文笔记（不含 OSS 转存）#

视频笔记（含 OSS 转存）#

注意事项#

请求参数

请求示例代码

返回响应

接口信息

功能说明

请求参数

响应参数

请求示例

图文笔记（不含 OSS 转存）

视频笔记（含 OSS 转存）

注意事项