素材工具异步任务

小红书数据

查笔记详情（含无水印图片、视频）、博主信息和笔记列表，按关键词搜笔记，结果可导出表格

模型信息

模型编码	`xiaohongshu-data`（请求里的 `model` 字段）
能力类型	素材工具，产出文本
调用方式	异步任务：提交后立即返回任务编号，完成后查询或接收 Webhook 回调
最长处理时间	10 分钟，超时按失败处理并全额退回点数（任务 `error.code` 为 `timeout`）
适用场景	笔记、博主、选题调研

计费说明

当前显示原价。登录秒做账号后刷新本页，会员看到会员价，渠道看到所属等级价。

计价单位	原价（点）	约合人民币
每次	40	¥0.40

每次调用按固定数量计费。
提交时按报价冻结，成功后按报价扣点；失败、超时、取消全额退回。
约合人民币按 1 元 = 100 点折算。适用价格规则见计费与点数。

接口地址

POSThttps://api.miaozuo.cn/v1/tasks

提交后用 GET https://api.miaozuo.cn/v1/tasks/{id} 查询结果，或通过 Webhook 接收回调。任务接口的通用说明见任务查询。

请求参数

字段	类型	必填	说明
`model`	string	是	固定为 `xiaohongshu-data`
`input`	object	是	模型参数，见下表（也接受字段名 `params`）
`webhook_url`	string	否	任务结束时回调的 HTTPS 地址
`metadata`	object	否	自定义键值，原样回显；最多 16 个键，值为不超过 512 字的字符串

input 参数

字段	类型	必填	取值范围	默认值	说明
`mode`	string	是	"note"（笔记详情）、"notes"（用户笔记）、"profile"（用户信息）、"search"（搜索笔记）	`"note"`	查询内容
`note`	string	否	最多 1000 个字符	—	笔记链接或编号。App 里的短链接请先在浏览器打开，再复制地址栏里的完整链接。仅当 mode（查询内容）为 "note" 时有效
`user`	string	否	最多 1000 个字符	—	用户主页链接或编号。仅当 mode（查询内容）为 "notes" / "profile" 时有效
`keyword`	string	否	最多 50 个字符	—	搜索关键词。仅当 mode（查询内容）为 "search" 时有效
`sort`	string	否	"general"（综合）、"hot"（最热）、"latest"（最新）、"comments"（评论最多）、"collects"（收藏最多）	`"general"`	排序。仅当 mode（查询内容）为 "search" 时有效
`note_type`	string	否	"all"（全部）、"video"（视频）、"image"（图文）	`"all"`	笔记类型。仅当 mode（查询内容）为 "search" 时有效
`page`	integer	否	1 ～ 50	`1`	页码。看下一页时在结果里点「下一页」会自动填好。仅当 mode（查询内容）为 "search" 时有效
`cursor`	string	否	最多 500 个字符	—	翻页标记。看下一页时在结果里点「下一页」会自动填好，一般不用手动填写。仅当 mode（查询内容）为 "notes" 时有效
`agree`	boolean	否	true（已阅读并同意）	—	使用须知。仅限处理本人有权使用的内容：自己发布的作品、已获授权的素材或依法公开的信息。不得用于侵犯他人著作权、肖像权、隐私，不得批量采集或转售数据；使用不当产生的责任由使用者自行承担。

组合规则

请填写笔记链接或编号
请填写用户主页链接或编号
请填写搜索关键词
请先阅读并勾选同意使用须知

未定义的字段会被忽略，数字字符串会自动转成数字，缺省的字段按默认值补齐。文件类参数请先用文件上传拿到秒做地址，也可以直接传可公开访问的 HTTPS 地址。

请求示例

curl https://api.miaozuo.cn/v1/tasks \
  -H "Authorization: Bearer $MIAOZUO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-20261009-0001" \
  -d '{
    "model": "xiaohongshu-data",
    "input": {
      "mode": "note",
      "note": "示例笔记链接或编号",
      "agree": true
    },
    "metadata": {
      "order_id": "1001"
    }
  }'

返回示例

受理成功返回 HTTP 200 和任务对象，状态为 queued，所需点数已冻结（示例数值按原价估算）：

提交返回

{
  "id": "T261009170328CGM0GT",
  "object": "task",
  "model": "xiaohongshu-data",
  "status": "queued",
  "created_at": "2026-10-09T17:03:28+08:00",
  "started_at": null,
  "finished_at": null,
  "input": {
    "mode": "note",
    "note": "示例笔记链接或编号",
    "agree": true
  },
  "points": {
    "frozen": "40.000",
    "charged": "0.000",
    "refunded": "0.000"
  },
  "output": null,
  "error": null,
  "metadata": {
    "order_id": "1001"
  }
}

完成后查询任务（或 Webhook 回调的 data）：

GET /v1/tasks/{id}（成功）

{
  "id": "T261009170328CGM0GT",
  "object": "task",
  "model": "xiaohongshu-data",
  "status": "succeeded",
  "created_at": "2026-10-09T17:03:28+08:00",
  "started_at": "2026-10-09T17:03:29+08:00",
  "finished_at": "2026-10-09T17:03:52+08:00",
  "input": {
    "mode": "note",
    "note": "示例笔记链接或编号",
    "agree": true
  },
  "points": {
    "frozen": "40.000",
    "charged": "40.000",
    "refunded": "0.000"
  },
  "output": {
    "files": [],
    "text": "（生成的文本内容）"
  },
  "error": null,
  "metadata": {
    "order_id": "1001"
  }
}

返回字段

字段	类型	说明
`id`	string	任务编号，形如 `T261009170328CGM0GT`
`status`	string	`queued` / `processing` / `succeeded` / `failed` / `canceled`
`input`	object	校验并补齐默认值后的参数
`points`	object	冻结、实扣、退回点数
`output.text`	string	生成的文本结果
`error`	object	失败原因 `code`、`message`；成功时为 `null`

完整字段见任务对象。

错误码

调用这个模型时常见的错误（都不扣点）。完整列表与任务失败原因见错误码。

HTTP	error.code	说明
402	`insufficient_points`	点数（含授信额度）不足；不冻结、不开始生成
402	`key_quota_exceeded`	Key 的额度已用完（额度可按日 / 周 / 月自动重置）
403	`permission_denied`	该 Key 的可调模型不包含这个模型
404	`model_unavailable`	模型不存在、已下架、未对开放 API 开放，或对你的渠道等级不可见
422	`invalid_params`	参数错误：缺少必填字段、类型或取值超出范围（details 里逐字段说明）
422	`content_rejected`	提示词或参考素材未通过内容安全审核；不扣点
429	`rate_limited`	每分钟请求数超过 Key 的限速，响应头带 Retry-After（秒）
429	`concurrency_limited`	进行中的任务与文本调用数超过 Key 或账户的并发上限

在线测试

在开放平台的在线测试页选择这个模型直接调用，不用写代码；测试按正常价格扣点。未登录会先进入登录页。

去在线测试