> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI の Tencent Hunyuan Image 3.5 Preview：テキストから画像と画像編集のワークフロー

> ComfyUI で Tencent Hunyuan Image 3.5 Preview を使って画像を生成・編集：多言語テキスト描画、最大 5 枚の参照画像、2K からアップスケールした 4K 出力。

Tencent Hunyuan Image 3.5 Preview（HY Image 3.5 Preview）は、ComfyUI のパートナーノードで利用できる Tencent のプレビュー版画像モデルです。テキストから画像を生成し、指示に従って既存の画像を編集します。多言語のテキスト描画、フォトリアリズム、参照画像と編集結果の一貫性に重点を置いています。

従来の Hunyuan 画像モデルと比べて、HY Image 3.5 Preview は 3 つの領域を強化しています。広告、インフォグラフィック、UI デザイン向けの多言語テキスト描画と組版。シネマティック、コミック、商業写真、イラストにわたるフォトリアリズムとスタイルの幅。そして背景、服装、スタイルを変更しても人物や製品の主要な特徴を保つ編集の一貫性です。

ワークフローは 2 つ用意されています。`Tencent HY Image: Text to Image` はプロンプトから画像を生成し、`Tencent HY Image: Edit` は最大 5 枚の参照画像を編集または合成します。どちらも Comfy API を通じて Tencent のサーバー上で実行されるため、モデルのダウンロードやローカル GPU は不要です。

## HY Image 3.5 Preview が得意なこと

* **多言語のテキストと組版**: 単なる情景画像ではなく、ポスター、インフォグラフィック、UI モックアップ向けに読みやすいテキストを描画します
* **フォトリアリズムの幅**: 短いプロンプトからシネマティックなカット、コミック調、商業写真、イラストまで対応します
* **編集の一貫性**: 背景、服装、スタイルを変更しても人物や製品の特徴を保ちます
* **最大 5 枚の参照画像**: 1 回の編集で複数の画像を組み合わせ、プロンプトでそれぞれを参照できます
* **最大 4K 出力**: ネイティブで最大 2K をレンダリングし、4K 出力は 2K のレンダリング結果からアップスケールします

<Tip>
  APIノードを使用するには、正しくログインしていることと、許可されたネットワーク環境で使用していることを確認する必要があります。APIノードの使用に必要な具体的な要件については、ドキュメントの「[APIノードの概要](/ja/tutorials/partner-nodes/overview)」セクションをご参照ください。
</Tip>

<Tip>
  <Tabs>
    <Tab title="ローカルユーザー">
      ComfyUI が最新版に更新されていることを確認してください。

      * [ComfyUI のダウンロード](https://www.comfy.org/download)
      * [更新手順](/ja/installation/update_comfyui)

      このガイドで紹介するワークフローは、[ワークフローテンプレート](/ja/interface/features/template)から入手できます。
      テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。

      ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：

      1. 最新の ComfyUI（Nightly 版）を使用していない
      2. 起動時に一部のノードのインポートに失敗している
    </Tab>

    <Tab title="クラウドユーザー">
      * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。

      したがって、このドキュメントでコアノードが見つからない場合、それは新しいコアノードがまだ最新の安定版にリリースされていない可能性があります。次回の安定版リリースをお待ちください。
    </Tab>
  </Tabs>
</Tip>

## Tencent HY Image 3.5 Preview テキストから画像へのワークフロー

テキストプロンプトから 1 枚の画像を生成します。モデルはレンダリング前にプロンプトを書き直して拡張するため、短いプロンプトでも使用できます。

<CardGroup cols={2}>
  <Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=api_tencent_hy_image_3_5_preview_t2i&utm_source=docs&utm_medium=referral&utm_campaign=hy-image-3-5">
    Comfy Cloud で開く
  </Card>

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_tencent_hy_image_3_5_preview_t2i.json">
    JSON をダウンロードするか、テンプレートライブラリで「HY Image 3.5」を検索してください
  </Card>
</CardGroup>

![暗い背景の光沢ある液体金属の上に、白い大文字で HY IMAGE 3.5 PREVIEW と記されたポスター](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_tencent_hy_image_3_5_preview_t2i.png)

### ワークフローの実行手順

1. `Tencent HY Image: Text to Image` ノードの `prompt` を編集します。
2. （オプション）`aspect_ratio` を設定して出力の形を制御します。`auto` ではモデルがプロンプトからアスペクト比を選びますが、4K では `auto` は使用できません。
3. （オプション）`resolution` をデフォルトの `2K` から変更します。`1K` は約 1024x1024、`2K` は約 2048x2048 ピクセルです。`4K` 出力は 2K でレンダリングした後にモデルがアップスケールします。
4. （オプション）`resolution` を `custom` に切り替えて、正確な `width` と `height` を指定します。どちらも 16 の倍数である必要があり、合計ピクセル数は最大 4096x4096 です。アスペクト比が約 6:1 を超えると、モデルが被写体を繰り返し始めます。
5. `Run` をクリックするか `Ctrl(cmd) + Enter` を押して画像を生成します。
6. `Save Image` ノードで結果を確認します。

## Tencent HY Image 3.5 Preview 画像編集ワークフロー

テキストの指示で最大 5 枚の参照画像を編集または合成します。被写体の特徴を保ったまま、背景の変更、服装の差し替え、製品写真のスタイル変更、複数の参照画像の 1 枚への統合に使用できます。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_tencent_hy_image_3_5_preview_image_edit-1.webp" alt="Tencent HY Image 3.5 Preview 画像編集の出力例" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=api_tencent_hy_image_3_5_preview_image_edit&utm_source=docs&utm_medium=referral&utm_campaign=hy-image-3-5">
    Comfy Cloud で開く
  </Card>

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_tencent_hy_image_3_5_preview_image_edit.json">
    JSON をダウンロードするか、テンプレートライブラリで「HY Image 3.5」を検索してください
  </Card>
</CardGroup>

<details className="prose" style={{marginBottom:"1rem"}}>
  <summary>入力素材</summary>

  このサンプル入力画像をダウンロードしてワークフローを試せます:

  <CardGroup cols={1}>
    <Card title="入力画像" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/futuristic_brutalist_motorcycle.png">
      サンプル入力画像をダウンロード
    </Card>
  </CardGroup>
</details>

![深紅の背景に、角張ったマットブラックのコンセプトバイクがオレンジのパドックスタンドで支えられている](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/futuristic_brutalist_motorcycle.png)

### ワークフローの実行手順

1. `Tencent HY Image: Edit` ノードにすでに接続されている `Load Image` ノードにサンプル画像をアップロードします。ダウンロードしたワークフローはファイル名（`futuristic_brutalist_motorcycle.png`）で参照するため、アップロードするまでこのノードは空のままです。自分の画像を編集する場合は、`Tencent HY Image: Edit` ノードの `images` 入力に 1〜5 枚の画像を接続してください。
2. `prompt` に編集の指示を書きます。入力した順に `@Image1`、`@Image2` のように参照します。バッチ入力は画像 1 枚につき 1 回として数えます。
3. （オプション）`aspect_ratio` と `resolution` を設定します。`auto` では出力が最初の参照画像のアスペクト比に従います。`4K` 出力は 2K でレンダリングした後にモデルがアップスケールします。
4. （オプション）`reference_detail` を `high` にすると、モデルは参照画像を 1024x1024 ではなく最大 2048x2048 ピクセルで参照します。小さな文字や細部をより保てますが、時間がかかります。
5. `Run` をクリックするか `Ctrl(cmd) + Enter` を押して画像を生成します。
6. `Save Image` ノードで結果を確認します。

### プロンプトのヒント

* 変更する部分と、変更せずに保つ部分を分けて書きます。例: `@Image1 change the background to a night market, keep the subject and jacket unchanged`
* 参照画像の番号は接続した順になります。プロンプト内の番号は入力順と一致させてください
* `watermark` はノードの詳細オプションにあり、既定ではオフです。オンにすると出力に AI 生成のウォーターマークが追加されます

## はじめに

1. ComfyUI を最新バージョンに更新するか、[Comfy Cloud](https://cloud.comfy.org/?utm_source=docs\&utm_medium=referral\&utm_campaign=hy-image-3-5) を使用します
2. テンプレートライブラリで `HY Image 3.5` を検索します
3. テキストから画像へのワークフロー、または画像編集ワークフローを開いて実行します