简体中文

fetch_custom_face_detail

fetch_custom_face_detail只读扩展

获取自定义表情详情

通过 POST http://127.0.0.1:3000/fetch_custom_face_detail（请求体为 JSON 参数）或 WebSocket 调用。

输入参数

参数	类型	必填	默认	说明
`count`	int	–	`48`

返回 (data)

自定义表情详情数组，包含资源标识、图片地址、摘要与描述。

所有响应都包裹在标准信封中：{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。

data 为数组，每个元素：

字段	类型	必填	说明
`emoji_id`	string	✓	可传给 SnowLuma 表情管理接口的资源标识
`resId`	string	✓	兼容 NapCat 的资源标识
`url`	string	✓	表情图片地址
`md5`	string	✓	表情内容摘要
`desc`	string	✓	自定义表情描述；未设置时为空字符串

原始 JSON Schema

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "emoji_id": {
        "type": "string",
        "description": "可传给 SnowLuma 表情管理接口的资源标识"
      },
      "resId": {
        "type": "string",
        "description": "兼容 NapCat 的资源标识"
      },
      "url": {
        "type": "string",
        "description": "表情图片地址"
      },
      "md5": {
        "type": "string",
        "description": "表情内容摘要"
      },
      "desc": {
        "type": "string",
        "description": "自定义表情描述；未设置时为空字符串"
      }
    },
    "required": [
      "emoji_id",
      "resId",
      "url",
      "md5",
      "desc"
    ]
  }
}

调用示例

curl

Python

JavaScript

SnowLuma SDK

curl -X POST http://127.0.0.1:3000/fetch_custom_face_detail \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"count":48}'

在用 AI 助手？

支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。

ON THIS PAGE

fetch_custom_face_detail#

输入参数#

返回 (data)#

调用示例#

fetch_custom_face_detail

输入参数

返回 (data)

调用示例