Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -826,6 +826,7 @@
{
"group": "Meshy",
"pages": [
"tutorials/partner-nodes/meshy/meshy-t2-5",
"tutorials/partner-nodes/meshy/meshy-7",
"tutorials/partner-nodes/meshy/meshy-6"
]
Expand Down Expand Up @@ -4830,6 +4831,7 @@
{
"group": "Meshy",
"pages": [
"zh/tutorials/partner-nodes/meshy/meshy-t2-5",
"zh/tutorials/partner-nodes/meshy/meshy-7",
"zh/tutorials/partner-nodes/meshy/meshy-6"
]
Expand Down Expand Up @@ -8842,6 +8844,7 @@
{
"group": "Meshy",
"pages": [
"ja/tutorials/partner-nodes/meshy/meshy-t2-5",
"ja/tutorials/partner-nodes/meshy/meshy-7",
"ja/tutorials/partner-nodes/meshy/meshy-6"
]
Expand Down Expand Up @@ -12871,6 +12874,7 @@
{
"group": "Meshy",
"pages": [
"ko/tutorials/partner-nodes/meshy/meshy-t2-5",
"ko/tutorials/partner-nodes/meshy/meshy-7",
"ko/tutorials/partner-nodes/meshy/meshy-6"
]
Expand Down
102 changes: 102 additions & 0 deletions ja/tutorials/partner-nodes/meshy/meshy-t2-5.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
---
title: "ComfyUI の Meshy T2.5:三角形予算内でゲーム対応の3Dを生成"
description: "ComfyUI の Meshy T2.5 で、ゲーム対応の3Dメッシュを生成できます。テキストからモデル、画像からモデルを、設定した三角形予算内で構築し、オプションでPBRテクスチャも利用できます。"
sidebarTitle: "T2.5 スマートトポロジー"
translationSourceHash: 5e36fa84
translationFrom: tutorials/partner-nodes/meshy/meshy-t2-5.mdx
translationBlockHashes:
"_intro": bb9cdd1a
"Available workflows": 32214560
"Node controls": 5a3bc3d3
"Prompting tips": c92fc83c
"Get started": 1e5ab547
---
import ReqHint from "/snippets/ja/tutorials/partner-nodes/req-hint.mdx";
import UpdateReminder from "/snippets/ja/tutorials/update-reminder.mdx";

**Meshy T2.5** は、指定した三角形数で直接3Dメッシュを生成します。従来のパイプラインでは高密度のメッシュを生成してから後でリトポロジを行うため、ディテールが失われ、アセットを出荷する前にクリーンアップが必要でした。T2.5は最初からポリゴン予算を狙うため、15000三角形のプロップはおよそ15000三角形で返ってきて、そのままエンジンに持ち込めます。

ComfyUIでは、これを2つのパートナーノードで利用できます。**Meshy: Text to Model (Smart Topology)** と **Meshy: Image to Model (Smart Topology)** です。どちらもクラウドAPIノードで、クレジット付きのComfyアカウントが必要であり、モデルファイルをローカルにダウンロードしません。それぞれGLBファイルとFBXファイルを返し、テンプレートではSave GLBノードでGLBを書き出します。

T2.5は、三角形数を予測できることが重要なプロップ、環境装飾、ローポリのゲームアセット向けのモードです。リギング、アニメーション、アセット制作の全工程には、代わりに[Meshy 7](/ja/tutorials/partner-nodes/meshy/meshy-7)を使用してください。

<ReqHint/>
<UpdateReminder/>

## 利用可能なワークフロー

### テキストからモデル(スマートトポロジー)

オブジェクトを説明すると、設定したポリゴン数でメッシュが生成されます。入力ファイルは不要です。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_meshy_t2_5_smart_topology_t2m-1.webp" alt="Meshy T2.5: テキストからモデルのワークフロープレビュー" />

<CardGroup cols={2}>
<Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=api_meshy_t2_5_smart_topology_t2m&utm_source=docs&utm_medium=referral&utm_campaign=meshy-t2-5">
Comfy Cloud で開く
</Card>
<Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_meshy_t2_5_smart_topology_t2m.json">
JSON をダウンロードするか、テンプレートライブラリで "Meshy T2.5: Text to Model (Smart Topology)" を検索してください
</Card>
</CardGroup>

**プロンプト例**

- `A weathered wooden treasure chest with iron banding, a rounded lid and a rusted lock plate, standing open with a few gold coins inside, standalone game prop, clean silhouette`
- `Low-poly stone lantern covered in moss, chipped edges, wide base, neutral studio lighting`
- `Sci-fi crate with recessed panel lines and a lit status strip, boxy silhouette, no text`

### 画像からモデル(スマートトポロジー)

1 枚の画像をエンジンでそのまま使えるメッシュに変換します。テクスチャリングは任意で、2k、4k、8k の PBR マップを使って実行できます。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_meshy_t2_5_smart_topology_i2m-1.webp" alt="Meshy T2.5: 画像からモデルのワークフロープレビュー" />

<CardGroup cols={2}>
<Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=api_meshy_t2_5_smart_topology_i2m&utm_source=docs&utm_medium=referral&utm_campaign=meshy-t2-5">
Comfy Cloud で開く
</Card>
<Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_meshy_t2_5_smart_topology_i2m.json">
JSON をダウンロードするか、テンプレートライブラリで "Meshy T2.5: Image to Model (Smart Topology)" を検索してください
</Card>
</CardGroup>

**入力マテリアル**

<Card title="abstract_3d_toy_van_game_asset.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/abstract_3d_toy_van_game_asset.png">
`LoadImage` ノードに読み込む
</Card>

`texture_prompt` と `texture_image` は同時に使用できません。どちらか一方でテクスチャを誘導するか、両方とも空にしてソース画像に任せてください。

## ノードのコントロール

| コントロール | 値 | 適用対象 | 効果 |
| --- | --- | --- | --- |
| `model` | `meshy-t2.5` | 両方のノード | Smart Topology モデルのリリース |
| `prompt` | テキスト、最大800文字 | Text to Model | 構築するオブジェクトの説明 |
| `image` | 1枚の画像 | Image to Model | メッシュの生成元となるソース画像 |
| `target_polycount` | 100〜30000、デフォルト 15000 | 両方のノード | 結果のおおよその三角形数 |
| `pose_mode` | 空、`A-pose`、`T-pose` | 両方のノード | キャラクターの立ち姿勢を固定します。プロップの場合は空のままにします |
| `should_texture` | `true`、`false` | Image to Model | 生成後にメッシュへテクスチャを適用するかどうか |
| `enable_pbr` | デフォルトはオフ | Image to Model、テクスチャ有効時 | ベースカラーにメタリック、ラフネス、ノーマルマップを追加します |
| `texture_prompt` | テキスト、最大800文字 | Image to Model、テクスチャ有効時 | テクスチャのテキストガイダンス。`texture_image` と併用できません |
| `texture_image` | 1枚の画像 | Image to Model、テクスチャ有効時 | テクスチャの画像ガイダンス。`texture_prompt` と併用できません |
| `texture_resolution` | `2k`、`4k`、`8k` | Image to Model、テクスチャ有効時 | 生成されるテクスチャの解像度 |
| `seed` | 整数 | 両方のノード | ノードを再実行するかどうかを制御します。Meshy の出力はシードに関係なく非決定的です |

ノードは `meshy_task_id`、`GLB`、`FBX` を出力します。Save GLB は、タスク ID や FBX 出力ではなく、`GLB` 出力からファイルを書き出します。

## プロンプトのヒント

- **オブジェクトとシルエットを指定する。** `Standalone game prop, clean silhouette, no text` を指定すると、モデルがシーンや台座、文字を勝手に追加するのを防げるため、後から削除する手間が省けます。
- **生成する前にポリゴン数の予算を決める。** 後から `target_polycount` を変更すると再生成になるため、そのアセットが主役級の小道具なのか背景用なのかを先に決めてください。
- **ライティングリグではなくマテリアルを説明する。** `weathered wood, iron banding, rusted lock plate` のような表面を表す言葉はメッシュとテクスチャに反映されます。スタジオライティングの言葉はプレビューの見え方にしか影響しません。
- **`pose_mode` はキャラクターにのみ使う。** A-pose や T-pose はリグに適した姿勢になります。プロップは空のままにしておくのがおすすめです。
- **形状が正しくなってからテクスチャを付ける。** まずテクスチャなしで一度実行してシルエットを確認し、最終パスで `should_texture` をオンにします。
- **同じメッシュが二度得られるとは期待しない。** シードはノードを再実行するかどうかを決めるだけなので、再実行すれば新しい結果になります。

## はじめる

1. ComfyUIを最新バージョンにアップデートする
2. テンプレートライブラリに移動し、`Meshy T2.5` を検索する
102 changes: 102 additions & 0 deletions ko/tutorials/partner-nodes/meshy/meshy-t2-5.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
---
title: "ComfyUI의 Meshy T2.5: 삼각형 예산에 맞춘 게임용 3D"
description: "ComfyUI에서 Meshy T2.5로 게임용 3D 메시를 생성하세요: 설정한 삼각형 예산에 맞춰 텍스트→모델과 이미지→모델을 만들고, 선택적으로 PBR 텍스처를 적용할 수 있습니다."
sidebarTitle: "T2.5 스마트 토폴로지"
translationSourceHash: 5e36fa84
translationFrom: tutorials/partner-nodes/meshy/meshy-t2-5.mdx
translationBlockHashes:
"_intro": bb9cdd1a
"Available workflows": 32214560
"Node controls": 5a3bc3d3
"Prompting tips": c92fc83c
"Get started": 1e5ab547
---
import ReqHint from "/snippets/ko/tutorials/partner-nodes/req-hint.mdx";
import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx";

**Meshy T2.5**는 요청한 삼각형 수에 맞춰 3D 메시를 직접 생성합니다. 이전 파이프라인은 고밀도 메시를 만든 뒤 리토폴로지하는 방식이라 디테일이 손실되고, 에셋을 출시하기 전에 정리 작업이 필요합니다. T2.5는 예산을 처음부터 목표로 삼기 때문에, 15000 삼각형짜리 소품은 대략 15000 삼각형으로 돌아오며 바로 엔진에 넣을 수 있습니다.

ComfyUI는 이를 두 개의 파트너 노드로 제공합니다: **Meshy: Text to Model (Smart Topology)** 와 **Meshy: Image to Model (Smart Topology)**. 둘 다 크레딧이 있는 Comfy 계정이 필요한 클라우드 API 노드이며, 모델 파일을 로컬로 다운로드하지 않습니다. 각각 GLB 파일과 FBX 파일을 반환하고, 템플릿은 Save GLB 노드로 GLB를 저장합니다.

T2.5는 예측 가능한 삼각형 수가 중요한 소품, 환경 장식, 로우폴리 게임 에셋을 위한 모드입니다. 리깅, 애니메이션, 전체 에셋 파이프라인에는 대신 [Meshy 7](/ko/tutorials/partner-nodes/meshy/meshy-7)을 사용하세요.

<ReqHint/>
<UpdateReminder/>

## 사용 가능한 워크플로

### 텍스트 → 모델 (Smart Topology)

객체를 설명하면 설정한 폴리곤 예산에 맞춰 메시가 생성됩니다. 입력 파일이 필요하지 않습니다.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_meshy_t2_5_smart_topology_t2m-1.webp" alt="Meshy T2.5: 텍스트 → 모델 워크플로 미리보기" />

<CardGroup cols={2}>
<Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_meshy_t2_5_smart_topology_t2m&utm_source=docs&utm_medium=referral&utm_campaign=meshy-t2-5">
Comfy Cloud에서 열기
</Card>
<Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_meshy_t2_5_smart_topology_t2m.json">
JSON을 다운로드하거나 템플릿 라이브러리에서 "Meshy T2.5: Text to Model (Smart Topology)"를 검색하세요
</Card>
</CardGroup>

**예시 프롬프트**

- `A weathered wooden treasure chest with iron banding, a rounded lid and a rusted lock plate, standing open with a few gold coins inside, standalone game prop, clean silhouette`
- `Low-poly stone lantern covered in moss, chipped edges, wide base, neutral studio lighting`
- `Sci-fi crate with recessed panel lines and a lit status strip, boxy silhouette, no text`

### 이미지 → 모델 (Smart Topology)

이미지 한 장을 엔진에서 바로 사용할 수 있는 메시로 변환합니다. 텍스처링은 선택 사항이며 2k, 4k, 8k의 PBR 맵으로 실행할 수 있습니다.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_meshy_t2_5_smart_topology_i2m-1.webp" alt="Meshy T2.5: 이미지 → 모델 워크플로 미리보기" />

<CardGroup cols={2}>
<Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_meshy_t2_5_smart_topology_i2m&utm_source=docs&utm_medium=referral&utm_campaign=meshy-t2-5">
Comfy Cloud에서 열기
</Card>
<Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_meshy_t2_5_smart_topology_i2m.json">
JSON을 다운로드하거나 템플릿 라이브러리에서 "Meshy T2.5: Image to Model (Smart Topology)"를 검색하세요
</Card>
</CardGroup>

**입력 소재**

<Card title="abstract_3d_toy_van_game_asset.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/abstract_3d_toy_van_game_asset.png">
`LoadImage` 노드에 로드하세요
</Card>

`texture_prompt`와 `texture_image`는 함께 사용할 수 없습니다. 둘 중 하나로 텍스처를 안내하거나, 둘 다 비워 두고 소스 이미지가 텍스처를 결정하도록 하세요.

## 노드 컨트롤

| 컨트롤 | 값 | 적용 대상 | 효과 |
| --- | --- | --- | --- |
| `model` | `meshy-t2.5` | 두 노드 모두 | Smart Topology 모델 릴리스 |
| `prompt` | 텍스트, 최대 800자 | Text to Model | 빌드할 객체에 대한 설명 |
| `image` | 이미지 1개 | Image to Model | 메시를 생성하는 데 사용하는 소스 이미지 |
| `target_polycount` | 100~30000, 기본값 15000 | 두 노드 모두 | 결과의 대략적인 삼각형 수 |
| `pose_mode` | 비어 있음, `A-pose`, `T-pose` | 두 노드 모두 | 캐릭터 자세를 고정합니다. 소품의 경우 비워 두세요 |
| `should_texture` | `true`, `false` | Image to Model | 생성 후 메시에 텍스처를 적용할지 여부 |
| `enable_pbr` | 기본적으로 꺼짐 | Image to Model, 텍스처링 켜짐 | 기본 색상에 메탈릭, 러프니스, 노멀 맵을 추가합니다 |
| `texture_prompt` | 텍스트, 최대 800자 | Image to Model, 텍스처링 켜짐 | 텍스처에 대한 텍스트 가이드입니다. `texture_image`와 함께 사용할 수 없습니다 |
| `texture_image` | 이미지 1개 | Image to Model, 텍스처링 켜짐 | 텍스처에 대한 이미지 가이드입니다. `texture_prompt`와 함께 사용할 수 없습니다 |
| `texture_resolution` | `2k`, `4k`, `8k` | Image to Model, 텍스처링 켜짐 | 생성된 텍스처의 해상도 |
| `seed` | 정수 | 두 노드 모두 | 노드를 다시 실행할지 여부를 제어합니다. Meshy 출력은 시드와 관계없이 비결정적입니다 |

노드는 `meshy_task_id`, `GLB`, `FBX`를 출력합니다. Save GLB는 작업 ID나 FBX 출력이 아닌 `GLB` 출력에서 파일을 기록합니다.

## 프롬프트 작성 팁

- **오브젝트와 실루엣을 명시하세요.** `Standalone game prop, clean silhouette, no text`를 사용하면 모델이 장면이나 받침대, 나중에 제거해야 할 글자를 덧붙이지 않습니다.
- **생성 이전에 폴리곤 예산을 정하세요.** 이후에 `target_polycount`를 변경하면 새로운 생성이 이루어지므로, 해당 에셋이 핵심 소품인지 배경 장식인지 먼저 결정하세요.
- **조명 장비가 아니라 재질을 설명하세요.** `weathered wood, iron banding, rusted lock plate` 같은 표면 표현은 메시와 텍스처에 그대로 반영됩니다. 스튜디오 조명 용어는 미리보기가 어떻게 보이는지에만 영향을 줍니다.
- **`pose_mode`는 캐릭터에만 사용하세요.** A-pose 또는 T-pose는 리깅에 적합한 자세를 만들어 줍니다. 소품은 비워 두는 편이 좋습니다.
- **형태가 맞은 뒤에 텍스처를 입히세요.** 텍스처 없이 한 번 실행해 실루엣을 확인한 다음, 최종 단계에서 `should_texture`를 켜세요.
- **같은 메시가 두 번 나오리라 기대하지 마세요.** 시드는 노드가 다시 실행되는지만 결정하므로, 재실행은 새로운 결과입니다.

## 시작하기

1. ComfyUI를 최신 버전으로 업데이트합니다
2. Template Library로 이동하여 `Meshy T2.5`를 검색합니다
Loading
Loading