1. 火柴人
流光剪辑
main
  • main
  • afanti
  • 一分钟,了解 流光剪辑!
  • 如何下载草稿
  • 在线预览草稿
  • 获取API Key
  • 价格表
  • 文本
    • 使用花字
    • 使用字在人后功能
    • 使用文字模版
    • 如何上传文字模板
    • add_text
      POST
    • add_batch_text
      POST
    • remove_text
      POST
    • modify_text
      POST
    • add_subtitle
      POST
    • add_text_template
      POST
    • get_text_intro_types
      GET
    • get_text_outro_types
      GET
    • get_text_loop_anim_types
      GET
    • get_font_types
      GET
    • search_artist
      POST
  • 图片
    • get_intro_animation_types
    • get_outro_animation_types
    • get_combo_animation_types
    • add_image
    • add_batch_image
    • modify_image
    • remove_image
  • 视频
    • add_video
    • add_batch_video
    • modify_video
    • remove_video
  • 转场
    • get_transition_types
  • 蒙版
    • get_mask_types
  • 音频
    • get_audio_effect_types
    • add_audio
    • add_batch_audio
    • modify_audio
    • remove_audio
  • 关键帧
    • add_video_keyframe
  • 特效
    • get_video_character_effect_types
    • get_video_scene_effect_types
    • add_effect
    • modify_effect
    • remove_effect
  • 贴纸
    • search_sticker
    • add_sticker
  • 云渲染
    • 可使用字体
    • export_video
    • export_idle_video
    • cancel_idle_video_task
    • task_status
  • 工作流
    • 工作流脚本技术文档
    • 工作流 AI Prompt 提示词
    • 使用工作流功能
    • execute_workflow
  • 预设
    • 如何使用模版/预设功能
    • 如何上传模版
    • 快速体验预设
    • add_preset
    • add_batch_preset
    • presets
    • groups
  • 滤镜
    • add_filter
    • get_filter_types
    • modify_filter
    • remove_filter
  • 技能广场skills
    • 技能广场 Skills
    • 字幕模版
      • 如何使用字幕模版
      • generate_smart_subtitle
      • smart_subtitle_task_status
    • 识别字幕
      • 提交异步字幕任务
      • 查询任务状态(GET)
    • AI对话
      • 对话模型介绍
      • chat兼容OpenAI格式
      • 提交异步对话大模型任务
      • 查询任务状态(GET)
      • model_list
    • 语音合成
      • 微软语音合成音色列表
      • MiniMax语音合成音色列表
      • MiniMax音色克隆
      • 豆包语音合成音色列表
      • Fish语音合成音色列表
      • Fish音色克隆
      • generate_speech
      • minimax_clone
      • fish_clone
      • voice_assets
    • AI生图
      • 图片生成聚合接口说明
      • 提交异步AI生图任务
      • 查询任务状态(GET)
    • AI生视频
      • 视频生成聚合接口说明
      • ai_video_task_status
      • generate_ai_video
    • 数字人
      • create_digital_human
      • digital_human_task_status
      • 即梦Omni数字人
      • 即梦Omni数字人状态查询
    • 智能裁剪
      • smart_video_clip
    • 智能截图
      • 异步发起智能截图的任务
      • 查询任务状态(GET)
    • 人物抠像
      • 提交异步“字在人后”任务
      • 提交异步抠像画中画任务
      • 提交异步抠像任务
      • 查询任务状态(GET)
    • 获取时长
      • get_duration
    • 提取音频
      • 提交音频提取任务(异步)
      • 查询任务状态(GET)
    • 分割视频
      • 提交按时间区间分割视频任务
      • 查询任务状态(GET)
    • 视频理解
      • 描述视频内容
    • 获取分辨率
      • get_resolution
    • 网页数据获取
      • 解析小红书链接
      • 解析抖音链接
      • 解析快手链接
      • 解析B站链接
      • 解析TikTok链接
      • 解析YouTube链接
    • 插入首帧
      • 插入首帧
    • 视频超分
      • 提交视频超分任务
      • 查询视频超分任务状态
    • 火柴人
      • 搜索火柴人图片
        POST
  • 口播模版
    • submit_agent_task
    • task_status
  • 草稿
    • modify_draft
    • query_script
  • 素材库
    • 如何使用素材库
    • 通过文件夹id获取该文件夹下的文件链接
  • create_draft
    POST
  1. 火柴人

搜索火柴人图片

POST
/stickman/search
1.png

接口功能#

根据关键词搜索对应的火柴人 PNG 图片,并返回最相关的图片结果。
如果你传入 color,服务还会把命中的 图片 改成指定颜色。

适用场景#

根据动作或场景快速找图,例如 输液、跑步、开会
在搜索结果基础上直接换颜色,得到可直接使用的新 PNG 链接

输入说明#

query:必填,搜索关键词,用来描述你想找的图片
topk:可选,返回结果数量,范围 1-50,默认 10
color:可选,指定改色目标,支持 #ff6600 这类颜色值

输出说明#

成功时返回 query、results、meta
每条结果里会包含图片分数、文件名、图片链接等信息
传入 color 且改色成功时,结果中的 url 会变成新的 链接
同时会附带 original_url、object_key、recolored
参数错误返回 400
上游调用失败返回 502 或 504
服务处理失败返回 500

计费标准#

https://docs.vectcut.com/7834799m0

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json必填

示例

返回响应

🟢200
application/json
搜索成功
Bodyapplication/json

🟠400
🔴500
🔴502
🔴504
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://open.vectcut.com/stickman/search' \
--header 'Authorization: Bearer  <token>' \
--header 'Content-Type: application/json' \
--data '{
    "query": "开会"
}'
响应示例响应示例
200 - 成功示例
{
    "meta": {
        "collection": "stickman_image_v1",
        "color": "#ff0000",
        "count": 10,
        "service": "stickman",
        "topk": 10
    },
    "query": "聚餐",
    "results": [
        {
            "category": "vector_group",
            "color": "#ff0000",
            "filename": "vector_group_file2_110_group2.png",
            "id": "vector_group_file2_110_group2.png",
            "object_key": null,
            "original_url": "https://player.install-ai-guider.top/stickman/images/vector_group_file2_110_group2.png",
            "recolored": true,
            "score": 0.7908,
            "source": "oss",
            "url": "https://player.install-ai-guider.top/stickman/tmp/vectcut_koubo_tmp_file_8xz390sj.png?OSSAccessKeyId=LTAI5t6GK97EdxsFqDT25U2j&Expires=1781541084&Signature=ZDi0RcJ0WWNZXYztzmhJUKiYMII%3D"
        },
        {
            "category": "vector_group",
            "color": "#ff0000",
            "filename": "vector_group_file16_299_group1.png",
            "id": "vector_group_file16_299_group1.png",
            "object_key": null,
            "original_url": "https://player.install-ai-guider.top/stickman/images/vector_group_file16_299_group1.png",
            "recolored": true,
            "score": 0.7895,
            "source": "oss",
            "url": "https://player.install-ai-guider.top/stickman/tmp/vectcut_koubo_tmp_file_rj17fwzf.png?OSSAccessKeyId=LTAI5t6GK97EdxsFqDT25U2j&Expires=1781541084&Signature=eH3dpb35xsH96AbqOiMQTW3BhEo%3D"
        },
        {
            "category": "vector_group",
            "color": "#ff0000",
            "filename": "vector_group_file4_007_group3.png",
            "id": "vector_group_file4_007_group3.png",
            "object_key": null,
            "original_url": "https://player.install-ai-guider.top/stickman/images/vector_group_file4_007_group3.png",
            "recolored": true,
            "score": 0.7888,
            "source": "oss",
            "url": "https://player.install-ai-guider.top/stickman/tmp/vectcut_koubo_tmp_file__qikxp7v.png?OSSAccessKeyId=LTAI5t6GK97EdxsFqDT25U2j&Expires=1781541084&Signature=2lud96wOsq6ZR63SodHygpRo9zQ%3D"
        },
        {
            "category": "vector_group",
            "color": "#ff0000",
            "filename": "vector_group_file15_298_group6.png",
            "id": "vector_group_file15_298_group6.png",
            "object_key": null,
            "original_url": "https://player.install-ai-guider.top/stickman/images/vector_group_file15_298_group6.png",
            "recolored": true,
            "score": 0.7878,
            "source": "oss",
            "url": "https://player.install-ai-guider.top/stickman/tmp/vectcut_koubo_tmp_file_47q1nq_s.png?OSSAccessKeyId=LTAI5t6GK97EdxsFqDT25U2j&Expires=1781541084&Signature=5HRe8TDYFUXOFeI0kvChuJNiV9E%3D"
        },
        {
            "category": "vector_group",
            "color": "#ff0000",
            "filename": "vector_group_file17_300_group2.png",
            "id": "vector_group_file17_300_group2.png",
            "object_key": null,
            "original_url": "https://player.install-ai-guider.top/stickman/images/vector_group_file17_300_group2.png",
            "recolored": true,
            "score": 0.7872,
            "source": "oss",
            "url": "https://player.install-ai-guider.top/stickman/tmp/vectcut_koubo_tmp_file_dho4o881.png?OSSAccessKeyId=LTAI5t6GK97EdxsFqDT25U2j&Expires=1781541085&Signature=TQuxbWzCowX9n1Ph%2FkpTmFV%2BzDA%3D"
        },
        {
            "category": "vector_group",
            "color": "#ff0000",
            "filename": "vector_group_file28_136_group5.png",
            "id": "vector_group_file28_136_group5.png",
            "object_key": null,
            "original_url": "https://player.install-ai-guider.top/stickman/images/vector_group_file28_136_group5.png",
            "recolored": true,
            "score": 0.7863,
            "source": "oss",
            "url": "https://player.install-ai-guider.top/stickman/tmp/vectcut_koubo_tmp_file_pm2fwtnm.png?OSSAccessKeyId=LTAI5t6GK97EdxsFqDT25U2j&Expires=1781541085&Signature=peHsxHeZc9n8QT6czvdA9z0wed8%3D"
        },
        {
            "category": "vector_group",
            "color": "#ff0000",
            "filename": "vector_group_file6_219_group6.png",
            "id": "vector_group_file6_219_group6.png",
            "object_key": null,
            "original_url": "https://player.install-ai-guider.top/stickman/images/vector_group_file6_219_group6.png",
            "recolored": true,
            "score": 0.7763,
            "source": "oss",
            "url": "https://player.install-ai-guider.top/stickman/tmp/vectcut_koubo_tmp_file_dqix9rey.png?OSSAccessKeyId=LTAI5t6GK97EdxsFqDT25U2j&Expires=1781541085&Signature=T74ejpNChyfuvItSCNfnYgAEDB8%3D"
        },
        {
            "category": "vector_group",
            "color": "#ff0000",
            "filename": "vector_group_file28_136_group4.png",
            "id": "vector_group_file28_136_group4.png",
            "object_key": null,
            "original_url": "https://player.install-ai-guider.top/stickman/images/vector_group_file28_136_group4.png",
            "recolored": true,
            "score": 0.7704,
            "source": "oss",
            "url": "https://player.install-ai-guider.top/stickman/tmp/vectcut_koubo_tmp_file_ggbe40ek.png?OSSAccessKeyId=LTAI5t6GK97EdxsFqDT25U2j&Expires=1781541085&Signature=RtjKwAUo%2FCUjzdKYZEkosPauCb8%3D"
        },
        {
            "category": "stickman",
            "color": "#ff0000",
            "filename": "stickman_1254.png",
            "id": "stickman_1254.png",
            "object_key": null,
            "original_url": "https://player.install-ai-guider.top/stickman/images/stickman_1254.png",
            "recolored": true,
            "score": 0.7696,
            "source": "oss",
            "url": "https://player.install-ai-guider.top/stickman/tmp/vectcut_koubo_tmp_file_lwk2ke1z.png?OSSAccessKeyId=LTAI5t6GK97EdxsFqDT25U2j&Expires=1781541085&Signature=haVdmFGuS2CBQ9jTwq0PI%2BjBc8U%3D"
        },
        {
            "category": "vector_group",
            "color": "#ff0000",
            "filename": "vector_group_file2_075_group6.png",
            "id": "vector_group_file2_075_group6.png",
            "object_key": null,
            "original_url": "https://player.install-ai-guider.top/stickman/images/vector_group_file2_075_group6.png",
            "recolored": true,
            "score": 0.7418,
            "source": "oss",
            "url": "https://player.install-ai-guider.top/stickman/tmp/vectcut_koubo_tmp_file_w52fnkdy.png?OSSAccessKeyId=LTAI5t6GK97EdxsFqDT25U2j&Expires=1781541086&Signature=9Rtvs8IbVrHas00h2Xf%2BWyksArM%3D"
        }
    ]
}
修改于 2026-06-08 16:54:57
上一页
查询视频超分任务状态
下一页
submit_agent_task
Built with