Nodes/ComfyUI Seedance/MiniMax H3 Context IR 提示词增强(3 合 1)
ComfyUI Node

MiniMax H3 Context IR 提示词增强(3 合 1)

MiniMax H3 Context IR enhances your prompt, not your clip

By T8mars·Created 2 months ago·Updated 3 days ago· 31
MiniMax H3 Context IR 提示词增强(3 合 1)
  • image1
  • image2
  • image3
  • image4
  • image5
  • image6
  • image7
  • image8
  • image9
  • video1
  • video2
  • video3
  • audio1
  • audio2
  • audio3
  • api_config
  • result_text
  • task_id
  • response
modelminmax-h3-context-ir-text
prompt
seconds4
ratio16:9
skip_errorfalse
seed0

This is the one node in the pack that does not generate anything visual. MiniMax H3 Context IR is a prompt enhancer: you give it a rough video prompt, optionally some context (first/last frames, or a whole multimodal mood board of images, videos and audio), and it returns a richer, production-grade prompt via its result_text output. Then you wire that string into a video generation node's prompt input - the pack's own H3 OW video nodes are the natural match, but it'll feed any of the video models in this pack.

Three modes sit behind the dropdown: Text (pure prompt in, enhanced prompt out), Image (adds first/last frame context), and Multimodal (up to 9 images, 3 videos, 3 audios as context). It's the "tell me what to say to the model" step, and for anyone whose video prompts come out vague, it's quietly one of the most useful nodes here.

How it works

It submits to the same compat endpoint the video models use (POST /v1/video/generations), polls, and reads the enhancement from the response's result_text field. The node uses the standard seed-cache and skip_error controls, but it doesn't join the concurrent future system - it's a single-shot transformer, not a batch generator. Key real-world detail from the pack's testing: multimodal images go in the top-level images field, videos go into metadata.video_urls (plural), and audio into metadata.audio_url - and all three can ride in one task.

The inputs that matter

  • model - minmax-h3-context-ir-text, -image, or -multimodal.
  • prompt - the video prompt to enhance, 1 to 7000 characters.
  • seconds - the target video duration, 4 to 15. It steers the enhancement's pacing advice.
  • ratio - mode-dependent: Text requires one of the fixed ratios; Multimodal accepts adaptive or api_default; Image mode sends no ratio at all.
  • image1/image2 (Image mode), image1..9 + video1..3 + audio1..3 (Multimodal) - the context pool.

Outputs: result_text (the enhanced prompt - the whole point), task_id, response.

Installing it

ComfyUI Manager → search "ComfyUI Seedance", or:

cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/ComfyUI_Seedance.git
cd ../..
python -m pip install -r custom_nodes/ComfyUI_Seedance/requirements.txt

Restart, key from api.seedance.nz/console, Seedance API Config into api_config.

Common issues

  • It "doesn't work" - you're expecting a video. There is no video output. The result is text; connect result_text to a video node's prompt.
  • Text mode rejects your ratio - Text requires one of the six fixed ratios; adaptive isn't allowed there.
  • Image mode ignores your ratio - by design; it follows the frame.
  • Multimodal references not landing - the pack verified the field mapping; if audio isn't landing, make sure it's an AUDIO input connected to audio1..3, and remember videos max at 3 and images at 9.

Use it the way the example workflows do: Context IR → enhanced prompt → H3 OW video. You get a noticeably more directed clip than prompting cold, and it costs you one extra API call.

CategorySeedance

Inputs (22)

NameTypeDefaultDescription
modelCOMBOminmax-h3-context-ir-textEnhance a video prompt from text, first/last frames, or mixed image/video/audio references. | 使用文本、首尾帧或图像/视频/音频混合素材增强视频提示词。
promptSTRINGVideo prompt to enhance, 1 to 7000 characters. | 待增强的视频提示词,1 到 7000 字符。
secondsCOMBO4Target video duration from 4 to 15 seconds. | 目标视频时长为 4 到 15 秒。
ratioCOMBO16:9Text mode requires a fixed ratio. Multimodal also supports adaptive or api_default; Image mode does not send ratio. | Text 必须选择固定比例;Multimodal 还支持 adaptive 或 api_default;Image 不发送比例。
image1optIMAGEContext image 1. Image mode accepts image1 and optional image2; Multimodal accepts up to 9 images. | 上下文图片 1;Image 模式使用 image1 和可选 image2,Multimodal 最多支持 9 张图。
image2optIMAGEContext image 2. Image mode accepts image1 and optional image2; Multimodal accepts up to 9 images. | 上下文图片 2;Image 模式使用 image1 和可选 image2,Multimodal 最多支持 9 张图。
image3optIMAGEContext image 3. Image mode accepts image1 and optional image2; Multimodal accepts up to 9 images. | 上下文图片 3;Image 模式使用 image1 和可选 image2,Multimodal 最多支持 9 张图。
image4optIMAGEContext image 4. Image mode accepts image1 and optional image2; Multimodal accepts up to 9 images. | 上下文图片 4;Image 模式使用 image1 和可选 image2,Multimodal 最多支持 9 张图。
image5optIMAGEContext image 5. Image mode accepts image1 and optional image2; Multimodal accepts up to 9 images. | 上下文图片 5;Image 模式使用 image1 和可选 image2,Multimodal 最多支持 9 张图。
image6optIMAGEContext image 6. Image mode accepts image1 and optional image2; Multimodal accepts up to 9 images. | 上下文图片 6;Image 模式使用 image1 和可选 image2,Multimodal 最多支持 9 张图。
image7optIMAGEContext image 7. Image mode accepts image1 and optional image2; Multimodal accepts up to 9 images. | 上下文图片 7;Image 模式使用 image1 和可选 image2,Multimodal 最多支持 9 张图。
image8optIMAGEContext image 8. Image mode accepts image1 and optional image2; Multimodal accepts up to 9 images. | 上下文图片 8;Image 模式使用 image1 和可选 image2,Multimodal 最多支持 9 张图。
image9optIMAGEContext image 9. Image mode accepts image1 and optional image2; Multimodal accepts up to 9 images. | 上下文图片 9;Image 模式使用 image1 和可选 image2,Multimodal 最多支持 9 张图。
video1optVIDEOMultimodal reference video 1, up to 3 videos. | 多模态参考视频 1,最多 3 个。
video2optVIDEOMultimodal reference video 2, up to 3 videos. | 多模态参考视频 2,最多 3 个。
video3optVIDEOMultimodal reference video 3, up to 3 videos. | 多模态参考视频 3,最多 3 个。
audio1optAUDIOMultimodal reference audio 1, up to 3 audios. | 多模态参考音频 1,最多 3 个。
audio2optAUDIOMultimodal reference audio 2, up to 3 audios. | 多模态参考音频 2,最多 3 个。
audio3optAUDIOMultimodal reference audio 3, up to 3 audios. | 多模态参考音频 3,最多 3 个。
api_configoptSEEDANCE_CONFIGConnect Seedance API Config; otherwise SEEDANCE_API_KEY is used.
skip_erroroptBOOLEANfalseOn failure return empty text and an error response instead of stopping the workflow. | 失败时返回空文本和错误响应,不中断工作流。
seedoptINT00–18446744073709550000ComfyUI cache seed. Fixed reuses the cached result while all other inputs stay unchanged; randomize/increment/decrement starts a new execution. This value is not sent to models without documented seed support. | ComfyUI 缓存种子;Fixed 在其他输入不变时复用缓存,随机、递增或递减会触发新任务。未声明支持 seed 的模型不会收到此参数。

Outputs (3)

NameTypeDescription
result_textSTRING
task_idSTRING
responseSTRING