Repository navigation
docs(minimax): add a MiniMax H3 Image API page #2372
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
comfyui-wiki
merged 1 commit into
Comfy-Org:main
from
lin-bot23:docs/minimax-h3-image-api
Nov 16, 2026
Merged
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,79 @@ | ||
| --- | ||
| title: "MiniMax H3 Image API: Texto a imagen y edición de imágenes en ComfyUI" | ||
| description: "Genera imágenes 2K o 4K desde un prompt o edita hasta 16 imágenes de referencia con MiniMax H3 Image mediante la API de socios de ComfyUI." | ||
| sidebarTitle: "MiniMax H3 Image" | ||
| translationSourceHash: ffae3038 | ||
| translationFrom: tutorials/partner-nodes/minimax/minimax-h3-image.mdx | ||
| translationBlockHashes: | ||
| "_intro": b2e9cda8 | ||
| "What MiniMax H3 Image is good at": 028a76d3 | ||
| "Text to image {#api_minimax_h3_image_t2i}": cd37d4b1 | ||
| "Image edit {#api_minimax_h3_image_image_edit}": cacb7043 | ||
| "Options": b178c63a | ||
| "Get started": d289ab9b | ||
| --- | ||
| import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; | ||
| import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; | ||
|
|
||
| MiniMax H3 Image es el modelo de imagen de MiniMax, disponible en ComfyUI a través del nodo de socio **MiniMax H3 Image**. Texto a imagen y la edición de imágenes usan el mismo nodo: sin imágenes de referencia conectadas, genera a partir de tu prompt, y con referencias conectadas, las edita o las combina. | ||
|
|
||
| Los flujos de trabajo se ejecutan en los servidores de MiniMax a través de tu cuenta de Comfy API, así que no hay descargas de modelos ni una GPU local que administrar. | ||
|
|
||
| <ReqHint/> | ||
| <UpdateReminder/> | ||
|
|
||
| ## En qué destaca MiniMax H3 Image | ||
|
|
||
| - **Salida en 2K y 4K**: elige un nivel de tamaño y una relación de aspecto, o define un ancho y un alto exactos | ||
| - **Edición de imágenes**: edita o combina hasta 16 imágenes de referencia, a las que haces referencia en el prompt como `@Image1` a `@Image16` | ||
| - **Reescritura de prompts**: de forma predeterminada, MiniMax amplía un prompt corto hasta convertirlo en una descripción detallada de la escena y devuelve el prompt reescrito junto con la imagen | ||
| - **Detalle de nivel de cartel**: adecuado para carteles, embalajes e imágenes editoriales que necesitan texto legible y detalle denso | ||
|
|
||
| ## Texto a imagen {#api_minimax_h3_image_t2i} | ||
|
|
||
| Genera una imagen a partir de un prompt en 2K o 4K. | ||
|
|
||
| <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_minimax_h3_image_t2i-1.webp" alt="Vista previa del flujo de trabajo de texto a imagen de MiniMax H3 Image" /> | ||
|
|
||
| <CardGroup cols={2}> | ||
| <Card title="Descargar flujo de trabajo" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_minimax_h3_image_t2i.json"> | ||
| Descarga el JSON o busca "MiniMax-H3-Image: Text to Image (API)" en la Biblioteca de plantillas | ||
| </Card> | ||
| </CardGroup> | ||
|
|
||
| ## Editar imagen {#api_minimax_h3_image_image_edit} | ||
|
|
||
| Conecta una imagen de origen, describe el cambio y solo se reescribe lo que pide el prompt. La plantilla agrega una mujer a un render finalizado y conserva el resto del encuadre. | ||
|
|
||
| <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_minimax_h3_image_image_edit-1.webp" alt="Vista previa del flujo de trabajo de edición de imágenes de MiniMax H3 Image" /> | ||
|
|
||
| <CardGroup cols={2}> | ||
| <Card title="Descargar flujo de trabajo" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_minimax_h3_image_image_edit.json"> | ||
| Descarga el JSON o busca "MiniMax-H3-Image: Image Edit (API)" en la Biblioteca de plantillas | ||
| </Card> | ||
| </CardGroup> | ||
|
|
||
| **Materiales de entrada** | ||
|
|
||
| <CardGroup cols={2}> | ||
| <Card title="surreal_rendering_modern.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/surreal_rendering_modern.png"> | ||
| `LoadImage` · `surreal_rendering_modern.png` | ||
| </Card> | ||
| </CardGroup> | ||
|
|
||
| ## Opciones | ||
|
|
||
| | Entrada | Valores | Notas | | ||
| | :---- | :----- | :---- | | ||
| | `model` | `MiniMax-H3-Image`, `MiniMax-H3-Image-Highspeed` | En la plantilla, cambia el menú desplegable `model` para cambiar de modelo | | ||
| | `size` | `2K`, `4K`, `custom` | 2K y 4K derivan el ancho y el alto de la relación de aspecto. `custom` toma un ancho y un alto de 512 a 7680 px cada uno, con 655,360 a 20,000,000 px en total y una relación de aspecto de 3:1 como máximo | | ||
| | `aspect_ratio` | `auto` más 15 relaciones fijas | `auto` sigue el prompt, o la imagen de referencia cuando hay una conectada | | ||
| | `enhance_prompt` | activado de forma predeterminada | MiniMax reescribe primero el prompt como una descripción detallada de la escena. Las ediciones siempre se mejoran, así que desactivarlo solo afecta a Texto a imagen, que entonces necesita una relación fija o un tamaño personalizado | | ||
| | `images` | hasta 16 | Imágenes de referencia para editar y combinar. Menciónalas en el prompt como `@Image1`, `@Image2`, etc., en el orden de conexión | | ||
|
|
||
| Los prompts pueden tener hasta 8,000 caracteres cuando hay imágenes de referencia conectadas. El nodo también devuelve el `revised_prompt` reescrito junto a la imagen. | ||
|
|
||
| ## Empezar | ||
|
|
||
| 1. Actualiza ComfyUI a 0.45.1 o posterior | ||
| 2. En la biblioteca de plantillas, busca `MiniMax-H3-Image` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,79 @@ | ||
| --- | ||
| title: "MiniMax H3 Image API: ComfyUIでのテキストから画像生成と画像編集" | ||
| description: "プロンプトから2Kまたは4K画像を生成するか、ComfyUIパートナーAPIを通じてMiniMax H3 Imageで最大16枚の参照画像を編集します。" | ||
| sidebarTitle: "MiniMax H3 Image" | ||
| translationSourceHash: ffae3038 | ||
| translationFrom: tutorials/partner-nodes/minimax/minimax-h3-image.mdx | ||
| translationBlockHashes: | ||
| "_intro": b2e9cda8 | ||
| "What MiniMax H3 Image is good at": 028a76d3 | ||
| "Text to image {#api_minimax_h3_image_t2i}": cd37d4b1 | ||
| "Image edit {#api_minimax_h3_image_image_edit}": cacb7043 | ||
| "Options": b178c63a | ||
| "Get started": d289ab9b | ||
| --- | ||
| import ReqHint from "/snippets/ja/tutorials/partner-nodes/req-hint.mdx"; | ||
| import UpdateReminder from "/snippets/ja/tutorials/update-reminder.mdx"; | ||
|
|
||
| MiniMax H3 Image は MiniMax の画像モデルで、ComfyUI では **MiniMax H3 Image** パートナーノードから利用できます。テキストから画像への生成と画像編集は同じノードを使います。参照画像を接続しない場合はプロンプトから生成し、参照画像を接続した場合はそれらを編集または合成します。 | ||
|
|
||
| ワークフローは Comfy API アカウントを通じて MiniMax のサーバー上で実行されるため、モデルのダウンロードやローカル GPU の管理は不要です。 | ||
|
|
||
| <ReqHint/> | ||
| <UpdateReminder/> | ||
|
|
||
| ## MiniMax H3 Image が得意なこと | ||
|
|
||
| - **2K・4K 出力**: サイズティアとアスペクト比を選ぶか、幅と高さを正確に指定できます | ||
| - **画像編集**: 最大 16 枚の参照画像を編集または結合できます。プロンプト内では `@Image1` から `@Image16` として指定します | ||
| - **プロンプトの書き換え**: MiniMax はデフォルトで短いプロンプトを詳細なシーン説明へと展開し、書き換え後のプロンプトを画像とともに返します | ||
| - **ポスター品質のディテール**: 読みやすいテキストと緻密なディテールが求められるポスター、パッケージ、エディトリアル画像に適しています | ||
|
|
||
| ## テキストから画像を生成 {#api_minimax_h3_image_t2i} | ||
|
|
||
| プロンプトから 2K または 4K の画像を生成します。 | ||
|
|
||
| <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_minimax_h3_image_t2i-1.webp" alt="MiniMax H3 Image テキストから画像へのワークフローのプレビュー" /> | ||
|
|
||
| <CardGroup cols={2}> | ||
| <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_minimax_h3_image_t2i.json"> | ||
| JSON をダウンロードするか、テンプレートライブラリで "MiniMax-H3-Image: Text to Image (API)" を検索してください | ||
| </Card> | ||
| </CardGroup> | ||
|
|
||
| ## 画像編集 {#api_minimax_h3_image_image_edit} | ||
|
|
||
| ソース画像を接続し、変更内容を記述すると、プロンプトで要求した部分だけが書き換えられます。テンプレートは完成したレンダリングに女性を追加し、フレームの残りの部分は維持します。 | ||
|
|
||
| <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_minimax_h3_image_image_edit-1.webp" alt="MiniMax H3 画像編集ワークフローのプレビュー" /> | ||
|
|
||
| <CardGroup cols={2}> | ||
| <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_minimax_h3_image_image_edit.json"> | ||
| JSON をダウンロードするか、テンプレートライブラリで「MiniMax-H3-Image: Image Edit (API)」を検索してください | ||
| </Card> | ||
| </CardGroup> | ||
|
|
||
| **入力素材** | ||
|
|
||
| <CardGroup cols={2}> | ||
| <Card title="surreal_rendering_modern.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/surreal_rendering_modern.png"> | ||
| `LoadImage` · `surreal_rendering_modern.png` | ||
| </Card> | ||
| </CardGroup> | ||
|
|
||
| ## オプション | ||
|
|
||
| | 入力 | 値 | 備考 | | ||
| | :---- | :----- | :---- | | ||
| | `model` | `MiniMax-H3-Image`、`MiniMax-H3-Image-Highspeed` | テンプレートでは `model` ドロップダウンを変更して切り替えます | | ||
| | `size` | `2K`、`4K`、`custom` | 2K と 4K はアスペクト比から幅と高さを導出します。`custom` は幅と高さをそれぞれ 512〜7680 px の範囲で受け取り、合計は 655,360〜20,000,000 px、アスペクト比は最大 3:1 です | | ||
| | `aspect_ratio` | `auto` と 15 種類の固定比率 | `auto` はプロンプトに従うか、参照画像が接続されている場合はその参照画像に従います | | ||
| | `enhance_prompt` | デフォルトでオン | MiniMax はまずプロンプトを詳細なシーン記述に書き換えます。編集では常に拡張が行われるため、オフにしても影響するのはテキストからの画像生成のみで、その場合は固定比率またはカスタムサイズが必要です | | ||
| | `images` | 最大 16 枚 | 編集や合成のための参照画像です。プロンプト内では接続順に `@Image1`、`@Image2` などのように参照します | | ||
|
|
||
| 参照画像が接続されている場合、プロンプトは最大 8,000 文字まで使用できます。ノードは画像とともに、書き換えられた `revised_prompt` も返します。 | ||
|
|
||
| ## はじめる | ||
|
|
||
| 1. ComfyUIを0.45.1以降にアップデートします | ||
| 2. テンプレートライブラリで`MiniMax-H3-Image`を検索します |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,79 @@ | ||
| --- | ||
| title: "MiniMax H3 Image API: ComfyUI에서 텍스트 기반 이미지 생성 및 이미지 편집" | ||
| description: "프롬프트로 2K 또는 4K 이미지를 생성하거나, ComfyUI 파트너 API를 통해 MiniMax H3 Image로 최대 16개의 참조 이미지를 편집하세요." | ||
| sidebarTitle: "MiniMax H3 Image" | ||
| translationSourceHash: ffae3038 | ||
| translationFrom: tutorials/partner-nodes/minimax/minimax-h3-image.mdx | ||
| translationBlockHashes: | ||
| "_intro": b2e9cda8 | ||
| "What MiniMax H3 Image is good at": 028a76d3 | ||
| "Text to image {#api_minimax_h3_image_t2i}": cd37d4b1 | ||
| "Image edit {#api_minimax_h3_image_image_edit}": cacb7043 | ||
| "Options": b178c63a | ||
| "Get started": d289ab9b | ||
| --- | ||
| import ReqHint from "/snippets/ko/tutorials/partner-nodes/req-hint.mdx"; | ||
| import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx"; | ||
|
|
||
| MiniMax H3 Image는 MiniMax의 이미지 모델로, ComfyUI에서 **MiniMax H3 Image** 파트너 노드를 통해 사용할 수 있습니다. 텍스트 기반 이미지 생성과 이미지 편집은 동일한 노드를 사용합니다. 참조 이미지가 연결되지 않은 경우 프롬프트로부터 생성하고, 참조 이미지가 연결된 경우에는 이를 편집하거나 결합합니다. | ||
|
|
||
| 워크플로는 Comfy API 계정을 통해 MiniMax의 서버에서 실행되므로 모델 다운로드가 없고 관리할 로컬 GPU도 없습니다. | ||
|
|
||
| <ReqHint/> | ||
| <UpdateReminder/> | ||
|
|
||
| ## MiniMax H3 Image가 잘하는 것 | ||
|
|
||
| - **2K 및 4K 출력**: 크기 등급과 화면 비율을 선택하거나 정확한 너비와 높이를 설정하세요 | ||
| - **이미지 편집**: 최대 16개의 참조 이미지를 편집하거나 결합할 수 있으며, 프롬프트에서 `@Image1`부터 `@Image16`까지로 지정합니다 | ||
| - **프롬프트 재작성**: MiniMax는 기본적으로 짧은 프롬프트를 상세한 장면 설명으로 확장하고, 재작성된 프롬프트를 이미지와 함께 반환합니다 | ||
| - **포스터 수준의 디테일**: 읽기 쉬운 텍스트와 촘촘한 디테일이 필요한 포스터, 패키징, 에디토리얼 이미지에 적합합니다 | ||
|
|
||
| ## 텍스트 기반 이미지 생성 {#api_minimax_h3_image_t2i} | ||
|
|
||
| 프롬프트로 2K 또는 4K 해상도의 이미지를 생성합니다. | ||
|
|
||
| <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_minimax_h3_image_t2i-1.webp" alt="MiniMax H3 Image 텍스트 기반 이미지 생성 워크플로 미리보기" /> | ||
|
|
||
| <CardGroup cols={2}> | ||
| <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_minimax_h3_image_t2i.json"> | ||
| JSON을 다운로드하거나 템플릿 라이브러리에서 "MiniMax-H3-Image: Text to Image (API)"를 검색하세요 | ||
| </Card> | ||
| </CardGroup> | ||
|
|
||
| ## 이미지 편집 {#api_minimax_h3_image_image_edit} | ||
|
|
||
| 소스 이미지를 연결하고 변경 사항을 설명하면, 프롬프트가 요청한 부분만 다시 작성됩니다. 템플릿은 완료된 렌더에 여성을 추가하고 나머지 프레임은 그대로 유지합니다. | ||
|
|
||
| <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_minimax_h3_image_image_edit-1.webp" alt="MiniMax H3 이미지 편집 워크플로 미리보기" /> | ||
|
|
||
| <CardGroup cols={2}> | ||
| <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_minimax_h3_image_image_edit.json"> | ||
| JSON을 다운로드하거나 템플릿 라이브러리에서 "MiniMax-H3-Image: Image Edit (API)"를 검색하세요 | ||
| </Card> | ||
| </CardGroup> | ||
|
|
||
| **입력 자료** | ||
|
|
||
| <CardGroup cols={2}> | ||
| <Card title="surreal_rendering_modern.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/surreal_rendering_modern.png"> | ||
| `LoadImage` · `surreal_rendering_modern.png` | ||
| </Card> | ||
| </CardGroup> | ||
|
|
||
| ## 옵션 | ||
|
|
||
| | 입력 | 값 | 참고 | | ||
| | :---- | :----- | :---- | | ||
| | `model` | `MiniMax-H3-Image`, `MiniMax-H3-Image-Highspeed` | 템플릿에서 `model` 드롭다운을 변경하여 전환합니다 | | ||
| | `size` | `2K`, `4K`, `custom` | 2K와 4K는 가로세로 비율로부터 너비와 높이를 도출합니다. `custom`은 너비와 높이를 각각 512~7680 px로 지정하며, 총 655,360~20,000,000 px이고 가로세로 비율은 최대 3:1입니다 | | ||
| | `aspect_ratio` | `auto` 및 고정 비율 15개 | `auto`는 프롬프트를 따르며, 참조 이미지가 연결된 경우에는 해당 참조 이미지를 따릅니다 | | ||
| | `enhance_prompt` | 기본적으로 켜짐 | MiniMax는 프롬프트를 먼저 상세한 장면 설명으로 다시 작성합니다. 편집 작업에는 항상 프롬프트 향상이 적용되므로, 이 옵션을 끄면 텍스트 기반 이미지 생성에만 영향을 줍니다. 이 경우 고정 비율이나 사용자 지정 크기가 필요합니다 | | ||
| | `images` | 최대 16개 | 편집 및 결합을 위한 참조 이미지입니다. 프롬프트에서 연결된 순서대로 `@Image1`, `@Image2` 등으로 참조하세요 | | ||
|
|
||
| 참조 이미지가 연결된 경우 프롬프트는 최대 8,000자까지 사용할 수 있습니다. 노드는 이미지와 함께 다시 작성된 `revised_prompt`도 반환합니다. | ||
|
|
||
| ## 시작하기 | ||
|
|
||
| 1. ComfyUI를 0.45.1 이상으로 업데이트하세요 | ||
| 2. Template Library에서 `MiniMax-H3-Image`를 검색하세요 | ||
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Name the model in the opening clause of both descriptions.
The Korean and Spanish descriptions name MiniMax H3 Image only in the later editing clause. Include the model name in the opening generation clause in both files. Keep both generation and editing in scope.
As per coding guidelines, “name the action, the model, and the modality in the opening clause.”
Source: Coding guidelines