搜索火柴人图片

POST

/stickman/search

接口功能

根据关键词搜索对应的火柴人 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

搜索火柴人图片

接口功能#

适用场景#

输入说明#

输出说明#