水印消除 · 用户笔记
用户笔记列表
<details>
<summary>基本信息</summary>
| 字段 | 内容 |
|---|---|
| 类型 | 应用 API |
| 应用名称 | 水印消除 |
| 应用编码 | watermark_removal |
| API 名称 | 用户笔记 |
| API 编码 | xhs_user_note_list |
| 请求方式 | POST |
| 请求路径 | /api/v1/apps/watermark_removal/xhs_user_note_list |
| 调用模式 | 同步 |
</details>
计费
固定 25 点/次(¥0.25),按请求次数计费。
| 项目 | 说明 |
|---|---|
| 单价 | 25 点 / 次 |
| 折合 | ¥0.25 |
| 计费方式 | 每次调用固定扣 25 点 |
| 失败 | 上游失败仍会产生成本,暂不退还 |
1 元 = 100 点。一次解析请求 = 25 点。
鉴权
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
请求路径
POST /api/v1/apps/watermark_removal/xhs_user_note_list
业务参数
| 参数 | 类型 | 必填 | 默认值 | 可选值 / 范围 | 示例 | 说明 |
|---|---|---|---|---|---|---|
cursor | string | 否 | — | — | — | 翻页游标,取自上一页笔记项中的 cursor |
userId | string | 是 | — | — | 5f85aabb0000000001006faf | 笔记侧用户 ID(userid) |
lastCursor | string | 否 | — | — | — | 上一页末条目的分页游标(可选),也可用 last_cursor |
请求示例
{
"cursor": "string",
"userId": "5f85aabb0000000001006faf",
"lastCursor": "string"
}
成功响应
{
"code": 1,
"msg": "success",
"data": {
"_comment": "具体字段以接口实际返回为准"
}
}
失败响应
{
"error": {
"message": "点数余额不足",
"type": "insufficient_points",
"code": "insufficient_points"
}
}
错误码
| HTTP | code | 含义 |
|---|---|---|
| 400 | invalid_request | 参数缺失或格式错误 |
| 401 | auth_failed | API Key 缺失或无效 |
| 402 | insufficient_points | 点数余额不足 |
| 402 | key_quota_exceeded | 当前 API Key 点数额度不足 |
| 403 | permission_denied | 当前 API Key 无权调用该模型/应用 |
| 404 | not_found | 模型 / 应用 / 任务不存在 |
| 429 | queue_limit_exceeded | 排队任务已达上限 |
| 5xx | server_error | 服务异常,请稍后重试 |