如何通过IPFS或Pinata API实现同CID多文件上传适配10k NFT铸造需求

你的需求本质是把所有NFT元数据作为独立文件放在同一个IPFS目录下，用目录的CID作为共享根路径，文件直接用代币编号命名即可实现指定的访问格式，具体两种实现方式如下：

一、IPFS原生接口实现 #

固定根CID方案（推荐） #

该方案生成的根CID永久不变，无需后续调整，适合NFT项目使用：

• 本地新建专门存放元数据的目录，例如命名为nft_metadata
• 提前生成全部10000份元数据JSON文件，存入上述目录，每个文件直接用对应代币编号命名，不要加.json后缀，例如1号代币的元数据文件名为1，内容为完整的JSON结构
• 执行IPFS命令行上传整个目录，添加--wrap-with-directory参数确保生成目录类型的根CID：

  ipfs add -r --wrap-with-directory ./nft_metadata
  

• 命令输出的最后一条hash即为根目录的共享CID，后续直接通过ipfs://<CID>/<代币编号>即可访问对应元数据

动态更新方案 #

如果需要在铸造过程中逐份新增元数据，可以使用IPFS的MFS可变文件系统实现：

• 先在MFS中创建固定根目录：

  ipfs files mkdir /nft_metadata
  

• 每次铸造新代币时，将对应编号的元数据写入MFS目录：

  echo '<元数据JSON内容>' | ipfs files write --create /nft_metadata/<代币编号>
  

• 每次新增文件后获取最新根CID：

  ipfs files stat /nft_metadata
  

注意：该方案下每次新增文件后根CID都会发生变化，如果你需要固定不变的根路径，需要额外搭配IPNS做CID映射，或者直接用固定根CID方案提前全量上传

二、Pinata API实现 #

固定根CID方案 #

• 本地提前生成全部10000份按数字命名的元数据文件，放入同一个目录
• 调用Pinata的文件夹上传接口，将整个目录上传至Pinata固定
• 接口返回的IpfsHash即为根目录共享CID，直接符合ipfs://<CID>/<代币编号>的访问格式

动态更新方案 #

如果需要逐次新增元数据且保留固定根CID，可以使用Pinata的目录更新功能：

• 首次上传空目录到Pinata拿到初始根CID
• 每次铸造新代币时，调用Pinata的目录文件添加接口，将新的编号命名的元数据文件添加到已有目录下

Pinata的可变目录功能会保留同一个根CID，无需修改NFT合约中的元数据基路径配置，比原生IPFS动态方案更易用，但依赖Pinata的服务支持。

内容的提问来源于stack exchange，提问作者Soragim