画像

HY Image 3.5 Preview API

HY Image 3.5 Preview APIでTencent Hunyuanの最新画像モデルを利用できます。テキストからの画像生成、参照画像による編集、複数画像の合成を1つのモデルで行え、多言語の文字描画に強く、1K・2K・4Kまたは正確なピクセルサイズで出力できます。

テキストから画像画像編集参照画像最大5枚1K / 2K / 4K文字描画

APIキーを取得 APIドキュメント

サービスの特長

公式割引
従量課金
高速・低遅延

Input

モデル

参照画像

プロンプト

アスペクト比

解像度

ネガティブプロンプト

シード値

出力

Image link valid for 72 hours

HY Image 3.5 Preview API 料金

隠れた費用のない透明な料金体系。使った分だけお支払い。

モデル	プラン	ゴールド価格現在の価格	プラチナ価格	ダイヤモンド価格	公式価格	割引率
`hy-image-v3.5-preview`	1K	0.192Credits(~$0.0192)/枚	0.1824Credits(~$0.0182)/枚	0.1728Credits(~$0.0173)/枚	0.24Credits(~$0.024)/枚	20%
	2K	0.192Credits(~$0.0192)/枚	0.1824Credits(~$0.0182)/枚	0.1728Credits(~$0.0173)/枚	0.24Credits(~$0.024)/枚	20%
	4K	0.256Credits(~$0.0256)/枚	0.2432Credits(~$0.0243)/枚	0.2304Credits(~$0.023)/枚	0.32Credits(~$0.032)/枚	20%

* 実際の費用は最終出力に基づきます。

HY Image 3.5 Preview APIで画像生成と編集

Tencent HunyuanのHY Image 3.5 Previewは、テキストからの画像生成、写真の編集、最大5枚の参照画像の合成を1つのモデルでこなします。APIMartでモデルID hy-image-v3.5-previewを指定してHY Image 3.5 Preview APIを呼び出し、中国語と英語の文字が読みやすいポスター、商品シーン、人物を保った連続編集を作成できます。

HY Image 3.5 Preview API の主な機能

HY Image 3.5 Preview API で使える生成・編集・出力の設定

1つのHY Image APIで生成と編集

HY Image 3.5 PreviewはモデルID hy-image-v3.5-preview ひとつでテキストからの生成、参照画像からの生成、画像編集を扱うため、1回の連携で制作と修正の両方をカバーできます。

HY Image 3.5 Previewの多言語文字描画

Tencent HY Image 3.5は中国語・英語などの見出し、ラベル、キャプションをきれいにレイアウトでき、ポスターやインフォグラフィック、UIモックアップに向いています。

HY Image 3.5 Preview APIは参照画像最大5枚

1回のhy-image-v3.5-previewリクエストで最大5枚の参照画像を渡し、写真の編集、商品の新しいシーンへの配置、人物・スタイル・背景の合成ができます。

HY Image 3.5 Previewモデルで被写体を維持

背景・服装・画風を変えても、HY Image 3.5 Previewモデルは参照画像の人物や商品の重要な特徴を保ちます。

HY Image 3.5 Preview APIの解像度区分

どのアスペクト比でも1K・2K・4Kを選べます（hy-image-v3.5-previewの既定は1K）。ピクセルを直接指定した場合は、出力画像の短辺で区分が決まります。

hy-image-v3.5-previewのピクセル指定

自動、または1:1〜21:9の10種類の比率から選べます。幅と高さを各256〜8192px、総ピクセル数8,294,400以下で直接指定することもできます。

HY Image 3.5 Previewのネガティブプロンプトとシード

negative_promptで不要な要素を除外し、seedを固定すると構図を再現できます。seedを空欄または0にするとランダムに生成されます。

HY Image 3.5 Preview APIは1リクエスト1枚

HY Image APIの各リクエストは非同期タスクで画像を1枚返します。不正なパラメータは400エラーとなり課金されず、失敗したタスクは全額返金されます。

HY Image 3.5 Preview API の活用例

マーケティング・商品・デザインチームがHY Image 3.5 Previewモデルで作れるもの

HY Image 3.5 Previewで中英バイリンガルのポスター

中国語と英語の見出しが読みやすいキャンペーンポスター、バナー、SNS画像を生成できます。公開前に文言を確認してください。

HY Image 3.5 Preview APIでEC商品画像

参照写真の商品をライフスタイルやスタジオのシーンに配置し、商品ページや広告、サムネイルに使えます。

Tencent HY Image 3.5でインフォグラフィックとUIモック

文字・アイコン・構成がはっきり読み取れる必要があるインフォグラフィック、アプリ画面、スライド用ビジュアルの下書きに。

HY Image 3.5 Previewでファッション・キャラクター編集

服装、背景、画風を入れ替えながら、一連の画像で同じ顔やキャラクターを保てます。

HY Image 3.5 Preview APIでイラストとコンセプトアート

企画初期に、シネマティック、コミック、イラスト、商業写真などのスタイルを1つのモデルで試せます。

hy-image-v3.5-previewで複数画像を合成

人物・商品・背景など最大5枚の参照画像を、プロンプトで指示した1つの自然なシーンにまとめます。

HY Image 3.5 Preview APIキーの取得と始め方

登録から最初のHY Image 3.5 Preview APIリクエストまでの3ステップ

APIMartアカウントを作成

無料で登録できます。1つのAPIMartアカウントで、HY Image API経由のHY Image 3.5 Previewとプラットフォーム上のすべてのモデルを利用できます。

→

クレジットを追加

残高をチャージします。クレジットは全モデル共通で、HY Image 3.5 Previewは出力画像1枚ごとに課金されます。

→

APIキーでhy-image-v3.5-previewを呼び出す

ダッシュボードでAPIキーを発行し、モデルhy-image-v3.5-previewを指定してPOST /v1/images/generationsを呼び出します。

APIキーを取得

HY Image 3.5 Preview API よくある質問

HY Image 3.5 Preview APIのモデル、入力、サイズ、料金、APIキー、結果の取得について

HY Image 3.5 Preview APIとは何ですか？

HY Image 3.5 Preview APIは、Tencent Hunyuanの画像生成・編集モデルHY Image 3.5 Previewを呼び出すためのAPIです。このモデルは2026年9月22日にホスト型のプレビュー版として公開され、テキストからの生成、参照画像からの生成、編集を1つのモデルで行えます。APIMartではモデルIDにhy-image-v3.5-previewを指定します。

HY Image 3.5 PreviewとHunyuanImage 3.0の違いは？

HunyuanImage 3.0はTencentが以前公開したオープンウェイトのモデルです。HY Image 3.5 Previewはウェイト非公開のホスト型モデルで、Tencentは文字描画、リアルさ、編集の一貫性を強化したアップグレードと位置付けています。

HY Image 3.5 Previewの「Preview」とはどういう意味ですか？

Tencentはこのリリースをプレビュー版としているため、出力品質や制限、基盤モデルが変わる可能性があります。本番利用の前に重要なHY Image APIのワークフローをテストし、このページの更新を確認してください。

HY Image 3.5 Preview APIで送れる参照画像は何枚？

image_urlsに、公開アクセス可能なJPEG・PNG・WebP画像のURLを最大5枚まで指定できます（1枚7MB未満を推奨）。残す要素・変える要素・合成する要素をプロンプトで説明してください。image_urlsを省略すると、hy-image-v3.5-previewはテキストから画像を生成します。

HY Image 3.5 Preview APIが対応するサイズは？

sizeはauto（既定）または1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9、resolutionは1K（既定）・2K・4Kから指定します。正確なサイズが必要なら、hy-image-v3.5-previewのsizeに2000x1104のようなピクセル値を渡すか、widthとheightをセットで指定します（各辺256〜8192px、総ピクセル数8,294,400以下）。

1回の呼び出しで複数枚生成できますか？

できません。HY Image 3.5 Previewは1リクエストにつき1枚のため、nは1にしてください。複数のバリエーションが必要な場合は並行してリクエストを送ってください。

HY Image 3.5 Previewで同じ画像を何度も編集できますか？

できます。前回の結果を参照画像としてhy-image-v3.5-previewに渡し、新しい指示を添えてください。各ラウンドは個別のリクエストになります。

HY Image 3.5 Preview APIの料金は？

HY Image 3.5 Previewは出力画像1枚ごとの課金です。アスペクト比指定ではresolutionの区分、ピクセル指定では短辺で区分が決まり、1024px以下は1K、1025〜2048pxは2K、それ以上は4Kです。最新料金はこのページの料金表に表示され、失敗したタスクは全額返金されます。

HY Image 3.5 Preview APIキーはどう取得しますか？

APIMartにログインしてクレジットを追加し、API Keysページでキーを作成します。AuthorizationヘッダーにBearerトークンとして渡してください。同じAPIキーで、すべてのHY Image APIリクエストとAPIMartのほかのモデルを利用できます。

HY Image 3.5 Preview APIの生成結果はどう取得しますか？

モデルhy-image-v3.5-previewでPOST /v1/images/generationsに送信してtask_idを保存し、GET /v1/tasks/{task_id}を3〜5秒ごとに最大5分ほどポーリングします。ステータスがcompletedになったらresult.images[0].url[0]を読み取り、expires_atまでに画像をダウンロードしてください。

HY Image 3.5 PreviewはHY Image 3.5やHunyuan Image 3.5と同じですか？

はい、いずれもTencentの同じモデルを指します。画像エンドポイントのモデルIDはhy-image-v3.5-previewで、TencentのチャットドキュメントではHy-Image-3.5-Preview、ベンチマークサイトではHunyuanImage 3.5 (Preview)と表記されます。HY-Image 3.5、Hy Image3.5、HY Image v3.5、Hunyuan Image 3.5 APIといった表記も同じモデルです。APIMartではHY Image APIでhy-image-v3.5-previewを指定して呼び出してください。

サポートに問い合わせるにはどうすればよいですか？

ページ右下のライブチャット、[email protected] へのメール、またはDiscordコミュニティからお問い合わせいただけます。チームができるだけ早くご対応いたします。