Official Verified

tukeli-visual-api

调用图可丽（Tukeli）视觉处理 API，实现通用抠图、人脸变清晰、AI背景更换三项能力。支持文件上传、图片URL两种输入方式，返回二进制流或Base64编码结果。AI背景更换为异步接口，需先提交任务再查询结果。

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/cutout-pro/tukeli-visual-api

Download Source Code (.zip)

图可丽视觉 API — 图像处理工具集

概述

通过图可丽（Tukeli）REST API 实现三项核心图像处理能力：

通用抠图（Image Matting） — 自动识别图像中主体轮廓，与背景分离，返回透明 PNG；支持人像、物体、头像等多种类型
人脸变清晰（Face Clear） — AI 增强人脸清晰度，将模糊低质量人脸照片转为高清图
AI背景更换（AI Background） — 根据文字描述自动对图片透明区域进行 AI 扩展生成新背景（异步接口）

注意：图可丽 API 的请求域名为 https://picupapi.tukeli.net，与图可丽官网域名不同，请勿混淆。

适用场景

用户需要去除图片背景时
用户需要提升人脸照片清晰度时
用户需要为已抠图的图片生成 AI 背景时
用户提到"抠图"、"去背景"、"人像分割"等相关话题时
用户提到"人脸增强"、"照片变清晰"等相关话题时
用户提到"AI换背景"、"背景生成"等相关话题时

不适用场景

任务与图像处理无关
用户需要生成全新图片（非处理现有图片）
用户需要视频处理（请使用其他工具）

工作原理

通过图可丽 API 对图片进行 AI 处理。每次调用消耗点数（积分）：

抠图：图片 15M 以下消耗 1 点，15M~25M 消耗 2 点
人脸变清晰：每次消耗 2 点
AI背景更换：按分辨率计费（≤512×512 消耗 3 点，≤1024×1024 消耗 6 点，≤1920×1080 消耗 12 点）

三种 API 对比

场景	推荐 API
去除商品/人物/动物背景	通用抠图（mattingType=6）
提取人像（发丝级精度）	通用抠图（mattingType=1）
提取头像/头部区域	通用抠图（mattingType=3）
模糊人脸照片变高清	人脸变清晰（mattingType=18）
为透明图片生成 AI 背景	AI背景更换（异步接口）

快速开始

前往 https://www.tukeli.net 注册账号
获取 API Key（登录后在账户设置中获取）
在 .env 文件中配置：TUKELI_API_KEY=你的密钥
安装依赖：pip install -r scripts/requirements.txt
运行脚本：python scripts/tukeli.py --api matting --image photo.jpg

完整配置说明见 references/setup-guide.md。

1. 调用模式

命令参数	功能	接口
`--api matting`	通用抠图（文件上传，返回二进制）	`POST /api/v1/matting?mattingType=6`
`--api matting --base64`	通用抠图（文件上传，返回Base64）	`POST /api/v1/matting2?mattingType=6`
`--api matting --url`	通用抠图（图片URL，返回Base64）	`GET /api/v1/mattingByUrl?mattingType=6`
`--api face-clear`	人脸变清晰（文件上传，返回二进制）	`POST /api/v1/matting?mattingType=18`
`--api face-clear --base64`	人脸变清晰（文件上传，返回Base64）	`POST /api/v1/matting2?mattingType=18`
`--api face-clear --url`	人脸变清晰（图片URL，返回Base64）	`GET /api/v1/mattingByUrl?mattingType=18`
`--api ai-bg --submit`	AI背景更换（提交任务）	`POST /api/v1/paintAsync`
`--api ai-bg --query`	AI背景更换（查询结果）	`GET /api/v1/getPaintResult`

2. 使用示例

# 通用抠图 — 上传文件，保存为 PNG
python scripts/tukeli.py --api matting --image product.jpg --output out.png

# 通用抠图 — 传入图片URL，获取Base64
python scripts/tukeli.py --api matting --url "https://example.com/photo.jpg"

# 通用抠图 — 裁剪空白区域，添加白色背景
python scripts/tukeli.py --api matting --image photo.jpg --crop --bgcolor FFFFFF

# 人像抠图（发丝级精度）
python scripts/tukeli.py --api matting --matting-type 1 --image portrait.jpg --output face.png

# 人脸变清晰 — 上传文件，保存高清图
python scripts/tukeli.py --api face-clear --image blurry.jpg --output hd.png

# 人脸变清晰 — 获取Base64
python scripts/tukeli.py --api face-clear --image blurry.jpg --base64

# AI背景更换 — 提交任务（需先抠图得到透明PNG）
python scripts/tukeli.py --api ai-bg --submit --image-url "https://example.com/transparent.png" --text "美丽的海滩背景"

# AI背景更换 — 查询任务结果
python scripts/tukeli.py --api ai-bg --query --task-id 375593109065861

3. 通用参数

Read Full Documentation on GitHub

Metadata

Author@cutout-pro

Stars3409

Updated2026-03-25

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-cutout-pro-tukeli-visual-api": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Related Skills

mcp-builder

Bootstraps new Model Context Protocol (MCP) servers from a natural language description. Use when the user asks to build an MCP server, create an MCP tool, scaffold an MCP integration, or add MCP capabilities to an existing project. NOT for: general API design, non-MCP tool building, or frontend tasks.

asimons81 4473

scrapebadger

Web scraping platform — Twitter/X data, Vinted marketplace, and general web scraping API

0xghostcasper 4473

clinicaltrials-gov-parser

Monitor and summarize competitor clinical trial status changes from ClinicalTrials.gov. Trigger: When user asks to track clinical trials, monitor trial status changes, get updates on specific trials, or analyze competitor trial activities. Use cases: Pharma competitive intelligence, trial monitoring, status tracking, recruitment updates, completion alerts.

aipoch-ai 4473

agent3-hub

Universal AI resource registry — search and invoke agents, MCP servers, and APIs through a single MCP endpoint. Includes Telegram content search, Google search, X/Twitter search, and more.

agent3-666 4473

api-contract-auditor

审查 API 文档、示例和字段定义是否一致，输出 breaking change 风险。；use for api, contract, audit workflows；do not use for 直接改线上接口, 替代契约测试平台.

52yuanchangxing 4473