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

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

<figure><img src="/files/upxfZxZQORMS4lk21TQX" 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="/files/EV1w6YaRfUanvxnV6PGr" alt=""><figcaption><p>トークンをプロジェクトにアップロードします</p></figcaption></figure>

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

<figure><img src="/files/R3k9vCS5RsaboUys3wlJ" 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="/files/WpLLt5sbpuzOnB0nS2UQ" 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="/files/HvGl3WtN5ZyGpmgwFp04" 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="/files/qn6JSPORp0L2TL8lg8nm" 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="/files/8qOE1HPRBByVBkn2xX6R" 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="/files/trqRo7omeXq5wAF0kP7R" 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)です。


---

# 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.nmkr.io/jp/nmkr-studio/tkun/appurdo/tkunnoappurdo.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.
