IPFS Ninja

Faça upload facilmente de imagens, PDFs e arquivos JSON para o IPFS e obtenha um identificador de conteúdo permanente (CID) com acesso instantâneo via gateway.

O que é IPFS?

O Sistema de Arquivos Interplanetário (IPFS) é um protocolo de armazenamento descentralizado ponto a ponto. O IPFS divide os arquivos em pedaços menores, distribui-os pela rede e atribui a cada arquivo um identificador de conteúdo (CID) único baseado em seu conteúdo.

Isso significa:

• Armazenamento distribuído — seus arquivos são armazenados em múltiplos nós para maior confiabilidade.
• Endereçamento por conteúdo — o CID é derivado do próprio conteúdo do arquivo, garantindo imutabilidade.
• Acessibilidade em toda a rede — qualquer pessoa com o CID pode recuperar o arquivo de qualquer no IPFS.

O que o IPFS Ninja faz

IPFS Ninja é um serviço gerenciado que permite fazer upload de arquivos e fixar conteúdo existente no IPFS através de uma API REST simples. Não é necessnecessário executar seu próprio no IPFS.

• Upload de novos arquivos — envie qualquer arquivo via POST /upload/new e obtenha um CID permanente
• Fixar CIDs existentes — já tem conteúdo no IPFS? Fixe-o ao nosso cluster via POST /pin para garantir que permaneca disponível
• Acesso via gateway — todo conteúdo fixado é acessacessível em ipfs.ninja/ipfs/<CID>
• Metadados personalizados — anexe pares chave-valor a uploads e fixações para organização e filtragem
• Tokens de upload assinados — gere tokens com tempo limitado para uploads do lado do cliente sem expor sua chave API
• Nomes mutaveis IPNS — crie nomes estaveis que apontam para CIDs diferentes ao longo do tempo via API IPNS, com até 10 nomes por conta
• Otimização de imagens — redimensione, converta e comprima imagens em tempo real via parâmetros de URL do gateway

Painel de Controle

Acompanhe uploads, armazenamento e largura de banda do gateway no seu painel de controle pessoal.

Acesso ao gateway

Cada arquivo enviado é acessacessível através do gateway IPFS Ninja, que atua como ponte entre a rede descentralizada IPFS e os navegadores web tradicionais.

A URL do gateway segue este padrão:

https://ipfs.ninja/ipfs/<CID>

TIP

Seus arquivos também são acessíveis a partir de qualquer gateway IPFS público (ex.: dweb.link, w3s.link) usando o mesmo CID — a rede IPFS e descentralizada.

Usuarios do plano Nirvana recebem um gateway dedicado em seu próprio subdominio (<slug>.gw.ipfs.ninja) que serve apenas arquivos fixados em sua conta — com controle de acesso opcional baseado em tokens e restrições de origem.

Tipos de arquivo suportados

Tipo	Formatos	Entrada
JSON	Qualquer objeto ou array JSON válido	string / object
Imagens	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDFs	Documentos PDF padrão	base64
HTML	Documentos HTML	base64
Qualquer	Qualquer arquivo (binario, texto, video, etc.)	base64

Todos os tipos de arquivo são aceitos. O tipo é detectdetectado automaticamente é registrregistrado para sua referência.

Segurança

As respostas do gateway incluem cabeçalhos de segurança (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) que impedem os navegadores de executar scripts no conteúdo servido.

Limites de tamanho

Limite	Valor
Payload máximo por requisição	6 MB (limite do API Gateway)
Armazenamento total (Dharma)	1 GB
Armazenamento total (Bodhi)	10 GB
Armazenamento total (Nirvana)	100 GB

Casos de uso

Metadados e ativos NFT

Armazene metadados JSON de NFT e imagens associadas com CIDs permanentes e imutáveis.

Hospedagem de recursos estáticos

Hospede imagens, documentos e arquivos de dados para aplicações web e móveis.

Compartilhamento verificavel de dados

Compartilhe dados com proveniência endereçada por conteúdo — os destinatarios podem verificar que nada foi alterado.