全品类商品图：详情图
跟随实机演示，了解从上传商品照片到生成详情图组的操作流程。
使用教程
选择适合你的教程，快速掌握 EzPic 的各项功能
爆款复刻
学习使用参考图复刻构图与视觉风格，完成单图复刻、批量复刻和包装复刻。SKU 替换提供独立的智能、局部与多场景工作台。
视频教程即将上线
可切换至「图文教程」查看操作指南
模特穿搭
了解如何搭配服装与模特素材，设置穿搭场景，生成服装展示图片。
视频教程即将上线
可切换至「图文教程」查看操作指南
图片精修
学习通过精修要求与背景设置，改善商品照片的光影、质感和细节。
视频教程即将上线
可切换至「图文教程」查看操作指南
图片翻译
了解如何选择目标语言与翻译要求，制作适合不同市场的商品图片。
视频教程即将上线
可切换至「图文教程」查看操作指南
万能画布
学习在画布中组织素材、连接生成节点，使用图片编辑工具与模板完成创作。
视频教程即将上线
可切换至「图文教程」查看操作指南
电商视频
了解脚本直出、脚本帮写与爆款复刻流程，将商品素材转化为电商视频。
视频教程即将上线
可切换至「图文教程」查看操作指南
EzPic 全功能使用指南
查看详细操作步骤、功能说明与实际效果示例。
MCP 接入教程
连接常用 AI 工具，在对话中使用 EzPic 策划和生成商品图片。
一、准备 EzPic 密钥
登录 EzPic，点击下方「打开密钥管理」创建并复制 API Key。接入后可以查询余额和模型，完成主图、详情图、广告图、风格复刻、精修与图片翻译的创作流程。
MCP 服务地址 · Streamable HTTP
https://ezpicai.cn/mcp鉴权方式为 Authorization: Bearer YOUR_EZPIC_API_KEY。仅在自己的客户端替换密钥，保留 Bearer 后的空格；无需克隆项目或部署服务。已有配置请合并 EzPic 条目，保留其他服务。
二、选择你的 AI 工具
1. 设置密钥环境变量
先把 YOUR_EZPIC_API_KEY 替换为自己的密钥。Windows 在 PowerShell 中设置用户环境变量，然后完全退出并重新打开 Codex。macOS/Linux 的命令仅对当前终端及其启动的程序有效；设置后从该终端启动 codex。
Windows · PowerShell[Environment]::SetEnvironmentVariable("EZPIC_API_KEY", "YOUR_EZPIC_API_KEY", "User")macOS / Linux · 终端export EZPIC_API_KEY='YOUR_EZPIC_API_KEY' codex2. 添加用户级配置
打开 ~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml），追加下方配置；已有 ezpic 配置时更新原项。桌面端也可从 MCP 设置进入配置文件。
config.toml[mcp_servers.ezpic] url = "https://ezpicai.cn/mcp" bearer_token_env_var = "EZPIC_API_KEY"3. 重新连接并检查
重新打开 Codex，在 MCP 设置中确认 ezpic 已启用；CLI 可运行 codex mcp list 查看配置，并在会话中用 /mcp 检查连接。macOS 桌面端需确保启动进程能读取 EZPIC_API_KEY，仅在终端执行 export 不会影响已打开的桌面应用。随后发送下方连接验证指令。
1. 添加远程 MCP 服务
安装并登录 Claude Code 后，在终端执行下方单行命令，先替换密钥占位符。--scope user 让配置在所有项目可用；命令会把密钥保存在本机客户端配置中，请勿分享含真实密钥的命令或截图。
PowerShell / macOS / Linuxclaude mcp add --transport http --scope user --header "Authorization: Bearer YOUR_EZPIC_API_KEY" ezpic https://ezpicai.cn/mcp2. 检查连接状态
重新进入 Claude Code，输入 /mcp，确认 ezpic 已连接并按客户端提示允许使用工具。若提示同名服务已存在，先用 claude mcp get ezpic 检查现有配置，不要重复添加。
3. 发送验证指令
在新对话中发送下方连接验证指令，检查是否实际返回账户余额与模型列表。EzPic 使用 API Key，无需执行 OAuth 登录。
1. 打开 MCP 配置
进入侧边栏「插件」→「MCP 服务器」→「配置 MCP」。部分版本入口为「连接器」→「自定义连接器」。选择用户级配置 ~/.workbuddy/mcp.json，Windows 对应 %USERPROFILE%\.workbuddy\mcp.json。
2. 填写服务地址与密钥
把下方 ezpic 条目合并到现有 mcpServers 中，并替换密钥占位符。如果界面使用表单，选择 HTTP / Streamable HTTP，填写同一 URL，并添加 Authorization 请求头，值为 Bearer 加空格再加密钥。
用户级 mcp.json{ "mcpServers": { "ezpic": { "url": "https://ezpicai.cn/mcp", "headers": { "Authorization": "Bearer YOUR_EZPIC_API_KEY" } } } }3. 启用并验证
保存后启用 ezpic，刷新连接或重新打开 WorkBuddy。在新对话中发送下方连接验证指令，并按客户端提示允许工具调用。
1. 打开用户级配置
在 Cursor 设置的 MCP 页面添加自定义服务，或编辑 ~/.cursor/mcp.json（Windows 为 %USERPROFILE%\.cursor\mcp.json）。使用用户级配置可在多个项目复用。
2. 合并 EzPic 配置
把 ezpic 条目加入现有 mcpServers，并替换密钥占位符。不要覆盖其他服务，也不要将含真实密钥的配置提交到代码仓库。
用户级 mcp.json{ "mcpServers": { "ezpic": { "url": "https://ezpicai.cn/mcp", "headers": { "Authorization": "Bearer YOUR_EZPIC_API_KEY" } } } }3. 启用 Agent 工具
保存后在 MCP 设置中确认 ezpic 已启用，必要时重启 Cursor。在 Agent 对话中发送下方连接验证指令，并确认工具可用。
1. 打开用户配置
先启用 GitHub Copilot 的聊天与 Agent 能力。打开命令面板（Windows/Linux：Ctrl+Shift+P；macOS：Cmd+Shift+P），运行 MCP: Open User Configuration。
2. 合并服务器和密钥输入配置
VS Code 使用 servers，而不是 mcpServers。将下方内容合并到用户 mcp.json；已有 inputs 时追加 ezpic-api-key。首次启动会弹出隐藏输入框，请在客户端输入密钥，无需写入示例配置。
用户 mcp.json · 本地 Chat Agent{ "inputs": [ { "type": "promptString", "id": "ezpic-api-key", "description": "请输入 EzPic API Key", "password": true } ], "servers": { "ezpic": { "type": "http", "url": "https://ezpicai.cn/mcp", "headers": { "Authorization": "Bearer ${input:ezpic-api-key}" } } } }3. 启动并信任服务器
运行 MCP: List Servers，选择 ezpic 并启动，确认信任后填写密钥。在本地 Chat 的 Agent 模式下，通过工具选择器启用 EzPic，再发送连接验证指令。本示例使用交互式密钥输入，不适用于不转发 inputs 的 Agent Host 会话。
三、验证连接
将下面的指令发送给 AI。成功调用后，应返回当前账户积分与可用模型；只看到“配置完成”还不能说明连接成功。该步骤不会调用策划或生成工具。
连接验证 · 只读查询
请使用 EzPic MCP 的 ezpic_get_account 和 ezpic_list_models，查询我的积分余额和可用图片模型，并展示实际返回结果。这次只验证连接，不进行策划、分析或图片生成。四、开始商品图片创作
商品图可以使用已有的公开 HTTPS 图片链接，也可以由 AI 客户端先上传本地截图。先准备素材，再说明需求并完成必要策划，查看方案及报价，确认后生成。
使用本地截图或商品图片
将下方路径替换为自己的文件。客户端需要能读取本地文件并执行 HTTP 上传；远程 MCP 服务无法直接读取你的电脑。支持静态 JPG、PNG、WebP，单张最大 10MB、4000 万像素。上传后图片存放在 EzPic 公开可访问的临时素材存储中，请仅上传愿意用于创作的图片。
本地截图 · 替换文件路径后发送
请使用我电脑上的图片 C:\Users\你的用户名\Pictures\商品截图.png。先读取该文件的名称、图片类型和实际字节数，调用 EzPic 的 ezpic_prepare_image_upload 获取上传地址；使用本地文件/终端工具按返回的要求 PUT 上传原始二进制，不要把路径或 Base64 当作 imageUrls。上传成功后调用 ezpic_complete_image_upload，把返回的 url 用作商品素材。请先只完成上传并返回地址，不要策划或生成；若你无法读取本地文件或发送 HTTP，请直接说明。申请上传地址 → 客户端 PUT 上传 → 确认上传并获取素材 URL。上传本身不扣生成积分；图片地址按临时素材生命周期清理，请及时使用。若工具列表中没有两个上传工具，需先更新服务端并重新连接客户端。
用素材地址开始创作
将下方地址替换为上传确认返回的 URL，或已有的公开图片直链。
商品主图 · 替换图片地址后发送
请使用 EzPic 为这个商品制作 3 张主图。商品图片：https://你的图片域名/product.jpg。保持商品外观一致，不编造未提供的商品信息。先告诉我必要分析与策划是否收费，如收费先征得我同意；完成策划后，展示每张图的方案、模型、尺寸、生图速度与积分报价，等我确认后再提交生成。生成后继续查询任务并返回图片链接。图片生成消耗 EzPic 积分，分析与策划也可能按功能计费。实际费用、模型参数和报价有效期以工具返回为准。修改方案或参数后应重新报价；任务处理中请继续查询原任务，避免重复提交。
常见问题
密钥无效或返回 401
检查密钥是否复制完整、仍处于启用状态；Authorization 必须是 Bearer 加空格再加密钥。更换密钥后刷新客户端连接。
权限不足或返回 403
检查返回的权限提示、账户状态与密钥权限。不要只反复重试；确认当前密钥允许访问对应功能，仍有问题时联系支持。
配置成功，却看不到工具
确认地址以 /mcp 结尾，使用 HTTP / Streamable HTTP；检查 JSON/TOML 格式、配置作用域和客户端工具开关，然后重新连接。组织策略也可能限制 MCP 使用。
Codex 提示环境变量不存在
环境变量必须能被启动 Codex 的进程读取。Windows 设置用户变量后完全退出并重启客户端；macOS/Linux 在设置 export 的同一终端启动 CLI，桌面程序不会自动继承另一个终端的变量。
本地截图路径被拒绝
先用 ezpic_prepare_image_upload 申请上传地址，由 AI 客户端读取并 PUT 上传文件，再用 ezpic_complete_image_upload 获取 HTTPS 素材地址。本地路径只由客户端读取，不能直接填入 imageUrls 或 assets[].url。客户端需要具备文件读取和 HTTP/终端能力，仅在聊天中附图不代表文件已上传。
图片上传失败或上传地址过期
支持静态 JPG、PNG、WebP，单张最大 10MB、4000 万像素。按返回的 Content-Type 上传原始二进制，文件字节数需与申请一致；不要发送 JSON、Base64 或 multipart。上传地址 5 分钟有效，确认令牌 15 分钟有效，过期后重新申请。
图片链接不可访问
已有图片链接需为可直接打开图片的公开 HTTPS 地址，不要使用商品网页、需要登录的网盘链接或 localhost。本地文件请先完成上方的上传流程，再使用确认工具返回的地址。
报价过期、参数变化或积分不足
让 AI 获取最新报价，检查模型、张数、尺寸和速度，确认余额足够后再授权生成。价格与有效期以实际返回为准，修改方案后需重新报价。
任务一直处理中或部分失败
让 AI 用已有流程 ID 或任务 ID 继续查询，不要重复提交生成。部分失败时先查看每张图的结果及退款状态，再决定是否重做。