> ## 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.

# Tencent HY4: ComfyUI 画像からプロンプト生成と画像分析

> ComfyUI で Tencent HY4 を実行し、参照画像をアートプロンプト、キャプション、チャートの内訳に変換できます。推論、複数画像、トークン制御にも対応しています。

**Tencent HY4** は Tencent の大規模言語モデルで、ComfyUI では `Tencent HY` パートナーノードを通じて利用できます。このノードはテキストプロンプトと最大 20 枚の画像を受け取り、テキストを返します。参照画像から作成したアートプロンプト、キャプション、チャートの内訳、その他依頼した任意の回答などです。

Hy4 は 2026 年 11 月 4 日にリリースされました。視覚的理解を備えた初の Hy 世代であり、Tencent によれば Hy4 プレビューと比較して、指示への追従性、長文コンテキストの理解、長期的なエージェントタスクにおいて改善が見られます。このノードは Comfy API を通じてモデルを呼び出すため、モデルのダウンロードやローカル GPU は必須ではありません。

ここで扱うテンプレートは画像からプロンプトへの変換例です。写真を読み取り、画像モデルに貼り付けられるカンマ区切りのプロンプトを生成します。

## Tencent HY ノードが得意なこと

* **画像からプロンプト**: 被写体、構図、カメラ、ライティング、色、質感、スタイルを網羅する構造化プロンプトを生成します
* **画像理解**: 写真、スクリーンショット、ドキュメントに対するキャプション、チャートや図の分解、細部の確認
* **1リクエストで複数画像**: 1回の呼び出しで最大20枚の画像を処理でき、バッチ内の各画像は1回としてカウントされます
* **指示の制御**: `system_prompt` は常設の役割を保持し、`prompt` は今回の実行におけるタスクを担います
* **推論の切り替え**: `reasoning` を有効にすると、必要なタスクでモデルが回答前に思考します
* **長い回答**: `max_tokens` は最大64000トークンまで受け付けます

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

> [!TIP]
>
> > [tab] ローカルユーザー
> >
> > ComfyUI が最新版に更新されていることを確認してください。
> >
> > * [ComfyUI のダウンロード](https://www.comfy.org/download)
> > * [更新手順](https://docs.comfy.org/ja/installation/update_comfyui.md)
> >
> > このガイドで紹介するワークフローは、[ワークフローテンプレート](https://docs.comfy.org/ja/interface/features/template.md)から入手できます。
> > テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。
> >
> > ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：
> >
> > 1. 最新の ComfyUI（Nightly 版）を使用していない
> > 2. 起動時に一部のノードのインポートに失敗している
>
> > [tab] クラウドユーザー
> >
> > * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。
> >
> > したがって、このドキュメントでコアノードが見つからない場合、それは新しいコアノードがまだ最新の安定版にリリースされていない可能性があります。次回の安定版リリースをお待ちください。

## Tencent HY4 画像からプロンプトへのワークフロー

テンプレートは参照写真を読み込み、Tencent HY にスタンダードなアートプロンプトを要求し、必要に応じてプロンプトと回答を実行と一緒に保存できます。

![Tencent HY4 image to prompt workflow preview](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_tencent_hy4-1.webp)

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_tencent_hy4.json)
>
> JSON をダウンロードするか、テンプレートライブラリで "Tencent: Hy4" を検索してください

**入力素材**

このファイルを対応する `LoadImage` ノードにアップロードしてください:

> [card] [blue\_poppies\_field.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/blue_poppies_field.png)
>
> `LoadImage` ノード · `blue_poppies_field.png`

### ワークフローを実行する手順

このワークフローは、Tencent HY で返信を生成し、必要に応じてその会話履歴を ComfyUI に保存する方法を示します。参照画像を読み込んでグラフを実行し、`Preview Any` で回答を確認してください。保存が必要なら `Save Text` を残すとプロンプトと回答が `output/Hy4/` に書き出されます。不要ならそのノードをスキップまたは削除してください。

### プロンプト作成のヒント

* 出力形式を明示してください。テンプレートの `Only output positive prompt, no extra explanations` という行が、回答をそのまま貼り付けられる状態に保つ役割を果たします
* 複数の画像を接続する場合は、順番に言及してください（`the first image`、`the second image`）。そうすることで詳細が正しい画像に紐づきます
* 繰り返し使う指示は `system_prompt` に置き、`prompt` はタスク用に残してください。例えば `You write photography prompts for a stock library`
* `seed` はノードを再実行するかどうかだけを決めます。回答は実行ごとに変わります

## はじめる

ComfyUI を更新し、テンプレートライブラリで `Tencent: Hy4` を検索して、画像からプロンプトを生成するワークフローを開きます。

Tencent HY4はAPIのトークン使用量に基づいて課金されます。Hy4の料金については[料金表](https://docs.comfy.org/ja/tutorials/partner-nodes/pricing.md)をご覧ください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.