# 単一トークンのアップロード

プロジェクトを作成した後、トークンをプロジェクトに追加したい場合は、プロジェクトにファイルをアップロードします。このトピックでは、NMKR Studioユーザーインターフェイスで単一のトークンをアップロードする方法を説明します。より多くのトークンを一括でアップロードしたい場合は、[SFTP経由の一括アップロード](https://docs.nmkr.io/nmkr-studio/token/upload/bulk-upload-via-sftp)を使用してください。

<figure><img src="https://content.gitbook.com/content/ZsvBdOVXa49gx1luHNu8/blobs/0S0IBvnZug3oUHeDKtg1/single_upload.gif" alt=""><figcaption></figcaption></figure>

#### プロジェクトにトークンを1つアップロードする

トークンのアップロードを開始するには、新規作成した[プロジェクト](https://docs.nmkr.io/nmkr-studio/project)の[「NFTを管理」タブ](https://docs.nmkr.io/nmkr-studio/token/manage-tokens-tab)を開き、「NFTをアップロード＆ピン」をクリックしてください。

<figure><img src="https://content.gitbook.com/content/ZsvBdOVXa49gx1luHNu8/blobs/CMd0cCJ82Icxiidu6THM/Screenshot%202022-11-08%20at%2012.15.05.png" alt=""><figcaption><p>トークンをプロジェクトにアップロードします</p></figcaption></figure>

次のウィンドウは、3つのメインタブ（説明、ファイル、メタデータの上書き）と、[メタデータテンプレートでカスタムフィールドを指定](https://docs.nmkr.io/nmkr-studio/project/metadata-template#custom-placeholders)した場合にのみ表示される1つのオプションタブ（プレースホルダデータ）に分かれています。

<figure><img src="https://content.gitbook.com/content/ZsvBdOVXa49gx1luHNu8/blobs/nyXyTpXttivflqEoVgdC/Screenshot%202022-11-01%20at%2012.03.07.png" alt=""><figcaption></figcaption></figure>

#### 説明タブ

説明タブでは、トークン名、表示名(オプション)、説明(オプション)など、トークンに関する基本情報を変更します。

トークン名はメタデータの[資産名](https://docs.nmkr.io/nmkr-studio/project/metadata-template#asset_name)と関連しており、常に一致する必要があります。したがって、[メタデータの上書き](https://docs.nmkr.io/nmkr-studio/token/upload/upload-single-tokens#metadata-override-tab)を使用する場合は、常に[\<asset\_name> プレースホルダ](https://docs.nmkr.io/nmkr-studio/project/metadata-template#asset_name)を使用することをお勧めします。\<asset\_name> プレースホルダには特殊文字は使用できず、スペースも使用できません。

{% hint style="warning" %}
トークンのレアリティの番号は、トークン番号と関連しないようにすることをお勧めします。

そうする必要がある場合、資産名/トークン名を表示名と関連付けず、ランダムに生成することをお勧めします。

その理由は簡単です。プロジェクトで[マルチシグ決済](https://docs.nmkr.io/nmkr-studio/set-up-sales/nmkr-pay/multisig-payment)を使用する場合、購入者は決済トランザクションに署名するときに、トランザクション内の[資産名](https://docs.nmkr.io/nmkr-studio/project/metadata-template#asset_name)（[表示名](https://docs.nmkr.io/nmkr-studio/project/metadata-template#display_name)ではありません）を見ることができます。そのため、購入者は「非レア番号」が表示された場合、取引をキャンセルして最初からやり直すことができます。
{% endhint %}

[表示名](https://docs.nmkr.io/nmkr-studio/project/metadata-template#display_name)は、特殊文字や63文字までの長い名前（例：Landplot #1011）を追加したい場所です。この[表示名](https://docs.nmkr.io/nmkr-studio/project/metadata-template#display_name)が指定された場合、pool.pmのようなエクスプローラではトークン名に置き換えられます。表示名はメタデータテンプレートの [\<display\_name> プレースホルダ](https://docs.nmkr.io/nmkr-studio/project/metadata-template#display_name)に置き換えます。

説明はメタデータテンプレートの \<description> プレースホルダに置き換えます。プロジェクト内のすべてのトークンに同じ説明をつけたい場合は、[メタデータテンプレートの \<description> プレースホルダ](https://docs.nmkr.io/nmkr-studio/project/metadata-template#description)をハード値で置き換えるのが理にかなっています。

<figure><img src="https://content.gitbook.com/content/ZsvBdOVXa49gx1luHNu8/blobs/hBmaztTQSX55T9rKrREr/Screenshot%202022-11-01%20at%2012.04.05.png" alt=""><figcaption><p>トークンの説明タブ</p></figcaption></figure>

#### ファイルタブ

トークンのファイルタブでは、[ファイルの形式](https://docs.nmkr.io/nmkr-studio/token/upload#file-formats)を問わず、トークンにファイルを追加することができます。

しかし、[メインファイル](https://docs.nmkr.io/nmkr-studio/token/upload/upload-single-tokens#upload-main-file)は常に画像またはアニメーションGIFでなければならず、異なる種類のファイルは[サブファイルとしてアップロード](https://docs.nmkr.io/nmkr-studio/token/upload/upload-single-tokens#upload-subfiles)しなければならないことに留意してください。

IPFSハッシュを直接送信し、URL経由でファイルをアップロードする機能は、NMKR Studioの現在のバージョンではサポートされていません（近日公開予定）。

すでにアップロードされピン留めされたファイルの外部IPFSハッシュを使用したい場合は、[メタデータの上書き](https://docs.nmkr.io/nmkr-studio/token/upload/upload-single-tokens#metadata-override-tab)または[SFTP経由でアップロードするメタデータ](https://docs.nmkr.io/nmkr-studio/token/upload/bulk-upload-via-sftp#bulk-upload-metadata-json)に直接追加してください。<br>

**メインファイルをアップロードする**

メインファイルをアップロードするには、「アップロード & ピン」 ボタンをクリックしてください。ファイルエクスプローラーが開きますので、必要なファイルを選択してください。ファイル形式は自動的に選択されます。

{% hint style="warning" %}
このファイルはウォレット、エクスプローラー、セカンダリーマーカットのサムネイルとして使用されます。

このファイルはウォレット、エクスプローラー、セカンダリーのメルカートでサムネイルとして使用されるため、ここにダウンスケール版をアップロードし、サブファイルとしてフルスケール版をアップロードすると、上記のプラットフォームでの読み込み時間が短縮されます。
{% endhint %}

<figure><img src="https://content.gitbook.com/content/ZsvBdOVXa49gx1luHNu8/blobs/XNYFBZixcL12AdFrIneV/Screenshot%202022-11-08%20at%2012.27.00.png" alt=""><figcaption><p>メインファイルをアップロードしてピン留めする</p></figcaption></figure>

**サブファイルをアップロードする**

[サブファイル](https://docs.nmkr.io/nmkr-studio/token/upload#subfiles)には、ビデオ、オーディオ、テキスト、アプリケーションファイルなど、あらゆる種類の[ファイル形式](https://docs.nmkr.io/nmkr-studio/token/upload#file-formats)を指定できます。

「サブファイルを追加」ボタンをクリックすると、[メインファイルをアップロードする](https://docs.nmkr.io/nmkr-studio/token/upload/upload-single-tokens#upload-main-file)最初のステップと同じように、別のファイルを 「アップロード＆ピン」するフィールドが追加されます。ファイルの種類によっては、トークンの右側にプレビューとして表示されない場合がありますが、これはエラーではありませんのでご了承ください。

<figure><img src="https://content.gitbook.com/content/ZsvBdOVXa49gx1luHNu8/blobs/s2XLTs8kxQuRp8vaaTjD/Screenshot%202023-02-26%20at%2013.02.23.png" alt=""><figcaption></figcaption></figure>

ここにファイル名（最大32文字、スペースや特殊文字は不可）と詳細データ（63文字）を指定し、サブファイルの詳細を追加することができます（オプション）。

詳細データは、[メタデータテンプレートでこのフィールドを指定した場合](https://docs.nmkr.io/nmkr-studio/project/metadata-template#detail-data)のみ表示されます。

複数のサブファイルを追加したい場合は、最後のステップを繰り返してください。

#### メタデータの上書きタブ

メタデータタブでは、[メタデータテンプレート](https://docs.nmkr.io/nmkr-studio/project/metadata-template)を使用しない[トークン固有のメタデータを設定する](https://docs.nmkr.io/nmkr-studio/token/metadata/add-token-specific-metadata)ことができます。

{% hint style="info" %}
ここで追加するメタデータは完全であることが重要です。

\<asset\_name>、\<display\_name>、\<policy\_id>、\<ipfs\_link>、\<mime\_type>のプレースホルダを使用して、正しい値を設定することをお勧めします。

しかし、上記のプレースホルダの値をすでに含むメタデータを追加したい場合は、メタデータの上書きタブにプレースホルダを配置します。

NMKR Studioのトークン名と異なる資産名を指定すると、ミント時にエラーが発生します。

また、値だけでなく、必ず文字列（" "）を使用してください。

例："traitcount":  "12 "は正しいです。

"traitcount: 12 は正しくありません。
{% endhint %}

メタデータの上書きで "721 "の完全なメタデータを追加し、「変更を保存する」をクリックしてください。

その後、[メタデータチェック](https://docs.nmkr.io/nmkr-studio/token/metadata/metadata-check)を使用して、最終的な問題を特定することをお勧めします。

<figure><img src="https://content.gitbook.com/content/ZsvBdOVXa49gx1luHNu8/blobs/EwyaCRv7CZTCviyjJB2g/Screenshot%202022-11-02%20at%2023.50.10.png" alt=""><figcaption><p>メタデータの上書き</p></figcaption></figure>

**IPFSハッシュ経由で外部からアップロードされたファイルを追加する**

IPFSにアップロードされたファイルをトークンに追加することができます。これを行うには、以下の例のように、IPFSハッシュをトークンのメタデータに直接入力してください。正しいファイル形式を取得するために、[\<mime\_type>プレースホルダ](https://docs.nmkr.io/nmkr-studio/project/metadata-template#mediatype)を追加することを忘れないでください。

```
            "mediaType": "<mime_type>",
            "src": "ipfs://QmZNqgUHhGukXD27pAZtZE5BEkx6VXB1AhQVmK55QCd31y"
```

**プレースホルダ データ タブ**<br>

プレースホルダ タブは、[メタデータテンプレートにカスタムフィールド](https://docs.nmkr.io/nmkr-studio/project/metadata-template#custom-placeholders)を追加した場合にのみ表示されます。

プロジェクトにアップロードされた各トークンのプレースホルダ データ タブのユーザーインターフェイスで、トークン固有の値を指定できるようになりました。

<figure><img src="https://content.gitbook.com/content/ZsvBdOVXa49gx1luHNu8/blobs/9ZYSy6BoEGnZJOGxJv7f/Screenshot%202022-11-06%20at%2021.30.46.png" alt=""><figcaption><p>トークンの編集セクションのプレースホルダ データ タブ</p></figcaption></figure>

これは明らかに、より多くのトークンにメタデータ値を追加するのに適した方法ではないため、トークンにメタデータを一括追加するには、他の[一括アップロード方法](https://docs.nmkr.io/nmkr-studio/token/upload/bulk-upload-via-sftp#bulk-upload-metadata-json)を使用してください。コーディングの経験があまりない人にとって最も簡単なのは、[placeholder.csv方法](https://docs.nmkr.io/nmkr-studio/token/upload/bulk-upload-via-sftp#bulk-upload-metadata-with-placeholder.csv)です。