# Tensor 刷新后图片仍旧：检查已有刷新记录与元数据时间

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/tensor-existing-metadata-refresh-status
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

围绕已有refresh_metadata记录检查mint身份、响应空值、抓取时间与媒体URI，区分请求响应和实际数据变化，并保留一小时冷却及模型弃用边界。

## 使用工具
- [Tensor](https://lianxiaozhi.com/tools/tensor) · [官方入口](https://www.tensor.trade/)

## 前置条件
- 已有脱敏POST刷新记录与刷新前后元数据；没有时使用官方schema建立记录表，不能宣称已刷新。
- Solana目标mint及采集时间；API key、账户认证信息从记录中删除。
- 此流程复核已有记录，不要求发刷新请求或连接钱包；范围为Refresh API1.0.0 Alpha参考。

## 1. 确认刷新的是哪一个mint

核对原请求是POST https://api.mainnet.tensordev.io/api/v1/trigger/refresh_metadata，mint位于query并为必填字符串。不要只保存展示名称、collId或图片URL。

将响应onchainId与原mint配对，并另记collId和slug；缺onchainId时保留身份未核实。文档对mint写string而非数组，不因为描述使用addresses复数就自行拼出批量传参方式。

核对结果：请求mint与已有响应身份能对应；同图或同名没有替代身份检查。
依据：[Tensor Refresh Mint Metadata OpenAPI](https://dev.tensor.trade/reference/refreshmetadata-1.md)
依据：[Tensor Foundation 协议与 Solana 范围](https://docs.tensor.foundation/)

## 2. 分开权限、冷却与原错误

检查已有记录是否标注x-tensor-api-key认证方式，只记录头名和访问状态，不复制值。官方正文给出1小时cooldown，保留最近请求的原时间用于排查频繁重试。

文档没有说明冷却从何时开始、是否逐mint/key计算或专属错误码，所以不能仅凭两次请求相隔不到一小时就归因确定。400查看原message，422先查mint/格式等参数；未成功鉴权时不能推刷新费用或资产状态。

核对结果：错误记录包含HTTP状态、原message和请求时间；冷却仅为已知规则，具体失败原因按实际记录核对。
依据：[Tensor REST API Alpha 与访问资格](https://dev.tensor.trade/reference/quickstart.md)
依据：[Tensor Refresh Mint Metadata OpenAPI](https://dev.tensor.trade/reference/refreshmetadata-1.md)

## 3. 检查200是否真的带有对象

该方法200整体schema允许null；MintWithColl模型还标deprecated。先判断响应是对象、null还是缺失，不能把200/null改写成“刷新成功且落库”。

对象里的metadataUri、metadataFetchedAt、files、attributes、lastSale等也可null，且未全部列为required。将缺字段与显式null分列。参考没有独立taskId/status队列回执，不能编造任务查询或等待分钟数。

核对结果：保留原响应形状；200空结果、字段未知与取得对象三种状态清楚区分。
依据：[Tensor Refresh Mint Metadata OpenAPI](https://dev.tensor.trade/reference/refreshmetadata-1.md)

## 4. 比较抓取时间与媒体路径

将前后metadataFetchedAt原始date-time字符串和采集时间放在同一表，按带时区值统一显示；没有时区或为null时不猜UTC/毫秒。metadataFetchedAt是元数据抓取字段，不等于区块最终性、市场成交或图片代理缓存失效。

分别比较metadataUri、imageUri、animationUri、files里的uri/type及attributes的trait_type/value。URI相同但内容是否改变、代理是否缓存，需要对应内容证据；只有响应对象时不要宣布源站或IPFS内容已经更新。

核对结果：能标出哪个字段变了、哪个时间更新或仍未知；图片旧与元数据旧没有被混为同一问题。
依据：[Tensor Refresh Mint Metadata OpenAPI](https://dev.tensor.trade/reference/refreshmetadata-1.md)

## 5. 隔离成交字段并写出可证结果

lastSale可能null；其price允许字符串或number，priceUnit枚举有SOL_LAMPORT/ETH_WEI，txAt为日期/字符串。保存金额原值与单位，不把该枚举推成Tensor所有EVM网络支持，也不把price作图片刷新进度。

结论按记录分别写“取得同mint对象但抓取时间未变”“字段有变化”“响应为空/版本不兼容待核”。没有前值或实际媒体内容时只说明已观察字段，不能宣称完整刷新完成。

核对结果：结论绑定mint、原响应、前后采集时间和字段变化，未知项有明确补证条件。
依据：[Tensor Refresh Mint Metadata OpenAPI](https://dev.tensor.trade/reference/refreshmetadata-1.md)
依据：[Tensor Foundation 协议与 Solana 范围](https://docs.tensor.foundation/)

## 常见错误
- 收到200或字段lastSale就认为刷新完成；该接口允许整个结果null。
- 在一小时冷却内无依据重复触发；没有文档支持的冷却计时细则或完成SLA。
- 把metadataFetchedAt的date-time按Unix毫秒解释，或把priceUnit枚举用作全网络矩阵。
- 参考模型deprecated与Alpha变更需按已有记录版本核对，不用旧schema强制修复当前服务数据。

## 完成检查
- 有同一mint的请求/响应、采集时间与元数据字段对照，或明确缺少哪些记录。
- 区分HTTP返回、对象字段变化、元数据抓取与媒体实际内容变化；没有执行刷新的证明不标成实测。

## 相关知识
- [如何核对 Meme 币？先确认链、合约地址和交易池](https://lianxiaozhi.com/learn/meme-token-identity)
- [把数据上链，与只保存数据哈希有什么区别？](https://lianxiaozhi.com/learn/data-onchain-vs-offchain)
- [链上指标历史数值为什么会变？](https://lianxiaozhi.com/learn/point-in-time-metrics)

## 官方依据
- [Tensor REST API Alpha 与访问资格](https://dev.tensor.trade/reference/quickstart.md)
- [Tensor Refresh Mint Metadata OpenAPI](https://dev.tensor.trade/reference/refreshmetadata-1.md)
- [Tensor Foundation 协议与 Solana 范围](https://docs.tensor.foundation/)