fetch_face_entity

fetch_face_entity只读系统表情
按编号查询 QQ 系统表情

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

Parameters

Param Type Required Default Description
face_id int QQ 系统表情编号
refresh bool false 是否强制从 QQ 刷新目录

Returns (data)

表情详情;编号不存在时返回 null。

data is object.

Raw JSON Schema
{
  "anyOf": [
    {
      "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"
      ]
    },
    {
      "type": "null"
    }
  ]
}

Examples

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

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