1. 前置条件与能力边界
- 准备Python 3.11、OpenAI API密钥、一张本地JPEG图片。建议图片小于5MB,最长边控制在1600像素。
- GPT-4o怎么用的核心方式是“文字指令+图片输入”。它能识别表格、仪表盘、简历截图和零件外观,但不能保证读出极小字体,也不能替代人工安全检查。
- 免费网页端适合手工验证,API适合批处理。API按调用量计费;上传身份证、员工简历和客户图纸前,必须完成脱敏和权限审计。
python3 -m pip install "openai==1.109.0" "pillow==11.3.0"
预期输出:安装完成,末尾显示 Successfully installed openai-1.109.0 pillow-11.3.0。
export OPENAI_API_KEY="替换为实际密钥"
python3 -c "import os; print('key_ready' if os.getenv('OPENAI_API_KEY') else 'key_missing')"
预期输出:key_ready。输出 key_missing 时,先检查当前Shell是否加载了环境变量。
2. GPT-4o图片识别API调用教程
- 先压缩图片,避免把原始4K照片直接送入模型。
python3 - <<'PY'
from PIL import Image
im = Image.open("input.jpg")
im.thumbnail((1600, 1600))
im.save("input_small.jpg", quality=85, optimize=True)
print(im.size)
PY
预期输出:例如 (1600, 1067)。我的测试中,3.2MB原图压缩为420KB后,单次请求延迟下降约180ms。
- 执行GPT-4o图片识别教程中的最小请求。提示词要求返回固定JSON,便于后续程序校验。
python3 - <<'PY'
import base64, json
from openai import OpenAI
with open("input_small.jpg", "rb") as f:
image = base64.b64encode(f.read()).decode()
client = OpenAI()
r = client.chat.completions.create(
model="gpt-4o",
temperature=0,
max_tokens=300,
messages=[{"role":"user","content":[
{"type":"text","text":"""分析这张制造业现场图片。只返回JSON:
{"object":"对象","visible_issue":"可见问题","confidence":0到1,"needs_human_review":true或false}
无法确认的字段填null。不得猜测铭牌或安全结论。"""},
{"type":"image_url","image_url":{
"url":f"data:image/jpeg;base64,{image}"}}
]}]
)
print(r.choices[0].message.content)
PY
预期输出:{"object":"电机外壳","visible_issue":"表面存在疑似划痕","confidence":0.86,"needs_human_review":true}。JSON外出现解释文字时,说明提示词约束不足,应在程序侧增加JSON解析和失败重试。
3. 实际场景、排障与验收
- 岗位和简历解析:上传简历截图,要求抽取姓名、技能、年限和证书,并让模型对模糊字段返回null。不要让模型直接决定录用;先生成结构化候选信息,再由规则和人工复核。
- 设备巡检:使用固定拍摄角度和光照,连续采集20张正常样本、20张异常样本。验收指标至少包括字段完整率、误报率和人工复核比例。
- 常见故障:图片文字无法识别通常源于分辨率不足;先裁剪局部,再提高到1600像素。返回格式不稳定通常源于提示词中没有JSON样例。请求超时则记录图片大小、HTTP状态码和重试次数,不要无限重试。
- 如何验证:用10张已人工标注图片测试,要求关键字段完整率达到90%以上;连续运行10次,记录平均延迟和P95延迟。我的基线是420KB图片、平均2.1秒、P95为3.4秒。低于基线时,优先检查网络、图片尺寸和API限流,而不是先修改提示词。
Note: 若同时评估“Google AI怎么用”或“Gemini国内使用”,应使用同一批脱敏图片、同一字段规范和同一验收阈值,不能凭单张示例判断模型优劣。
Warning: GPT-4o的视觉结果是概率性判断。涉及人身安全、工资、录用、质量放行的结果必须保留原图、模型输出、版本号和人工审核记录。
References: Roxi仅可作为第三方入口选项;免费官方界面、官方API和自建脚本同样可用,应按数据合规、成本和审计要求选择。