1. 准备账号
用桌面浏览器在 API Keys 创建 Key。在同一个账号打开个人主页，点击充值；移动端购买使用会员与积分页。移动界面不提供 Key 创建入口。 所有 Skill 生成都只消耗购买积分（purchased_credits），第一张抠图也收费。API 不提供免费次数或每日免费积分。模型对比页用于查价，不是充值入口。
Key 应保存在本地私密配置或密钥管理服务中。示例从本地环境变量 MEIGEN_API_TOKEN 读取 Key，不要把真实密钥发到聊天、放进 URL 或提交到仓库。
请求体为 JSON。每个
/run 请求体最多 32 KiB，拒绝未知字段，必须带 UUID requestId。上传限制单独列在下文。Skill ID 为 remove-bg、product-detail、brand-poster、white-bg、upscale。
2. 查询当前契约
endpoint、tool、materials、pricing、maxOutputImages 和 inputSchema。枚举与价格以这些实时值为准；价格缺失或为 null 表示不可用，不表示免费。成功目录最多缓存五分钟，错误不缓存。服务端还会执行跨字段校验。
**商品详情图的 HTTP 与 MCP 有区别：**直接 HTTP 省略 modules 时默认生成三张付费图片；MCP 强制显式填写 modules。两种接入都建议明确发送所需模块。
Upscale 的两种 MCP 首次及后续调用均要求 confirmedCredits，来自用户或上层工作流已接受预算内的实时报价；直接 HTTP 仍可省略。
3. 准备图片
抠图、详情图、海报和背景的图片字段只接受images.meigen.ai、images.meigen.art、pbs.twimg.com 上的 HTTPS URL，不带凭据或非标准端口。其他来源先上传，再使用返回的 imageUrl。
**Upscale 单独处理：**把原始公开 JPEG/PNG/WebP URL 直接交给 /api/skills/upscale/run，不要先用普通参考图上传缩小它。附件字节使用 purpose: "upscale" 上传，保留像素尺寸。
success、imageUrl、width、height、firstFrameOnly。保存 imageUrl，恢复原请求时复用。
源图片服务器临时返回 429/5xx 时会转为 503。上传阶段等待后重试上传；若发生在 Upscale 提交过程中，则用该提交原 UUID 和参数恢复。
上传会完整解码和重编码，去除元数据，并在支持的格式中保留透明通道。上传不建生成任务、不消耗生成积分，但有独立的每用户每日 1,000 次上传请求保护上限。上传失败还没有 Skill 回执，应修正或重试上传，不要查询
/skills/status。
宿主必须能读取实际附件字节或访问 URL，不能猜路径、链接或编造 base64。上传 URL 不承诺永久保存，请保留原图并下载结果。
4. 提交并保存请求
各工作流页面包含请求体。每个新的付费请求生成新的 UUID，并保存 UUID、完整 JSON 请求体和返回的任务 ID。示例 UUID 仅作演示，不要用于不相关的多次请求。imageUrl。其他工作流返回 generationId，商品详情图返回 items。提交成功不等于图片已生成完成。
5. 查询和恢复
到达终态后停止普通轮询，展示成功图片并分别解释失败或缺失模块。退款以
creditsStatus 为准；HTTP 失败或图片缺失本身不能证明退款。
断线或 5xx 后先查状态。仅在允许恢复时，以同一个 requestId 和规范化参数重试；不要重新上传后静默替换 URL。重复已记录的提交会返回原结果，不再派发。中断工作进程的租约约 330 秒；重复提交的 409 in_progress 会返回剩余 retryAfterSeconds，状态查询仍可按正常间隔进行。
部分批次按已有任务恢复，不自动补生成缺失模块。替代批次或失败后的新尝试可能再次收费，需要有重试意愿。已退款的抠图重试也可能开启新的付费尝试。
计费与错误处理
商品详情图一次生成 1–6 张，按成功接收的模块预扣积分；其他工作流每次生成一张。用当前单张价格计算用户请求的总数。供应商失败沿用现有积分账本与退款规则。 API 有每用户、每 Skill、每日 1,000 次请求保护上限，工作流自身还可能有限制。它不是免费额度，充值不会移除此限制。目录与状态查询不消耗生成积分，回放已完成回执不会再次占用派发次数。
MCP 会额外提供
nextAction 指引；直接 HTTP 客户端根据上述状态码、code 和字段实现同样的流程，不要假设 HTTP 响应包含 MCP 专用的 nextAction 或资源链接内容块。
远程图片准备要求购买积分余额大于零，在读取请求体和处理图片之前检查。上传本身不扣生成积分；上传遇到 402 后，为同一账号充值并重试同一上传，不要查询未创建的生成任务。
已知受理任务的记录缺失时，返回 410 generation_unavailable 和原任务 ID。停止轮询，不自动重提或创建付费替代任务；记录缺失不证明已退款。部分缺失的批次保留仍可用的结果，并单独标注缺失项。