> For the complete documentation index, see [llms.txt](https://docs.chiliz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chiliz.com/tr/gelistir/gelismis/nft-ile-calisma/nft-ipfs-barindirma.md). # NFT'yi IPFS'te Barındırma Henüz bilmiyorsanız, bir NFT'ye sahip olmak NFT'nin dosyasının olduğu gibi blockchain'e yüklendiği anlamına gelmez.\ Aksine, bir NFT belirli bir token'ı içeren bir blockchain bloğuna karşılık gelir. Bu token, `tokenURI` adı verilen ve meta veri dosyasının çevrimiçi adresini içeren bir "işaretçi" veya bağlantı depolar; meta veri dosyası da başka bir URI kullanarak medya dosyasına referans verir. Blockchain'in eşler arası yapısı nedeniyle NFT dosyanızı ve meta veri dosyasını herhangi bir web barındırma hizmetinde barındıramazsınız. `tokenURI`'niz, uygulamalar ve pazaryerleri arasında mümkün olduğunca uzun süre boyunca, belki sonsuza dek kalıcı (veya "değiştirilemez") ve taşınabilir olmalıdır. İşte tam burada IPFS devreye giriyor. ## **IPFS Hakkında** [IPFS](https://ipfs.tech/), InterPlanetary File System (Gezegenlerarası Dosya Sistemi) anlamına gelir; dağıtılmış ağlarda veri barındırma ve paylaşma amacıyla hizmet veren merkeziyetsiz bir dosya ağıdır. NFT platformları, tek bir sunucuya güvenmek yerine IPFS'ten veri çekebilir; IPFS protokolü tüm barındırılan dosyaları sanki yerel dosyalarmış gibi hissettirme özelliğine sahiptir. {% hint style="success" %} **Şu an IPFS hakkında bilgi edinmem gerekiyor mu?** Bu, NFT'nizi basmak için seçtiğiniz yönteme bağlıdır: * Vanilla kod kullanımı ([viem](https://viem.sh/) veya [ethers](https://ethers.org/) gibi):\ **Evet**, önceden geçerli bir `tokenURI`'ye (örneğin `ipfs://.../metadata.json`) ihtiyacınız var. * [thirdweb](https://thirdweb.com/) gibi bir pano aracılığıyla:\ **Hayır**. IPFS'e yükleme yerleşik olarak sunulur. Yine de NFT parametrelerinde mevcut bir `ipfs://...` adresiniz varsa yapıştırabilirsiniz. * Çoğu Web3 SDK kullanımı ([Rarible'ın Multichain SDK'sı](https://docs.rarible.org/reference/getting-started) gibi):\ **Evet**, bir URI beklerler. Bazı araçlar yükleme konusunda yardımcı olabilir, ancak çoğu olmaz. {% endhint %} IPFS web sitesinde [NFT Depolama en iyi uygulamaları hakkında kapsamlı bir sayfa](https://docs.ipfs.tech/how-to/best-practices-for-nft-data/#types-of-ipfs-links-and-when-to-use-them) bulunmaktadır. ## NFT Yükleme Ayrıntıları NFT'nizi yüklerken, IPFS'in sizin için oluşturduğu İçerik Tanımlayıcısına (CID) iki yükleme yapmanız gerekir: * İçeriğin kendisi; IPFS, barındırılan dosya için bir IPFS URL'si döndürür. * Medya dosyasının CID'sine referans veren ve dosya için IPFS URL'sini içermesi gereken meta veri dosyası. Her ikisi de aynı CID altında IPFS'e yüklenmelidir. İdeal olarak araç setiniz bunu üstlenerek her şeyi manuel olarak yapma zorunluluğundan kurtarır. Bilgi amaçlı olarak, minimal bir `metadata.json` dosyasının nasıl görüneceği aşağıda gösterilmiştir: ```json { "name": "Stadium Pass #25456456", "description": "PSG supporter entry ticket", "image": "ipfs:///filename.png", // yalnızca statik görüntüler için! // "animation_url": "ipfs:///filename.mp4" // video ve ses dosyaları için. "attributes": [ { "trait_type": "Tier", "value": "Gold" }] } ``` NFT meta veri yapısı hakkında daha fazla bilgi edinmek için (örneğin görüntüler için neden `image`, videolar için `animation_url` kullanmanız gerektiği), OpenSea'nın şu belgesini okumanızı öneririz: {% embed url="" %} Not: *Meta veri dosyasını sıfırdan yazmanız gerekmiyor!*\ Araç setiniz bunu sizin için oluşturabilmelidir. {% hint style="success" %} [Kendi IPFS node'unuzu çalıştırabilir](https://docs.ipfs.tech/how-to/command-line-quick-start/) veya ihtiyaçlarınız için yeterli olabilecek ücretsiz bir fiyatlandırma planı sunan [Pinata](https://pinata.cloud/) gibi bir IPFS barındırma hizmetine ödeme yapabilirsiniz. API kimlik bilgilerinizi (API anahtarı, API gizli anahtarı ve JWT token'dan oluşan) ve Özel Ağ Geçidi etki alanınızı (örneğin, `blue-genetic-quail-122.mypinata.cloud`) edinmek için [Pinata'nın hızlı başlangıç kılavuzunu](https://docs.pinata.cloud/quickstart) izleyin. {% endhint %} Bu belgeler IPFS hakkında her şeyi anlatmayı amaçlamadığından, konuya çevrimiçi aramalar aracılığıyla daha derin dalmanızı öneririz. Şu Pinata açıklamasıyla başlayabilirsiniz: {% embed url="" %} ... veya thirdweb'den şu blog yazısıyla: {% embed url="" %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.chiliz.com/tr/gelistir/gelismis/nft-ile-calisma/nft-ipfs-barindirma.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.