Byted Mediakit Image

---
name: byted-mediakit-image
version: 0.2.1
license: MIT
description: "面向单张或批量图片的视觉处理、质量优化、内容理解与基础编辑目标，适用于图片尺寸缩放与体积治理、质量优先缩小体积、明确体积上限/质量值/格式转换的压缩、元信息探测、裁剪旋转翻转与圆角、颜色与锐化清晰度调整、负片、模糊与打码、水印、背景移除、文字识别、画质评估与智能裁剪等。若对象和目标族已明确属于图片优化、图片理解、图片隐私保护或图片基础编辑，但具体做法不确定，可先加载本 Skill 探索。"
permissions:
- shell
metadata:
  requires:
    bins:
    - mediakit-cli
  cliHelp: mediakit-cli image --help
  product: mediakit-cli-doubao/skills
  domain: image
  capability_count: 21
---
# image MediaKit Skill

## 使用规则

1. 先读取 `../byted-mediakit-shared/SKILL.md`，执行统一前置检查；该 Skill 缺失时停止并报告当前 Skill 包不完整。
2. 只从下表选择 `image` 域工具；相似能力按各工具“能力描述”和参数边界区分。
3. 执行前按需读取对应 reference；参数与结果说明来自同一份已审核文案，完整机器合同以当前 CLI `--schema` 为准。
4. 缺少必填参数、鉴权环境变量或真实输入资源时，向用户索取；通用可选字段只能透传用户明确提供的值，其他可选字段可由明确意图准确确定，但不得伪造。

## 澄清与跨域路由

若只说有图片而未说明业务目标，应先澄清。把多张图片做成视频、给视频叠图或视频画面裁剪应路由到 editing；视频抽帧、视频理解、视频增强或视频字幕擦除应路由到 video。

## 工具列表

| 工具 | 说明 | 支持模式 | 命令 | 参考 |
| --- | --- | --- | --- | --- |
| add-image-watermark | 为图片添加图文明水印，适用于版权标识与素材分发防盗链场景。 | Cloud | `mediakit-cli image add-image-watermark` | [reference/add-image-watermark.md](reference/add-image-watermark.md) |
| adjust-image-color | 对输入图像的亮度、对比度和饱和度进行调整，支持调亮、调暗、增强对比度、减弱对比度、增强饱和度、减弱饱和度共 6 种快速调整效果。适用于素材基础优化、统一内容视觉风格、营造庄重、复古等特殊氛围等场景。 | Cloud | `mediakit-cli image adjust-image-color` | [reference/adjust-image-color.md](reference/adjust-image-color.md) |
| compress-image | 有损图像压缩与格式转换工具；用户明确给出 quality、max_size、output_format、要求格式转换，或明确接受 PNG 有损压缩时选择。若用户强调尽量不掉画质、质量优先或高质量缩小体积，应优先选择 slim-image。 | Cloud | `mediakit-cli image compress-image` | [reference/compress-image.md](reference/compress-image.md) |
| crop-image | 对输入图像进行多模式裁剪，可执行方向裁剪、定向裁剪、自定义裁剪或内切圆裁剪，适用于多端尺寸适配、主体保留、商品图去边和指定区域截取。 | Cloud | `mediakit-cli image crop-image` | [reference/crop-image.md](reference/crop-image.md) |
| enhance-image | 基于图像内容理解进行智能决策，提升图片的分辨率、清晰度与色彩表现。 | Cloud | `mediakit-cli image enhance-image` | [reference/enhance-image.md](reference/enhance-image.md) |
| erase-image | 可按不同场景控制自动检测并擦除图片中的文字或常见图标，擦除后的区域通过智能填充技术进行修复，修复后的区域与背景自然融合。 | Cloud | `mediakit-cli image erase-image` | [reference/erase-image.md](reference/erase-image.md) |
| evaluate-image-quality | 用于图像画质评估，对输入图片进行主客观画质和美学评分，适用于质量监控、低质图筛查、内容审核、推荐排序和训练数据清洗。 | Cloud | `mediakit-cli image evaluate-image-quality` | [reference/evaluate-image-quality.md](reference/evaluate-image-quality.md) |
| face-blur-image | 自动检测图片中的所有人脸区域并进行马赛克处理，用于一键保护图片中的人脸隐私。支持社交平台内容审核、街景或监控画面脱敏、新闻媒体素材处理以及 AI 训练数据集脱敏等批量人脸隐私保护场景。 | Cloud | `mediakit-cli image face-blur-image` | [reference/face-blur-image.md](reference/face-blur-image.md) |
| flip-image | 支持对单张图片执行水平或竖直翻转。 | Cloud | `mediakit-cli image flip-image` | [reference/flip-image.md](reference/flip-image.md) |
| gaussian-blur-image | 用于图像高斯模糊；通过设定模糊强度快速对图片进行模糊处理，适用于隐私信息弱化、背景氛围化、生成预览图及封面背景等场景。 | Cloud | `mediakit-cli image gaussian-blur-image` | [reference/gaussian-blur-image.md](reference/gaussian-blur-image.md) |
| image-ocr | 用于通用印刷体文字识别（OCR），识别图片中的简体中文和英文，并提供文本块位置坐标与置信度参考。 | Cloud | `mediakit-cli image image-ocr` | [reference/image-ocr.md](reference/image-ocr.md) |
| invert-image | 用于图像负片，对输入图像执行负片（反相）效果，将图像的明暗关系与颜色映射为原图的相反效果，即明暗反转、色彩转为补色。 | Cloud | `mediakit-cli image invert-image` | [reference/invert-image.md](reference/invert-image.md) |
| mosaic-image | 支持对整张图像或指定矩形区域进行马赛克打码，可调整像素格形状与大小。支持用于遮挡人脸、证件信息、车牌、聊天记录等敏感内容。 | Cloud | `mediakit-cli image mosaic-image` | [reference/mosaic-image.md](reference/mosaic-image.md) |
| probe-image-metadata | 支持查询 metadata、avghue、alpha、blurhash 四种图像信息。 | Cloud | `mediakit-cli image probe-image-metadata` | [reference/probe-image-metadata.md](reference/probe-image-metadata.md) |
| remove-image-background | 自动识别并保留图像主体，移除背景后生成背景透明的图片，用于图像背景移除（抠图）。 | Cloud | `mediakit-cli image remove-image-background` | [reference/remove-image-background.md](reference/remove-image-background.md) |
| resize-image | 用于图像缩放，支持按指定宽高精确缩放，也可按长边、短边或等比模式缩放，适用于多端素材适配、封面与缩略图生成及批量图片预处理。 | Cloud | `mediakit-cli image resize-image` | [reference/resize-image.md](reference/resize-image.md) |
| rotate-image | 通过设置旋转角度和旋转背景样式对图片进行旋转处理，适用于图片方向校正、创意编辑和批量图像处理。 | Cloud | `mediakit-cli image rotate-image` | [reference/rotate-image.md](reference/rotate-image.md) |
| round-corner-image | 为图片四角快速添加正圆或椭圆圆角，适用于头像、卡片、电商主图等常见视觉编辑场景。 | Cloud | `mediakit-cli image round-corner-image` | [reference/round-corner-image.md](reference/round-corner-image.md) |
| sharpen-image | 用于图像锐化，通过对输入图像进行锐化处理，有效增强图像的边缘细节与整体清晰度。适用于电商素材优化、UGC 画质增强、封面海报二创等场景。 | Cloud | `mediakit-cli image sharpen-image` | [reference/sharpen-image.md](reference/sharpen-image.md) |
| slim-image | 质量优先的图片瘦身工具；用户强调尽量不掉画质、质量优先或高质量缩小体积，且未要求精确体积上限、质量值或格式转换时优先选择。 | Cloud | `mediakit-cli image slim-image` | [reference/slim-image.md](reference/slim-image.md) |
| smart-crop-image | 自动识别图像中的主体人脸区域，并适配指定尺寸进行裁剪；支持普通人脸和动漫人脸场景。未识别到人脸时，可按预设的降级策略输出结果。 | Cloud | `mediakit-cli image smart-crop-image` | [reference/smart-crop-image.md](reference/smart-crop-image.md) |

---

## 附录：婚礼手卡背面封面图生成提示词

适用于婚礼主持手卡、司仪提词卡等场景的背面封面图设计。生成后可配合 `resize-image`（缩放至目标尺寸）、`compress-image` / `slim-image`（体积优化）、`adjust-image-color`（色调微调）等工具进行后处理。

### 提示词模板（直接复制，替换占位符）

```
你是一个有丰富经验的封面设计师，现在要设计一张用于结婚主持卡封面图，生成一张 A5 大小的图片，背景为简约高级红色，可以有暗花，图片内侧可以有简约的金边图案，然后这个封面图可以纵向拿着上下对折，对折的上一半里面放囍字和新郎新娘的名字：{{新郎姓名}} 和 {{新娘姓名}}，结婚日期为 {{结婚日期}}，下一半不需要添加文字和囍字
```

### 详细设计参数

| 项目 | 规格 |
|------|------|
| **尺寸** | 1448×2048px，竖版比例接近 A5（148×210mm），可直接印刷 |
| **背景** | 深邃酒红色，配有低调缠枝花卉暗纹 |
| **金边** | 四周纤细金色描边，四角中式回纹角花 |
| **上半部分** | 金色大 "囍" 字 + 新人姓名 "{{新郎姓名}} {{新娘姓名}}" + 婚期 "{{结婚日期}}" |
| **下半部分** | 纯净留白，仅保留红底暗纹金边，对折后为背面 |
| **对折线** | 画面中部有自然分隔线，沿此线上下对折即可 |

### 占位符说明

| 占位符 | 示例 | 说明 |
|--------|------|------|
| `{{新郎姓名}}` | 黄xx | 中文名，直接写 |
| `{{新娘姓名}}` | 任x | 中文名，直接写 |
| `{{结婚日期}}` | 2026-09-07 | 建议用横杠分隔，与囍字风格统一 |

### 生成后处理建议

1. **尺寸校准**：若需精确 A5 印刷尺寸（2480×1748px @300dpi 横版或 1748×2480px 竖版），使用 `resize-image` 按长边等比缩放
2. **体积优化**：用于网页/电子预览时用 `slim-image` 质量优先瘦身；用于打印传输时用 `compress-image` 指定 quality=90 以上
3. **色调统一**：若与手卡正面酒红色（#8f2c3a）有偏差，用 `adjust-image-color` 微调饱和度和对比度
4. **画质增强**：如生成图偏模糊，用 `enhance-image` 提升清晰度与色彩表现