火山引擎OCR需使用永久图片链接，临时链接含/expiry/或时间戳参数、有效期短，易导致识别失败；应通过控制台刷新签名、OpenAPI签发或上传时启用自动转存永久链接解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
火山引擎图片链接有有效期，直接用临时地址调用OCR会导致识别失败或返回空结果，因为接口发起请求时图片URL已过期或不可访问。
确认图片链接是否为临时地址
登录火山引擎 veImageX 控制台 → 进入「资源管理」→ 点击目标图片右侧「详情」→ 查看「访问地址」字段。若地址中含 【/expire/】 或包含时间戳参数（如 t=1734750000），即为临时签名链接，有效期通常为30分钟至2小时，且不可续期。
永久链接不含签名参数，以 https://xxx.volces.com/xxx.jpg 形式存在，可长期用于API调用。
临时链接用于OCR前必须延长时效
方法一：在veImageX控制台手动刷新签名
进入该图片「详情页」→ 点击「重新生成访问链接」→ 勾选「有效期」下拉菜单中「2小时」或「24小时」→ 点击确定。新链接立即生效，旧链接同步失效。
方法二：通过OpenAPI动态签发长期有效URL
调用 /api/v1/image/presign 接口，传入 expires_in=86400（即24小时），获取带新签名的URL。注意：该接口需使用服务端密钥鉴权，【不可在前端JS中硬编码调用】，否则AK/SK泄露风险极高。
生产环境推荐的稳定方案
第一步：上传图片时启用「自动转存为永久链接」功能
在veImageX控制台「上传设置」中开启「上传后自动生成永久CDN地址」，或调用上传接口时设置 permanent=true 参数。
第二步：将返回的永久URL存入业务数据库，后续所有OCR任务均从此字段读取
避免每次识别都重新生成链接，也规避了签名过期、并发重签冲突等问题。
第三步：对存量临时链接做批量迁移
使用 veImageX 提供的「链接升级工具」（路径：控制台 → 工具中心 → 临时链接转永久），粘贴CSV格式的临时URL列表，一键生成对应永久地址并导出映射表。此操作不改变原图存储位置，仅更新访问入口。
