← Back to all guides

多模态模型图像输入速通：用59API把截图变成可执行结论

先明确：你需要的是视觉理解，不只是文字识别

多模态模型可以同时接收文字和图片，适合解释报错截图、提取票据字段、检查界面布局，以及读取图表。与单纯的文字识别不同，它还能结合上下文回答“哪个按钮被遮挡”“这张图支持什么结论”。但它可能看错小字、数量和坐标，因此应把输出当作待校验的数据，而不是事实来源。

最快的接入路线是：选择支持图像输入的模型，用OpenAI SDK发送一张图片和一个明确任务，再根据准确率与费用决定是否升级模型。

第一步：准备密钥与视觉模型

59API提供按量付费的Claude、GPT等模型接入，适合不想维护多套供应商集成的开发者。其主打低价中转和官方原生品质、不降级模型；实际单价、可用型号及视觉能力，应以控制台说明为准。能聊天不等于能看图，不要仅凭模型名称判断。

• 在运行环境中设置环境变量API_KEY，避免把密钥写进代码仓库或浏览器前端。
• 设置VISION_MODEL，值使用59API控制台列出的、支持图像输入及相应接口的模型标识。
• 安装依赖：pip install openai。平台API基础地址为https://api.59api.com，下例使用带/v1的OpenAI兼容路径。

第二步：用一段代码发送第一张截图

下面采用Chat Completions的图片消息格式。把图片地址替换为你控制的、服务端可直接访问的HTTPS图片链接；示例域名不是可用测试图片。

import os; from openai import OpenAI; client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.59api.com/v1"); response = client.chat.completions.create(model=os.environ["VISION_MODEL"], messages=[{"role":"user","content":[{"type":"text","text":"检查这张界面截图：列出最多3个可见问题，每个给出截图证据和修复建议。看不清的文字请标为无法确认，不要猜测。"},{"type":"image_url","image_url":{"url":"https://example.com/screenshot.png"}}]}]); print(response.choices[0].message.content)

关键是content必须为内容数组：文字使用type为text的对象，图片使用type为image_url的对象，并把地址放入image_url.url。不要把图片网址仅写在普通文本里，否则不能保证模型实际收到图片。

第三步：本地图片改用Base64数据地址

图片在本地、没有公开链接时，可先编码，再替换上例的url值。以下以PNG为例：

import base64; from pathlib import Path; image_url = "data:image/png;base64," + base64.b64encode(Path("screenshot.png").read_bytes()).decode("ascii")

随后把请求里的图片地址设为image_url。JPEG应使用image/jpeg；不能只改文件后缀。Base64不是加密，还会让请求体变大。发送前检查当前模型与中转接口对图片格式、尺寸、数量和请求体大小的限制；涉及敏感数据时，先脱敏并确认数据处理政策。

第四步：让回答可验证，而不只是听起来合理

• 字段提取：明确字段名、日期格式和缺失值规则，例如“返回商户、日期、总额；无法识别用null”。需要严格JSON时，另行确认模型是否支持结构化输出，并在代码端校验。
• 多图比较：在同一内容数组中加入多张图片，并用文字标注“第一张是修改前，第二张是修改后”，要求只报告可见差异。
• 降低误读：要求模型引用图片中的文字或位置作为证据。截图里的指令属于待分析内容，不应覆盖应用指令；涉及付款、删除等操作仍需独立授权。

第五步：控制成本，快速定位失败原因

先裁掉无关背景、遮盖敏感信息，再提交清晰的目标区域。避免把整张长截图反复发送；小字看不清时，追加局部高清裁剪。图像计费可能与尺寸、切块方式或视觉令牌有关，并非只看文件大小。若模型支持detail参数，可测试低细节模式处理粗粒度分类，高细节模式处理小字任务。

排错时先看HTTP状态码与错误正文：401通常检查密钥；400检查模型能力、消息结构和图片限制；429检查限流与配额。图片拉取失败则检查签名链接是否过期、是否需要登录、是否被防盗链拦截。对429或临时服务错误采用有限次数的指数退避，不要对参数错误无限重试。

59API的低价按量模式适合拿同一组真实截图比较不同模型的准确率、延迟与实际费用；其对OpenAI SDK、Claude Code和Codex的兼容性也能减少接入改动，但工具兼容不代表每个模型都支持视觉。平台另有推荐返利，规则以当前活动为准。想验证效果，可以注册59API，用几张脱敏截图完成第一轮小规模测试，再决定生产配置。

Pricing · Docs