metabot-upload-largefile

Upload local files to the MetaID chain and return a pinId and preview URL.

10|2|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/metaid-developers/IDBots --skill metabot-upload-largefile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: metabot-upload-largefile
Source: https://github.com/metaid-developers/IDBots/tree/main/SKILLs/metabot-upload-largefile
Command: npx skills add https://github.com/metaid-developers/IDBots --skill metabot-upload-largefile

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

将本地文件快速、可控地上传到 MetaID 链上,并返回 PINID 与可预览的地址,解决离线准备文件并在链上存证的需求。

Core Features & Use Cases

  • 支持 <=2 MiB 直接上传,上链;>2 MiB 自动走分片上传,硬上限 20 MiB。
  • 成功后返回 pinId 与 预览地址,预览地址格式固定为 https://file.metaid.io/metafile-indexer/api/v1/files/content/<pinId>
  • 支持通过指定 MIME 类型和网络参数来控制上传行为,兼容不同文件类型和目标网络。

Quick Start

将本地文件上传到链上并获取 PINID 与预览地址。

Frequently Asked Questions about metabot-upload-largefile

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload a local file to the MetaID chain and get a preview URL?

To upload a local file to the MetaID chain, specify the local file path and optional network parameters to forward the request to the upload script. The process returns a pinId and a fixed preview URL formatted as https://file.metaid.io/metafile-indexer/api/v1/files/content/<pinId>.

What is the maximum file size limit for on-chain uploads to MetaID?

The maximum file size limit for on-chain uploads to MetaID is a hard limit of 20 MiB. Files larger than 2 MiB are automatically processed via chunked uploads, while files 2 MiB or smaller are uploaded directly.

Does the MetaID upload process support specifying content types for different files?

Yes, the MetaID upload process supports specifying optional content-type parameters to control upload behavior. This ensures compatibility across different file types when uploading local files to the chain and retrieving the pinId.

When do I need to use chunked uploads for on-chain file storage?

You need to use chunked uploads for on-chain file storage when your local file exceeds 2 MiB in size. The upload mechanism automatically handles this chunked process for larger files up to the 20 MiB hard limit.

Why does my local file upload to MetaID fail before reaching the 20 MiB limit?

A local file upload to MetaID may fail before reaching the 20 MiB limit if the local file path is invalid. The upload mechanism validates the local file path before forwarding the request to the upload script.