2026-07-02 本文总阅读量: 次 | 文章总字数: 2,227 字

用二维码、条形码和图片压缩接口构建营销物料自动化 Agent

摘要：营销活动经常需要批量生成二维码、条形码、落地页截图和压缩后的图片素材。本文演示如何把二维码生成、二维码解析、条形码生成、Wi-Fi 二维码、URL 截图和图片压缩接口组合起来，构建一个物料自动化 Agent。

关键词：二维码生成 API、条形码 API、图片压缩 API、营销物料 Agent、URL 截图 API

问题背景

活动运营、线下门店和渠道投放经常需要生成大量物料：商品条形码、活动二维码、Wi-Fi 二维码、落地页预览图、海报图片压缩包。手工制作容易出错，尤其是二维码内容、尺寸、图片格式和投放渠道要求不一致时。

Agent 可以把物料生成拆成标准流程：先接收活动参数，再生成二维码或条形码，然后解析校验，最后生成预览图和压缩素材。这样能减少错误链接、无效二维码和过大的图片文件。

Agent 工作流

Agent 工作流示意图

接口编排

步骤	接口	请求方式	用途
二维码生成	`通用二维码生成`	GET	生成活动链接、表单链接或下载链接二维码
条形码生成	`通用条形码生成`	GET	生成商品、票券或仓储条码
Wi-Fi 二维码	`Wi-Fi 无线网二维码生成`	GET	生成门店 Wi-Fi 连接二维码
二维码解析	`通用二维码解析读取`	POST	回读二维码内容，验证生成结果
URL 截图	`URL 生成网站截图`	GET	生成落地页预览图
图片压缩	`图片压缩与尺寸优化`	POST	按渠道要求压缩和调整图片尺寸

调用示例

生成活动二维码：

curl -G "https://api.gugudata.com/barcode/qrcode" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "content=https://example.com/campaign/landing" \
  --data-urlencode "size=512"

生成条形码：

curl -G "https://api.gugudata.com/barcode/barcode" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "content=6901234567890"

生成落地页截图：

curl -G "https://api.gugudata.com/websitetools/url2image" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "url=https://example.com/campaign/landing" \
  --data-urlencode "width=1200" \
  --data-urlencode "height=900" \
  --data-urlencode "isFullPage=false"

Agent 可以用任务对象管理物料：

def build_asset_task(campaign_id: str, landing_url: str) -> dict:
    """Build a campaign asset generation task."""
    return {
        "campaign_id": campaign_id,
        "landing_url": landing_url,
        "assets": ["qrcode", "landing_preview", "compressed_image"],
        "status": "pending",
    }

物料输出怎么组织

物料生成结果建议按渠道和用途整理：

字段	说明
campaign_id	活动 ID
asset_type	qrcode、barcode、preview、compressed_image
source_content	二维码或条码对应的原始内容
file_url	生成后的素材地址或本地路径
validation_status	是否通过解析校验
channel	用于门店、海报、短信、公众号或广告投放

二维码和条形码最好做回读校验。生成图片成功不代表内容正确，尤其是带参数的活动链接，可能因为编码、转义或复制错误导致无法追踪。

标准架构拆解

营销物料自动化可以拆成以下模块：

模块	责任
任务输入	接收活动链接、商品编码、门店信息和渠道规格
码图生成	生成二维码、条形码和 Wi-Fi 二维码
内容校验	解析二维码，确认内容与任务一致
图片处理	生成落地页截图，压缩图片和调整尺寸
交付记录	保存素材清单、状态和渠道使用记录

Agent 不需要知道设计稿内部结构。它只需要保证每个素材的业务内容正确、格式符合渠道要求，并能追踪生成记录。

数据流与接口边界

推荐流程如下：

运营提交活动链接、商品编码或门店 Wi-Fi 信息。
Agent 根据物料类型选择二维码、条形码或 Wi-Fi 二维码接口。
对生成结果做二维码解析校验。
对落地页生成截图预览。
对图片做尺寸和质量压缩。
输出素材清单和校验状态。
投放后保留素材版本，方便复盘。

接口边界上，码图生成接口负责生成图片，解析接口负责验证内容，图片压缩接口负责渠道适配。不要把校验省略成“图片能打开就算成功”。

错误处理

如果二维码解析结果和原始内容不一致，Agent 应把任务标记为失败并停止交付。如果落地页截图失败，应该提示检查 URL 可访问性。图片压缩后如果尺寸或格式仍不符合渠道要求，应继续调整参数或进入人工处理。

对于短链接和带追踪参数的链接，建议先做 URL 规范化，再生成二维码。

可靠性与观测

建议记录以下指标：

指标	用途
qrcode_generation_success_rate	二维码生成成功率
qrcode_validation_failed_count	回读校验失败次数
image_compression_ratio	图片压缩比例
asset_delivery_count	物料交付数量
channel_reject_count	渠道退回次数

如果渠道退回次数升高，通常是尺寸、格式或文件大小不符合要求，而不是二维码本身的问题。

落地清单

每个素材保存原始内容和生成参数。
二维码生成后必须做解析校验。
落地页截图用于预览，不替代真实页面测试。
图片压缩保留原图，方便回滚。
渠道规格用配置维护，不写死在提示词里。

可扩展方向

这个 Agent 可以继续接入 HTML 转 PDF 或 Markdown 转 PDF 接口，把活动说明生成可下载手册；也可以接入 URL 转静态 HTML，用来归档活动落地页版本。