# NFT'nizi IPFS üzerinde barındırma

Eğer bunu henüz bilmiyorsanız, bir NFT’ye sahip olmak, NFT’nin dosyasının olduğu gibi blok zincirine yüklendiği anlamına gelmez.\
Bunun yerine, bir NFT, belirli bir token içeren bir blok zinciri bloğuna karşılık gelir. Bu token, adı verilen bir "işaretçi" veya bağlantı saklar `tokenURI`, bu da bir metadata dosyasına çevrimiçi adresi içerir; bu dosya da medya dosyasına başka bir URI kullanarak atıfta bulunur.

Blok zincirinin eşler arası yapısı nedeniyle, NFT dosyanızı ve metadata dosyanızı herhangi bir web barındırma hizmetinde sadece barındıramazsınız. Sizin `tokenURI` varlığınızın kalıcı (veya "değiştirilemez") ve uygulamalar ile pazar yerleri arasında taşınabilir kalması gerekir; mümkün olduğunca uzun süre, hatta belki sonsuza dek.

IPFS burada sahneye çıkıyor.

## **IPFS hakkında**

[IPFS](https://ipfs.tech/), InterPlanetary File System’in kısaltmasıdır; dağıtık ağlar arasında veri barındırma ve paylaşma amacına hizmet eden merkeziyetsiz bir dosya ağıdır. NFT platformları, tek bir sunucuya güvenmek yerine verileri IPFS’ten çekebilir ve IPFS protokolü, barındırılan tüm dosyaların yerelmiş gibi "hissettirilmesini" sağlar.

{% hint style="success" %}
**Şu anda IPFS hakkında öğrenmem gerekiyor mu?**

Bu, NFT’nizi basmak için seçtiğiniz yönteme bağlıdır:

* Saf kod kullanarak (örneğin [viem](https://viem.sh/) veya [ethers](https://ethers.org/)):\
  **Evet**, geçerli bir `tokenURI` (örneğin, `ipfs://.../metadata.json`) önceden gerekiyor.
* Gibi bir панель üzerinden [thirdweb](https://thirdweb.com/):\
  **Hayır**. IPFS’ye yükleme yerleşik olarak gelir. Hâlâ mevcut bir `ipfs://...` eğer NFT parametrelerinde bir tane varsa yapıştırabilirsiniz.
* Çoğu Web3 SDK’sını kullanarak (örneğin [Rarible’ın Multichain SDK’sı](https://docs.rarible.org/reference/getting-started)):\
  **Evet**, onlar bir URI bekler. Bazı araçlar yüklemelerde yardımcı olabilir, ancak çoğu değil.
  {% endhint %}

IPFS web sitesinde [NFT Saklama en iyi uygulamaları üzerine kapsamlı bir sayfa](https://docs.ipfs.tech/how-to/best-practices-for-nft-data/#types-of-ipfs-links-and-when-to-use-them).

## NFT yükleme ayrıntıları

NFT’nizi yüklerken, IPFS’nin sizin için oluşturduğu İçerik Tanımlayıcısına (CID) iki yükleme yapmanız gerekir:

* İçeriğin kendisi; bunun için IPFS, barındırılan dosya için bir IPFS URL’si döndürür.
* Medya dosyasının CID’sine atıfta bulunan ve dosya için IPFS URL’sini içermesi gereken metadata dosyası.

İkisi de aynı CID altında IPFS’ye yüklenmelidir.

İdeal olarak, bunu araç setiniz sizin yerinize üstlenir; böylece her şeyi manuel olarak yapmak zorunda kalmazsınız.

Bilgilendirme amacıyla, minimum bir `metadata.json` dosyasının nasıl görüneceği aşağıdadır:

```json
{ 
    "name": "Stadium Pass #25456456", 
    "description": "PSG destekçi giriş bileti", 
    "image": "ipfs:///filename.png",           // yalnızca statik görseller için!
    // "animation_url": "ipfs:///filename.mp4" // video ve ses dosyaları için.
    "attributes": [
    { 
        "trait_type": "Tier", 
        "value": "Altın" 
    }] 
}
```

NFT metadata yapısı hakkında daha fazla bilgi edinmek için (örneğin, neden `image` görseller için ve `animation_url` videolar için kullanmanız gerektiği), OpenSea’nin bu belgesini okumanızı öneririz:

{% embed url="<https://docs.opensea.io/docs/metadata-standards#metadata-structure>" %}

Not: *Metadata dosyasını sıfırdan yazmanız beklenmez!*\
Araç setiniz bunu sizin için oluşturabilmelidir.

{% hint style="success" %}
Ya [kendi IPFS düğümünüzü çalıştırabilir](https://docs.ipfs.tech/how-to/command-line-quick-start/), ya da [Pinata](https://pinata.cloud/)gibi bir IPFS barındırma hizmeti için ödeme yapabilirsiniz; bu hizmet, ihtiyaçlarınız için yeterli olabilecek ücretsiz bir fiyatlandırma planı sunar.

Şunu takip edin [Pinata’nın hızlı başlangıç kılavuzu](https://docs.pinata.cloud/quickstart) API kimlik bilgilerinizi (bir API anahtarı, bir API gizli anahtarı ve bir JWT token’dan oluşur) ve Özel Gateway alan adınızı (örneğin, `blue-genetic-quail-122.mypinata.cloud`).
{% endhint %}

Bu dokümantasyon IPFS hakkında her şeyi anlatmak için hazırlanmadığından, konuyu çevrimiçi aramalarla derinlemesine incelemenizi öneririz. Şuradaki Pinata açıklayıcısıyla başlayabilirsiniz:

{% embed url="<https://docs.pinata.cloud/ipfs-101/how-does-ipfs-work-with-nfts>" %}

... ya da thirdweb’ten şu blog yazısıyla:

{% embed url="<https://blog.thirdweb.com/guides/securing-pinning-your-nft-with-ipfs/>" %}


---

# Agent Instructions: 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:

```
GET https://docs.chiliz.com/tr-ai/develop/advanced/work-with-nfts/hosting-your-nft-on-ipfs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.