用途:通过 Picsart 的 MCP 服务器(https://mcp.picsart.io/v1)调用四类 REST API,用于生成与编辑媒体内容。工具名等于 OpenAPI 的 operationId,连字符保留,例如 genai-text2image、image-remove-background、video-trim、vd-export-replay。
主要能力与四类接口:Image API(https://api.picsart.io/tools/1.0)提供去背景、放大、特效、蒙版、调整、水印、裁剪、混合、分割、打标签、矢量化、设计导入等;Video API(https://video-api.picsart.io/v1)提供视频编辑、裁剪、拼接、适配、特效、FPS 放大、缩略图、元数据、音频调整/提取/转录、CTV 编码、水印等;GenAI API(https://genai-api.picsart.io/v1)提供文生图、贴纸、Logo、图像编辑/修补/外扩、去物体、智能背景、扩展出血、文生视频、图生视频、文生语音、文生声音、文生文本补全等;Variable Data API(https://vd-api.picsart.io/v1)基于 Replay 模板批量生成个性化素材。
使用方式:需先连接 MCP 服务器并设置 PICSART_API_KEY 环境变量,配置中通过 X-Picsart-API-Key 头传入,切勿硬编码。另有一个 generative-AI 服务器 picsart-gen-ai(https://api.picsart.com/gen-ai/mcp)使用 OAuth,二者工具重叠,建议每次会话只选一条路径。输入支持文件或 URL(如 image_url、video_url),本机文件需先通过上传组件获得 URL。
关键流程:先按意图查阅对应 references/ 文档(image-api.md、video-api.md、genai-api.md、variable-data-api.md),再按 operationId 精确调用。异步任务会返回 job id,必须用配对轮询工具(如 genai-text2image 对应 genai-text2image-getresult)轮询到 FINISHED 或 succeeded 才能宣告完成,不能仅凭提交响应就告知用户已完成。枚举值(特效名、比例、风格、声音、输出格式)需逐字复制。进行可能产生高消耗的调用前,可先查询对应的额度工具(如 genai-credits-balance)避免 402。
适用场景:文生图/视频、图生视频、去背景、超分放大、自然语言图像编辑、修复与扩图、去物体、视频剪辑与转录、批量个性化渲染等。
限制:需遵循 Picsart 开发者准则,禁止不当内容;图片上传有尺寸与格式限制,视频有时长、分辨率与编码限制,GenAI 有提示长度、seed 与数量限制及安全过滤,Variable Data 有批量与模板兼容要求,具体见各参考文档。返回 URL 为签名/限时链接,需原样保留。以上为资料所述功能与用法,未提及的收费、价格或具体效果暂未提供。