H3 Ref2V Enhancer:
ConnorH3R2VEnhancer rewrites a video idea into a structured prompt intended for Minimax H3 full-reference video generation. It sends your idea and any supplied reference images to a chat-completions service, along with detailed instructions for describing subjects, reference relationships, shots, camera movement, dialogue, sound, and music. This can help you turn a brief concept into a more explicit production-style prompt. The node does not generate or validate a video; the quality and accuracy of the rewrite depend on the service you connect and the information you provide.
H3 Ref2V Enhancer Input Parameters:
initial_prompt
Required STRING containing the video idea you want rewritten. The field supports multiple lines, so you can describe the intended action, duration, visual style, dialogue, sound, and how any references should be used. Those details give the connected service a clearer basis for its rewrite; details you leave out may not be represented as you intended. The default is (3 second video) A magic cat shooting lightning at skeletons. No minimum or maximum length is specified in the node source.
llm_url
Optional STRING specifying the chat-completions endpoint that receives the rewrite request. The default is http://localhost:8080/v1/chat/completions. Use an endpoint reachable from the machine running the node and compatible with the request and response format described below; changing this address changes which service performs the rewrite. The field is single-line, and the source specifies no minimum or maximum length or list of allowed URLs. The node sends a JSON request containing messages and expects a response with choices[0].message.content. It does not add an authorization header.
ref_images
Optional IMAGE input for visual references to include with your prompt. When connected, the node converts each image it receives into a PNG and sends it to the chat-completions endpoint as an inline image alongside your text. This can help the service describe referenced visual content, provided that endpoint accepts image content. The images serve as references for rewriting; this node does not use them to generate video. There is no default image, and the source specifies no minimum or maximum image count. The conversion expects image data that can be saved as RGB.
extra_start_note
Optional single-line STRING added near the beginning of the instructions sent to the service. Use it for a concise additional requirement that should guide the rewrite, such as a constraint on how to describe the scene. It is inserted directly before the node’s built-in guide, so clear wording and a trailing space or punctuation can make the combined instruction easier to read. When omitted, no note is added. No default text, minimum length, or maximum length is specified.
extra_end_note
Optional single-line STRING added as a final bullet in the instructions sent to the service. Use it for a specific finishing constraint, such as a reminder to preserve a detail from your concept. When omitted, no final bullet is added. No default text, minimum length, or maximum length is specified.
H3 Ref2V Enhancer Output Parameters:
improved_prompt
STRING containing the text returned by the connected chat-completions service as its first choice’s message content. The node’s instructions ask that service to produce a full-reference rewrite with subject_definitions, summary, retention_analysis, detailed_description, overall_soundscape, and non_diegetic_music sections. Treat this output as a proposed prompt to review before video generation: the node returns the service’s text without checking that every requested section is present or that its descriptions accurately match your references.
H3 Ref2V Enhancer Usage Tips:
- Start with the action and intended duration, then add any essential visual, dialogue, and sound details. If exact spoken words or visible text matter, include them explicitly so the rewrite has the wording to preserve.
- Connect
ref_imageswhen appearance or composition matters, and explain ininitial_promptwhat each image is meant to guide. An image reference alone does not tell the service whether you intend it as a character reference, scene reference, or target frame. - Confirm that
llm_urlpoints to a running service that accepts chat messages with inlineimage_urlcontent before usingref_images. The default address refers to a service on the node’s local machine; the node does not start that service. - Use
extra_start_noteorextra_end_notefor short, task-specific constraints. Reviewimproved_promptafterward, particularly its reference labels and any claims about audio or video assets, because this node supplies images and text but does not itself attach audio or video files.
H3 Ref2V Enhancer Common Errors and Solutions:
ConnectionRefusedError or a connection error mentioning localhost:8080
- Explanation: The node could not connect to the endpoint in
llm_url. With the default address, a common cause is that no service is listening on port 8080. - Solution: Start your compatible chat-completions service, confirm its address and port, and update
llm_urlif it runs elsewhere.
A timeout error after waiting for the response
- Explanation: The request did not complete within the node’s 600-second timeout. A busy service or large reference images can contribute to a slow request.
- Solution: Check that the service is responding, try a request without images to isolate the issue, and reduce image size or service load where practical.
JSONDecodeError while reading the response
- Explanation: The endpoint returned content that could not be parsed as JSON, such as an HTML error page or an empty response. The node attempts to parse the response without first checking its HTTP status.
- Solution: Verify the endpoint path and inspect the service’s response or logs. It must return JSON in the expected chat-completions format.
KeyError: 'choices', KeyError: 'message', or KeyError: 'content'
- Explanation: The response was JSON, but it did not contain the fields the node reads at
choices[0].message.content. This can also happen when the service returns a JSON error instead of a completion. - Solution: Check the endpoint’s response and service logs. Use a compatible endpoint and resolve any reported request errors.
IndexError: list index out of range
- Explanation: The response contained an empty
choiceslist, but the node tries to read its first item. - Solution: Check why the service returned no completion and confirm that it produces at least one choice for this request.
An image conversion error mentioning RGB or array shape
- Explanation: The node converts each reference image to an RGB PNG. An image with an incompatible shape or channel layout may fail during that conversion.
- Solution: Supply a standard RGB image through
ref_imagesand test again with one image before adding more.
The service rejects the request or returns an authentication error
- Explanation: The node sends JSON containing
messagesbut does not supply an authorization header. Some endpoints also reject inline image content or require a different request body. - Solution: Use an endpoint compatible with this request format and its authentication setup. If your service requires fields or headers the node does not send, the node source would need to be changed.
The rewrite is incomplete or does not follow the requested format
- Explanation: The node instructs the service to use a six-section format, but it does not validate or repair the returned text.
- Solution: Review
improved_promptbefore using it. Makeinitial_promptmore specific, simplify conflicting notes, and check whether the connected service can reliably follow the supplied instructions.
