fetch_face_entity

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

通过 POST http://127.0.0.1:3000/fetch_face_entity(请求体为 JSON 参数)或 WebSocket 调用。

输入参数

参数 类型 必填 默认 说明
face_id int QQ 系统表情编号
refresh bool false 是否强制从 QQ 刷新目录

返回 (data)

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

dataobject

原始 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"
    }
  ]
}

调用示例

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}'
在用 AI 助手?

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