DOCUMENTATION

meitu cli 开发者文档

meitu cli 是美图 AI 能力的命令行工具包，可通过龙虾（Lobster）Agent 直接调用，也可作为独立 CLI 在终端中使用。

快速开始

安装meitu-cli:

npm install -g meitu-cli

复制

配置ak/sk:

meitu config set-ak --value xxxxx
meitu config set-sk --value xxxxx

请先登录获取密钥

添加技能meitu-skills:

clawhub install meitu-skills

复制

Skill 能力一览

文搜图

meitu image-search --prompt "search for cute cats" --json

复制

通过关键词或上传图片进行图片搜索。

图片生成

meitu text-to-image --prompt "a fluffy white cat sitting on a wooden chair" --json

复制

根据纯文字描述从零生成图片。

写真生成

meitu image-portrait-generate --image_list <portrait_url>
--prompt "high fidelity portrait photo" --json

复制

基于人像或宠物照片生成高精度保真写真。

AI 换头

meitu image-face-swap --head_image_url <source_face_url>
--sence_image_url <target_scene_url> --prompt "natural blend" --json

复制

将源图中的人脸替换到目标场景图上。

海报生成

meitu image-poster-generate --prompt "summer sale poster, blue tone"
--model Praline_2 --json

复制

基于文字或图片生成多风格多尺寸海报。

图片换装

meitu image-outfit-swap --image_url <person_url>
--clothes_image_url <outfit_ref_url> --prompt "red dress" --json

复制

AI 虚拟换装，保留人物形象仅替换衣物，支持文字描述目标服装或上传参考服装图。

图片风格转换

meitu image-style-transfer --image_url <original_image_url> --prompt "anime style"
--json

复制

对图片进行风格化处理。

图片超清

meitu image-superres-enhance --image_url <image_url>
--prompt "e-commerce white background product" --json

复制

提升图片清晰度与分辨率。

图片暗部增强

meitu image-lowlight-enhance --image_url <image_url> --json

复制

对暗光、夜景、曝光不足的图片进行智能亮度提升与暗部细节恢复。

图片去噪

meitu image-denoise-enhance --image_url <image_url> --json

复制

去除图片中的颗粒感、噪点和杂色，在降噪的同时保留图像细节与纹理。

图片变换

meitu image-transform --image_url <image_url> --rotate 90 --json

复制

图片几何变换工具集：任意角度旋转/水平垂直翻转、等比放大（2/4/8 倍）、无损等比缩小、画布向外扩展并 AI 智能补全扩展区域。

宫格拆分

meitu image-grid-split --image_url <grid_image_url> --json

复制

自动识别宫格分割线，将一张四宫格/九宫格/多格拼合图拆分为多张独立图片。

抠图

meitu image-cutout --image_url <image_url> --prompt "person cutout" --json

复制

精准分离前景主体与背景。

图片换背景

meitu image-background-replace --image_url <image_url>
--prompt "beach sunset background" --json

复制

保留图片前景主体不变，通过文字描述替换为新的背景场景。

图片消除

meitu image-element-remove --image_url <image_url> --target watermark --json

复制

消除图片中的不需要元素。

图片改字

meitu image-text-replace --image_url <image_url> --source_words "original text"
--target_words "new text" --json

复制

替换图片上的文字内容。

图片编辑

meitu image-edit --image_list <base_image_url>
--prompt "change background to cinematic style" --json

复制

基于图片加文字指令的通用图片编辑。

证件照生成

meitu image-id-photo-generate --image_url <portrait_url> --spec_type "1-inch"
--bg_color "white" --json

复制

基于用户照片，询问用户证件规格，一键生成换装换背景的标准证件照。

文生视频

meitu text-to-video --prompt "a white cat walking on a wooden chair"
--video_duration 5 --json

复制

根据纯文字描述生成动态视频。

图生视频

meitu image-to-video --image_list <image_url>
--prompt "make the person smile and wave" --json

复制

以图片驱动生成动态视频。

视频动作迁移

meitu video-motion-transfer --image_list <person_url>
--reference_video_list <motion_video_url> --prompt "mimic dance moves" --json

复制

将参考视频中的动作姿态迁移到图片人物上。

多模态视频

meitu video-multimodal-generate --image_list <image_url>
--reference_video_list <video_url>
--prompt "same camera movement style, ancient Chinese city street scene with people walking"
--video_duration 5 --ratio "16:9" --json

复制

支持音频、视频、图片、文字任意组合的多模态混合驱动生成视频。

视频创意生成

meitu video-effect-apply --video_url <video_url> --prompt "anime style effect" --json

复制

对已有视频施加创意处理，涵盖 10 种子能力：预设风格特效、Emoji 表情驱动、360° 运镜、3D 小人叠加、风格转换、舞蹈驱动/模板、剧情魔法特效、AI 创意效果、长视频风格转绘（动漫/像素/黏土）。

视频扩展

meitu video-canvas-expand --video_url <video_url> --prompt "expand canvas"
--expand_ratio 0.3 --directions "left,right" --json

复制

将视频画面向外扩展（outpainting），由 AI 智能补全扩展区域内容，可改变视频宽高比。

视频内容替换

meitu video-content-replace --video_url <video_url>
--prompt "change person clothes to red" --json

复制

替换或修改视频中的人物、场景、服装等内容元素，保留原始运镜和动作。

视频加Logo

meitu video-logo-add --video_url <video_url> --logo_url <logo_url>
--position "top-right" --json

复制

在视频画面四角定位叠加 Logo 或水印图片，支持透明底 PNG。

视频消除

meitu video-element-remove --video_url <video_url> --prompt "remove pedestrians"
--json

复制

消除视频中的干扰元素，支持四种模式：去路人/行人、去字幕（随时间变化的对白条带）、去水印/Logo/角标（固定位置）、一键清屏去除所有文字（需二次确认。

视频画质修复

meitu video-quality-enhance --video_url <video_url> --prompt "portrait video" --json

复制

一键全能画质修复，同时提升画质、帧率和分辨率，自动适配人像、演唱会、动漫、夜景、商品等全场景。

视频分辨率超分

meitu video-resolution-upscale --video_url <video_url> --target_resolution "1080P"
--json

复制

专项提升视频分辨率，支持输出目标 720P/1080P/2K/4K。

视频去噪

meitu video-denoise-enhance --video_url <video_url> --json

复制

去除视频中的颗粒感、色块和运动噪声。

视频暗部增强

meitu video-lowlight-enhance --video_url <video_url> --json

复制

对夜景或暗光环境拍摄的视频进行暗部细节恢复和亮度提升，平衡高光与阴影。

视频补帧

meitu video-framerate-enhance --video_url <video_url> --frame_rate 60 --json

复制

通过 AI 插帧提升视频帧率，让低帧率视频的运动画面更加流畅自然。

视频转GIF

meitu video-to-gif --video_url <video_url> --prompt "convert to GIF animation" --json

复制

将视频片段转换为 GIF 动图，支持两种模式：普通 GIF（等比例，长边 ≤480px）和透明底 GIF（240×240px 贴纸）。

视频拼接

meitu video-stitch --video_list <video1_url> <video2_url>
--prompt "sequential stitch" --json

复制

将多段视频按顺序拼接合并，支持两种模式：纯拼接保留原声（可指定 BGM）和拼接同时自动配乐一体化。

视频配音

meitu video-audio-add --video_list <video_url>
--prompt "add upbeat background music" --json

复制

为视频添加音频轨道，支持两种类型：背景音乐（BGM，支持素材库或自定义音频）和旁白配音（默认压低原声），两者可串联同时添加。

歌曲生成

meitu audio-song-generate --prompt "pop love song"
--prompt_lyrics "verse lyrics here..." --json

复制

歌词驱动的完整歌曲生成，包含人声、旋律与编曲，支持流行/古风/电子/摇滚等多风格。

纯音乐生成

meitu audio-music-generate --prompt "relaxing jazz" --duration 30 --json

复制

生成无人声无歌词的纯音乐/BGM，支持多种风格和 30-120s 时长控制。

代码生成

meitu text-code --prompt "create an animated login page" --json

复制

从零生成 React/TSX 页面代码，支持上传素材参考和 prompt 自动扩写。

代码编辑

meitu text-code-edit --prompt "change button color to red"
--source_code_url <source_code_url> --json

复制

对已有 TSX/JSX 源码进行编辑修改，支持多轮迭代和串联编辑。

文本生成

meitu text-generate --summary "generate a product marketing copy" --language "en"
--json

复制

通用文案生成、文本创作与润色、多语言文案、多模态参考文案生成、分镜脚本/故事板描述生成、视频提示词润色。