get_text_effects

GET /get_text_effects

接口说明

查询本地剪映花字索引，支持按标题筛选、VIP/免费模式和分页。把选中的花字 id 传给 add_text 的 effect_effect_id，即可在草稿中写入花字效果。

也可以使用 POST /get_text_effects。查询本地剪映花字索引，返回花字 id、标题和 VIP 标记。

请求参数

参数	类型	必填	默认值	说明
mode	integer	否	0	0 全部，1 VIP，2 免费
keyword	string	否	—	按标题筛选
count	integer	否	30	返回数量，范围 1-200
offset	integer	否	0	分页偏移

请求示例

curl -X GET "https://your-domain.example/api/get_text_effects?keyword=清新&count=3" \
  -H "X-API-Key: $VECTCUT_API_KEY"

返回示例

{
  "success": true,
  "output": {
    "data": [
      {
        "id": "7500000000000000001",
        "title": "清新粉紫色立体花字",
        "is_vip": false
      }
    ],
    "total": 24,
    "offset": 0,
    "count": 1
  },
  "error": ""
}

把返回的 id 传给 add_text 的 effect_effect_id，即可写入花字效果。