SnowLuma
Home
Quick Start
Deploy
MCP
SDK
API
Developer
Home
Quick Start
Deploy
MCP
SDK
API
Developer

search_sys_faces

search_sys_faces只读系统表情
搜索 QQ 系统表情

Call via POST http://127.0.0.1:3000/search_sys_faces (JSON params as the body) or WebSocket.

Parameters

Param Type Required Default Description
query string ✓ 编号、名称、别名或分组名

Returns (data)

匹配编号、名称、别名或分组名的表情列表。

Every response is wrapped in the standard envelope: { "status": "ok", "retcode": 0, "data": ... }. The table below describes data.

Field Type Required Description
faces object[] ✓
Raw JSON Schema
{
  "type": "object",
  "properties": {
    "faces": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "q_sid": {
            "type": "string",
            "description": "QQ 表情目录标识（部分 emoji 为 Unicode 表情字符串）"
          },
          "q_des": {
            "type": "string",
            "description": "表情描述"
          },
          "em_code": {
            "type": "string"
          },
          "q_cid": {
            "type": [
              "integer",
              "null"
            ]
          },
          "ani_sticker_type": {
            "type": [
              "integer",
              "null"
            ]
          },
          "ani_sticker_pack_id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "ani_sticker_id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          },
          "emoji_name_alias": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "ani_sticker_width": {
            "type": [
              "integer",
              "null"
            ]
          },
          "ani_sticker_height": {
            "type": [
              "integer",
              "null"
            ]
          },
          "is_super": {
            "type": "boolean",
            "description": "是否使用超级表情格式"
          }
        },
        "required": [
          "q_sid",
          "q_des",
          "em_code",
          "q_cid",
          "ani_sticker_type",
          "ani_sticker_pack_id",
          "ani_sticker_id",
          "url",
          "emoji_name_alias",
          "ani_sticker_width",
          "ani_sticker_height",
          "is_super"
        ]
      }
    }
  },
  "required": [
    "faces"
  ]
}

Examples

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/search_sys_faces \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"query":""}'
Using an AI assistant?

MCP-capable clients can discover and call this action directly — no hand-written HTTP. See MCP.

ON THIS PAGE