Floyo FLUX.2 Flex Image Edit:
Flux2FlexImageEdit uses FLUX.2 [flex] to create an edited image from an existing image and a written instruction. You can guide the edit with additional reference images and adjust how strongly the result follows your instruction, how many inference steps the service uses, and the requested image size. The node sends the edit request to the configured FLUX.2 [flex] service, then retrieves the generated image for use in your workflow.
Floyo FLUX.2 Flex Image Edit Input Parameters:
prompt
The written instruction describing the edit you want. This is a required, multiline text field with an empty-string default; the node does not specify a minimum or maximum length. Describe the desired change clearly, such as “Change the jacket to red while keeping the pose and background.” The prompt is sent to the editing service, so its wording helps guide the result.
input_image
The required IMAGE that serves as the base for the edit. Connect the image you want to change here. It has no default, minimum, or maximum value. The node must be able to convert this image before it can submit an edit request.
input_image_2
An optional IMAGE reference, identified as reference #2. Use it to provide additional visual material for the edit request. It has no default, minimum, or maximum value; when left unconnected, it is omitted as an image reference.
input_image_3
An optional IMAGE reference, identified as reference #3. Connect it when you need another visual example alongside the base image and any earlier references. It has no default, minimum, or maximum value; leaving it unconnected does not prevent the node from running.
input_image_4
An optional IMAGE reference, identified as reference #4. It gives the editing service another image to consider with your prompt. It has no default, minimum, or maximum value and can be left unconnected.
input_image_5
An optional IMAGE reference, identified as reference #5. Use it when an additional visual example is useful to your edit. It has no default, minimum, or maximum value and is not required.
input_image_6
An optional IMAGE reference, identified as reference #6. It can contribute another image to the reference set sent with the edit request. It has no default, minimum, or maximum value and can be left unconnected.
input_image_7
An optional IMAGE reference, identified as reference #7. Connect it to supply further visual material for the edit. It has no default, minimum, or maximum value and is optional.
input_image_8
An optional IMAGE reference, identified as reference #8. It provides another possible visual reference in addition to the base image. It has no default, minimum, or maximum value and can be left unconnected.
input_image_9
An optional IMAGE reference, identified as reference #9. Use it when the edit calls for another reference image. It has no default, minimum, or maximum value and is not needed for a basic edit.
input_image_10
An optional IMAGE reference, identified as reference #10 and the final image input offered by this node. It can provide additional visual material for the request. It has no default, minimum, or maximum value and can be left unconnected.
width
The requested output width in pixels. The default is 1024; the interface allows 0 through 2048 in steps of 16. A value of 0 leaves the width unspecified in the request, as indicated by the “0 = keep” tooltip; the node itself does not guarantee the final width in that case. Any positive value must be a multiple of 16 and between 64 and 2048 pixels, or the node returns a validation error. Setting a width changes the requested image dimensions and may affect the composition.
height
The requested output height in pixels. The default is 1024; the interface allows 0 through 2048 in steps of 16. A value of 0 leaves the height unspecified in the request, as indicated by the “0 = keep” tooltip; the node itself does not guarantee the final height in that case. Any positive value must be a multiple of 16 and between 64 and 2048 pixels, or the node returns a validation error. Set width and height together when you need a particular requested aspect ratio.
guidance
Controls the requested degree of prompt adherence. The default is 4.5, with an interface range of 1.5 to 10.0 in steps of 0.1. Use the default as a starting point, then adjust it when you want to test how strongly the service follows your written instruction. The source does not define a guaranteed visual effect for any particular value.
steps
The number of inference steps requested from the editing service. The default is 50, with an interface range of 1 to 50 in steps of 1. This setting is sent with the request; the node source does not establish a particular quality or speed outcome for a given step count. Compare results in your workflow if you change it.
seed
The seed sent with the edit request. The default and minimum are -1, and the maximum is 4,294,967,295. A value of -1 tells the node not to specify a seed, allowing the service to choose one; a nonnegative value is sent to support repeatable requests. Keeping the seed and other settings unchanged is useful when comparing edits, although the node does not guarantee identical results.
safety_tolerance
The requested moderation level, with a default of 2 and an interface range of 0 to 6. The tooltip describes 0 as strict and 6 as permissive. This value is sent to the service; it does not guarantee that a particular request will be accepted. Adjust it only as appropriate for the content you are creating and the service’s rules.
output_format
The requested format of the generated image. The available options are jpeg and png, with jpeg as the default. Choose the format appropriate for your downstream workflow. The node still presents the downloaded result through an IMAGE output rather than as a file path.
Floyo FLUX.2 Flex Image Edit Output Parameters:
image
The edited result as an IMAGE that you can connect to other image-processing or display nodes. On a successful request, the node downloads the image identified in the service response and converts it to an image tensor. If the response lacks an image URL, or another exception occurs, it returns a blank image instead. For certain validation failures, the implementation returns an error string in this output position despite the declared IMAGE type; check the node message if a downstream image connection cannot process the result.
Floyo FLUX.2 Flex Image Edit Usage Tips:
- Start with a clear prompt that names the change you want and the elements you want retained. For example: “Replace the blue coat with a green coat; keep the person’s pose and the background.”
- Connect the image you intend to edit to
input_image. Add optional references only when they provide useful visual context, and explain their intended role in the prompt rather than assuming the service will infer it. - Use the default 1024 × 1024 request as a starting point. For another size, enter positive width and height values that are multiples of 16 and fall between 64 and 2048 pixels; use 0 for a dimension only when you want to leave that dimension unspecified in the request.
- Keep a nonnegative
seedfixed while testing changes toprompt,guidance, orsteps. Change one setting at a time so you can assess its effect; use -1 when you do not need to specify a seed. - Choose
pngwhen that format better suits later processing, or retain the defaultjpegotherwise. This setting requests the generated format but does not change the output socket from IMAGE.
Floyo FLUX.2 Flex Image Edit Common Errors and Solutions:
Error: width must be a multiple of 16 (got N).
- Explanation: A positive requested width is not divisible by 16.
Nrepresents the value entered. - Solution: Choose a width such as 1024 or 1536, or set it to 0 to leave the width unspecified.
Error: height must be a multiple of 16 (got N).
- Explanation: A positive requested height is not divisible by 16. - Solution: Choose a height that is a multiple of 16, or set it to 0 to leave the height unspecified.
Error: width must be between 64 and 2048 pixels (got N).
- Explanation: A positive width outside the supported range passed the multiple-of-16 check but failed the size check.
- Solution: Set a positive width from 64 through 2048 pixels that is also a multiple of 16, or use 0.
Error: height must be between 64 and 2048 pixels (got N).
- Explanation: A positive height outside the supported range passed the multiple-of-16 check but failed the size check.
- Solution: Set a positive height from 64 through 2048 pixels that is also a multiple of 16, or use 0.
Error: Provide a base image.
- Explanation: The node could not obtain a usable converted image from
input_image. A missing image or a failed conversion can lead to this message. - Solution: Connect a valid IMAGE to
input_imageand confirm the upstream node produces an image. If one is connected, inspect the conversion warning in the execution log.
Warning: failed to convert image tensor to base64: ...
- Explanation: An image could not be prepared for the request. For the base image, this can lead to “Error: Provide a base image.” For an optional reference, that reference is left out of the prepared image values.
- Solution: Check that the affected connection supplies a valid IMAGE. Disconnect or replace an optional reference that repeatedly triggers the warning.
Error: FLUX.2 flex response did not include an image URL.
- Explanation: The service response did not contain the
sampleimage URL expected by the node, so the node returned a blank image. - Solution: Check the service response and its status in your logs, then retry the request. If it persists, verify the configured service is responding with the expected result.
Error editing with FLUX.2 flex: ...
- Explanation: An exception occurred while preparing the request, contacting the configured service, or downloading the result. The text after the colon contains the specific exception, and the node returns a blank image.
- Solution: Read the full logged message to identify the failing step. Check the service configuration and connection if the request failed, or the returned image URL if downloading failed, then retry after addressing that cause.
