验收、上架、归档这些活的共同点是:照片拍得快、表格填得慢。每张照片问的是同一组问题,答案靠人肉搬进表。本篇用阿里云百炼命令行的 bl vision describe,把"一摞照片"变成"一张可核对清单表",全流程四步,附三个实测解析坑与兜底写法。
一、能力与边界先说清
bl vision describe 接受本地图像路径或 URL,也接受本地视频(mp4/mov/avi/mkv/webm),不用先上传;--prompt 缺省为 auto-detected,默认模型 qwen3-vl-plus。它做语义核验(有无/姿态/材质/文字),不做毫米级测量与证件级鉴真。批量没有原生参数,循环就是批量。
二、环境准备
- 装命令行:入口在CLI 安装页
- 领 Key:在控制台密钥管理页签发
- 准备一摞照片放进一个文件夹
- 写下你的字段清单(业务要什么问什么,建议十个字段以内)
- 先登记 ground truth:逐张目检写下"正确答案"六项,再跑核验;不登记就没有对错基准
- 误报格处置预案:标记不删除,初筛/复核/终判三列分开
三、第一步:把清单写成 schema
开放问回散文、不传 prompt 回英文散文,都进不了表。正确写法是把字段与取值格式写进 prompt:
bash
bl vision describe --image shelfA.png --prompt "逐行回答,每行格式为「字段: 值」,只输出六行:主体: 有无橘色狐狸玩偶;姿态: 直立坐姿/四足站姿/无;白色腹部: 有/无;货架材质: ;背景物体: ;画面文字: 有/无"
实测三张照分别 3.8 / 3.2 / 3.9 秒回六行,行序稳定。批量写法就是一个 for 循环逐张跑、六行块追加同一文件。

四、第二步:三个解析坑与兜底
补充两条循环纪律:退出码 2 与 1 分两个重试队列;单张耗时入账(实测 3.8/3.2/3.9 秒),整摞耗时上限按张数乘四秒留一倍余量排期。
坑一,否定答案塌缩行格式:空货架图返回「主体: 有无橘色狐狸玩偶: 无」,选项串回显进值里。兜底写法:按「字段: 」切分后,若值里还含选项串,取最后一段。
坑二,二选一字段误报:侧身图报「白色腹部: 有」,目检躯干全橘、仅颈部浅色。兜底写法:业务关键字段留人工复核列,误报格标记不删除。
坑三,默认 prompt 回英文:中文清单必须显式传 prompt,否则下游要双语兼容。
五、第三步:循环与重试纪律
批量循环两条纪律:退出码 2 与 1 分两个重试队列分开重跑;单张耗时入账(实测 3.8/3.2/3.9 秒),整摞耗时上限按张数乘四秒留一倍余量排期。开放问与默认问可选跑:开放问散文进备注列,默认问仅用于语言回归。
六、第三步:跨照片核对与视频验收
同批照片个体不一致时清单会报差异:正面图「直立坐姿」、侧身图「四足站姿」,摆放规则校验直接消费该差异;同时登记反向边界(误报格说明差异检测不完备),管线定位初筛而非终判。

视频同入口:--video 传本地 mp4,实测五秒片 7.1 秒回三行,动作按时间轴拆四段(0.2s/1.0s/2.0s/3.0-4.0s),并报告右下角始终显示「AI 生成」角标。演示片合规标注核验可以写成清单字段。

六、常见问题
问:路径写错会怎样?答:退出码 2,报 File not found 加路径,批量脚本据此修文件清单。
问:把音频当图片传呢?答:退出码 2,报 Unsupported image format ".mp3" 并附 hint,扩展名白名单进上传前校验。
问:模型名写错呢?答:退出码 1,回 HTTP 404 与 Request ID,据此修模型名或权限。
问:能一次传多张图吗?答:本命令单图单次调用,批量用循环;实测单张 3-4 秒,一摞照片的耗时可线性估算。
问:视频必须先上传吗?答:不用。--video 直接收本地 mp4/mov/avi/mkv/webm 路径,实测五秒片 7.1 秒回三行带时间轴。
问:ground truth 登记麻烦吗?答:三张样本六项字段逐张目检写三行即可;真实业务照片由业务方登记,登记完才跑核验。
问:表里要不要存原始返回?答:要。worked row 规格为六值数据列 + 退出码/耗时/复核标记三列 + 原始六行块归档列;争议复盘先翻归档与登记,不重跑,原始块与登记行就是证据链。
问:字段能加到多少个?答:实测六字段稳定;经验上超过十个返回稳定性下降,宽表拆成两次提问。
问:清单表能直接对外发布吗?答:不能直接当终判。误报格实测存在(白色腹部一例),对外字段必须过人工复核位。
问:为什么不用 OCR 或相册识别?答:OCR 抽文字、相册标签是平台固定类别;本流程字段是语义自定义(有无/姿态/材质),两者都覆盖不了。
问:ground truth 谁来登记?答:自产样本由作者目检登记;真实业务照片由业务方登记,登记完才跑核验,否则结果无对错基准。
七、实测读数速查表
| 项 | 读数 |
|---|---|
| 单图清单问耗时 | 3.8 / 3.2 / 3.9 秒 |
| 视频五秒片耗时 | 7.1 秒 |
| 否定答案塌缩 | 1 例(空货架行,兜底取末段) |
| 二选一误报 | 1 例(侧身照白色腹部,留复核位) |
| 退出码 | 2 文件/格式,1 模型/权限 |
| 有效调用 | 6 次;失败探针 3 次 |
问:跑完要留什么?答:三样:带复核标记的清洗表、逐字归档的原始六行块、ground truth 三行登记。争议复盘顺序是归档、登记、必要时重跑,多数争议止于第一步。
八、效果展示与适用边界
三张自产货架照加一条五秒视频,全流程读数:单图 3.2-3.9 秒、视频 7.1 秒、错误探针即时返回;两处解析坑与一处语言坑全部留痕。适合门店验收、仓储盘点、电商上架、照片归档与 agent 视觉入口;不适合计量与鉴真类场景。
想开始的话,从CLI 安装页装好命令行,去控制台密钥管理页领 Key,先拿三张照片定六字段清单并登记三行 ground truth,跑通再上整摞;第一次跑建议把开放问也带上,散文进备注列,争议时比清单更有信息量。循环里记住两条:退出码分队列重试,单张耗时入账(张数乘四秒留一倍余量排期)。跑完保留原始六行块与 ground truth 三行登记,争议复盘先翻存档;prompt 加字段时升 schema 版本并重跑登记,旧行保留旧版本标签。