图像识别与二维码 Skill

面向二维码、条形码、二维码解析、图片识别和轻量图像处理的公开 API 组合。

业务场景

用于二维码生成、条形码生成、二维码解析、图片识别和轻量图像处理。适合运营物料、小程序工具、票据录入、表单识别和内容分享场景。

• 数据范围：覆盖二维码、条形码、二维码解析、图片压缩、图像 OCR 和部分文档图像识别能力。
• 关键数据维度：编码维度：文本、URL、Wi-Fi 信息、条码类型和输出图片格式。；识别维度：图片来源、清晰度、二维码内容、OCR 文本和识别置信度。；处理维度：压缩、格式、尺寸和可展示性。

何时使用

• 生成二维码、Wi-Fi 二维码或通用条形码。
• 解析二维码、识别图片文字或处理图片文件。
• 为营销活动、门店工具、文件录入和移动端表单提供图像辅助能力。

不适用场景

• 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时，直接打开接口详情页。
• 用户希望绕过接口开通、鉴权、配额或人工复核要求时，不应使用 Skill 作为替代。
• 任务需要法律、医疗、金融投资或升学录取的最终决策时，Skill 只能提供数据辅助和复核线索。

用户需要提供的信息

• 二维码、条形码、图片或文档图片来源，以及生成、解析、识别或压缩目标。
• 输出图片格式、尺寸、编码内容、识别语言或安全校验要求。
• 调用接口所需的 AppKey、开通状态和接口详情页限制。

推荐工作流

1. 生成类场景先选择二维码、Wi-Fi 二维码或条形码接口。
2. 识别类场景使用二维码解析或 OCR 接口。
3. 图片体积较大时，先压缩再进入后续流程。

参数传递关系

• 生成类任务使用文本、URL、Wi-Fi 信息或条码内容作为输入；解析类任务使用图片 URL 或上传文件作为输入。
• 二维码解析结果如果是 URL，需要先做安全校验再进入页面抓取或跳转。
• 图片压缩或识别后的结果可继续传给文档处理或文本处理流程。

典型任务模板

• 二维码生成：输入 URL 或文本；输出二维码图片和编码内容说明。
• 二维码解析：输入图片；输出解析文本、安全校验建议和后续处理入口。
• 图片识别：输入图片；输出识别文本、低质量提示和复核建议。

接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。AppKey 应从环境变量或凭据管理系统注入，不要写入 SKILL.md、代码仓库、URL、日志或对话正文。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 appkey 仍以接口详情页说明为准。

通用二维码生成

• 业务角色：二维码生成
• 调用阶段：生成
• 接口地址：GET https://api.gugudata.com/barcode/qrcode
• 产出用途：用于生成通用二维码。
• 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口资料：详情页 https://www.gugudata.com/api/details/qrcode；接口 Markdown https://www.gugudata.com/api/details/qrcode/llm.md

关键请求参数：

Wi-Fi 无线网二维码生成

• 业务角色：Wi-Fi 二维码
• 调用阶段：生成
• 接口地址：GET https://api.gugudata.com/barcode/wifiqrcode
• 产出用途：用于生成 Wi-Fi 无线网二维码。
• 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
• 接口资料：详情页 https://www.gugudata.com/api/details/wifiqrcode；接口 Markdown https://www.gugudata.com/api/details/wifiqrcode/llm.md

关键请求参数：

通用条形码生成

• 业务角色：条形码生成
• 调用阶段：生成
• 接口地址：GET https://api.gugudata.com/barcode/barcode
• 产出用途：用于生成通用条形码。
• 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口资料：详情页 https://www.gugudata.com/api/details/barcode；接口 Markdown https://www.gugudata.com/api/details/barcode/llm.md

关键请求参数：

通用二维码解析读取

• 业务角色：二维码解析
• 调用阶段：识别
• 接口地址：POST https://api.gugudata.com/barcode/qrcode/decode
• 产出用途：用于解析读取通用二维码。
• 参数来源：文件或图片来自用户上传、公开 URL 或上一轮转换结果
• 接口资料：详情页 https://www.gugudata.com/api/details/qrcode-decode；接口 Markdown https://www.gugudata.com/api/details/qrcode-decode/llm.md

关键请求参数：

通用图片地址 OCR 到文本

• 业务角色：图片地址 OCR
• 调用阶段：识别
• 接口地址：POST https://api.gugudata.com/imagerecognition/ocr
• 产出用途：用于识别图片地址中的文本。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性；文件或图片来自用户上传、公开 URL 或上一轮转换结果
• 接口资料：详情页 https://www.gugudata.com/api/details/ocr；接口 Markdown https://www.gugudata.com/api/details/ocr/llm.md

关键请求参数：

通用图片文件流 OCR 到文本

• 业务角色：图片流 OCR
• 调用阶段：识别
• 接口地址：POST https://api.gugudata.com/imagerecognition/imagestreamocr
• 产出用途：用于识别图片文件流中的文本。
• 参数来源：文件或图片来自用户上传、公开 URL 或上一轮转换结果
• 接口资料：详情页 https://www.gugudata.com/api/details/imagestreamocr；接口 Markdown https://www.gugudata.com/api/details/imagestreamocr/llm.md

关键请求参数：

图片 OCR 转 Word

• 业务角色：OCR 到 Word
• 调用阶段：转换
• 接口地址：POST https://api.gugudata.com/imagerecognition/ocr2word
• 产出用途：用于把图片 OCR 结果输出为 Word。
• 参数来源：语言参数来自用户指定的源语言、目标语言或语种检测结果；URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性；文件或图片来自用户上传、公开 URL 或上一轮转换结果
• 接口资料：详情页 https://www.gugudata.com/api/details/ocr2word；接口 Markdown https://www.gugudata.com/api/details/ocr2word/llm.md

关键请求参数：

图片压缩与尺寸优化

• 业务角色：图片压缩
• 调用阶段：处理
• 接口地址：POST https://api.gugudata.com/ai/image-compress
• 产出用途：用于图片压缩与尺寸优化。
• 参数来源：文件或图片来自用户上传、公开 URL 或上一轮转换结果；URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
• 接口资料：详情页 https://www.gugudata.com/api/details/image-compress；接口 Markdown https://www.gugudata.com/api/details/image-compress/llm.md

关键请求参数：

失败处理与恢复

• 缺少必填输入或数据口径不明确时，停止调用并先向用户补齐信息。
• 收到 401 或 403 时，检查 AppKey、安全配置和服务权限；不要在输出中回显凭据。
• 收到 429 时，遵守接口返回的限流提示，降低频率后再试，不要并发放大请求。
• 遇到网络或 5xx 异常时，只对幂等请求进行有限次数重试，并记录失败接口与时间。
• 数据为空或多接口结果冲突时，返回已确认事实、证据缺口和复核建议，不要臆造结论。

数据校验与使用边界

• 生成二维码前确认内容是否可公开展示。
• 图片识别结果受清晰度、遮挡、角度、压缩和背景影响。
• 二维码解析出的链接或文本需要安全校验后再展示或跳转。

输出建议

• 输出生成类结果时说明编码内容、用途和图片链接。
• 输出识别类结果时保留原图来源、识别文本和置信说明。
• 对无法识别或低质量图片给出重新上传建议。

常见问题

• 问：什么情况下应该使用这个 Skill？ 答：当用户提出的目标需要多个咕咕数据公开 API 组合完成，而不是只查询一个接口时，优先阅读这个 Skill。
• 问：这个 Skill 是否需要单独购买？ 答：不需要。Skill 文档只负责业务流程和接口选型，具体接口购买、价格和账号权益仍以接口详情页为准。
• 问：Agent 应该怎样使用这个 Skill？ 答：Agent 应先阅读 SKILL.md，确认业务场景和推荐工作流，再进入接口详情页核对参数、响应字段、价格和调用示例。
• 问：调用接口前需要先核对什么？ 答：需要核对业务对象、地区、时间范围、输入格式、必填参数、返回字段、购买状态和接口详情页中的限制说明。
• 问：图像识别与二维码 Skill 会替代接口文档吗？ 答：不会。Skill 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。