Generate Image Node

G

AI/Generative/Image

Generates one image with an existing provider Bit and writes it to FlowPath.

ai_image_generatemediaLong running

Inputs5

Outputs4

Security exposure5/10

Packagemedia

Ratings

Scores range from 0 to 10. Higher values mean more impact, exposure, or operational weight.

SecurityAttack surface and exposure impact.

5/10Medium

PrivacyPotential sensitivity of processed data.

4/10Medium

PerformanceRuntime or resource pressure.

5/10Medium

GovernancePolicy, audit, or compliance impact.

6/10Medium

ReliabilityOperational stability considerations.

6/10Medium

CostExternal or compute cost impact.

3/10Low

Input Pins

5

Input

Execution

exec_in

Trigger image generation

Provider

Struct

provider

Existing provider Bit

SchemaBitBitBit19 fields

idstring

default ""

typeBitTypes

enum "Llm", "Vlm", "Tts", "Stt"...default "Other"

metaMap<string, Metadata>

default {}

*Metadatamap value

namestringrequired

descriptionstringrequired

long_descriptionstring | null

release_notesstring | null

tagsArray<string>required

itemsstringarray item

+11 more fields

authorsArray<string>

default []

itemsstringarray item

repositorystring | null

default null

download_linkstring | null

default null

file_namestring | null

default null

hashstring

default ""

sizeinteger | null

format uint64default nullmin 0

hubstring

default ""

parametersvalue

default null

versionstring | null

default null

licensestring | null

default null

dependenciesArray<string>

default []

itemsstringarray item

dependency_tree_hashstring

default ""

createdstring

default ""

updatedstring

default ""

model_slugstring | null

default null

+1 more fields

Schema enforced

History

Struct

history

Conversation history. The final user message is used as the image prompt.

SchemaHistoryHistoryHistory19 fields

modelstringrequired

messagesArray<HistoryMessage>required

itemsHistoryMessagearray item

roleRolerequired

enum "system", "user", "assistant", "function"...

contentMessageContentrequired

variant 1stringvariant

variant 2Array<Content>variant

namestring | null

tool_callsarray | null

itemsToolCallarray item

tool_call_idstring | null

+1 more fields

presetstring | null

streamboolean | null

stream_optionsanyOf (2)

variant 1StreamOptionsvariant

include_usagebooleanrequired

variant 2nullvariant

max_completion_tokensinteger | null

format uint32min 0

top_pnumber | null

format float

temperaturenumber | null

format float

thinkinganyOf (2)

variant 1HistoryThinkingvariant

enum "off", "low", "mid", "high"

variant 2nullvariant

seedinteger | null

format uint32min 0

presence_penaltynumber | null

format float

frequency_penaltynumber | null

format float

userstring | null

stoparray | null

itemsstringarray item

response_formatanyOf (2)

variant 1ResponseFormatvariant

variant 1stringvariant

variant 2nullvariant

ninteger | null

format uint32min 0

toolsarray | null

itemsToolarray item

typeToolTyperequired

enum "function"

functionHistoryFunctionrequired

namestringrequired

descriptionstring | null

parametersHistoryFunctionParametersrequired

tool_choiceanyOf (2)

variant 1ToolChoicevariant

variant 1nullvariant

variant 2nullvariant

variant 3nullvariant

variant 4objectvariant

typeToolTyperequired

enum "function"

functionHistoryFunctionrequired

variant 2nullvariant

+1 more fields

Schema enforced

Output Path

Struct

output_path

Destination FlowPath for generated image output

SchemaFlowPathFlowPathFlowPath3 fields

pathstringrequired

store_refstringrequired

cache_store_refstring | null

Schema enforced

Provider Options

Struct

provider_options

Typed provider-specific image options

SchemaImageGenerationProviderOptionsImageGenerationProviderOptionsImageGenerationProviderOptions9 fields

variant 1objectvariant

providerconstrequired

const "default"

variant 2objectvariant

providerconstrequired

const "open_ai"

optionsOpenAiImageOptionsrequired

sizeImageSize

enum "auto", "512x512", "768x768", "1024x1024"...default "auto"

qualityImageQuality

enum "auto", "low", "medium", "high"...default "auto"

output_formatImageOutputFormat

enum "png", "jpeg", "webp"default "png"

backgroundImageBackground

enum "auto", "opaque", "transparent"default "auto"

variant 3objectvariant

providerconstrequired

const "google_imagen"

optionsGoogleImagenImageOptionsrequired

aspect_ratioImageAspectRatio

enum "auto", "1:1", "16:9", "9:16"...default "auto"

negative_promptstring | null

default null

seedinteger | null

format uint64default nullmin 0

output_formatImageOutputFormat

enum "png", "jpeg", "webp"default "png"

variant 4objectvariant

providerconstrequired

const "aws_bedrock"

optionsAwsBedrockImageOptionsrequired

aspect_ratioImageAspectRatio

enum "auto", "1:1", "16:9", "9:16"...default "auto"

sizeImageSize

enum "auto", "512x512", "768x768", "1024x1024"...default "auto"

qualityImageQuality

enum "auto", "low", "medium", "high"...default "auto"

negative_promptstring | null

default null

seedinteger | null

format uint64default nullmin 0

+1 more fields

variant 5objectvariant

providerconstrequired

const "xai"

optionsXaiImageOptionsrequired

aspect_ratioImageAspectRatio

enum "auto", "1:1", "16:9", "9:16"...default "auto"

variant 6objectvariant

providerconstrequired

const "together"

optionsTogetherImageOptionsrequired

aspect_ratioImageAspectRatio

enum "auto", "1:1", "16:9", "9:16"...default "auto"

sizeImageSize

enum "auto", "512x512", "768x768", "1024x1024"...default "auto"

negative_promptstring | null

default null

seedinteger | null

format uint64default nullmin 0

output_formatImageOutputFormat

enum "png", "jpeg", "webp"default "png"

variant 7objectvariant

providerconstrequired

const "hugging_face"

optionsHuggingFaceImageOptionsrequired

sizeImageSize

enum "auto", "512x512", "768x768", "1024x1024"...default "auto"

negative_promptstring | null

default null

seedinteger | null

format uint64default nullmin 0

output_formatImageOutputFormat

enum "png", "jpeg", "webp"default "png"

variant 8objectvariant

providerconstrequired

const "open_router"

optionsOpenRouterImageOptionsrequired

aspect_ratioImageAspectRatio

enum "auto", "1:1", "16:9", "9:16"...default "auto"

sizeImageSize

enum "auto", "512x512", "768x768", "1024x1024"...default "auto"

variant 9objectvariant

providerconstrequired

const "stable_diffusion"

optionsStableDiffusionImageOptionsrequired

Sampling controls for an image generated by stable-diffusion.cpp.

widthinteger:uint32

format uint32default 512min 0

heightinteger:uint32

format uint32default 512min 0

stepsinteger:uint32

format uint32default 20min 0

cfg_scalenumber:double

format doubledefault 7

negative_promptstring | null

default null

+3 more fields

Default {"provider":"default"}

Schema enforced

Output Pins

4

Output

Execution

exec_out

Done

Path

Struct

path

First generated image path

SchemaFlowPathFlowPathFlowPath3 fields

pathstringrequired

store_refstringrequired

cache_store_refstring | null

Paths

Struct Array

paths

All generated image paths

SchemaFlowPathFlowPathFlowPath3 fields

pathstringrequired

store_refstringrequired

cache_store_refstring | null

Metadata

Struct

metadata

Generation metadata

SchemaImageGenerationMetadataImageGenerationMetadataImageGenerationMetadata9 fields

providerstringrequired

Provider that served the request.

modelstringrequired

Model identifier used.

versionstring | null

Model version, when the provider reports one.

countinteger:uintrequired

How many images were produced.

format uintmin 0

requested_countinteger:uintrequired

How many were asked for — a provider may return fewer.

format uintmin 0

output_formatstring | null

Image format that was requested.

system_promptstring | null

System prompt sent alongside the request, when one was set.

provider_optionsvaluerequired

Provider specific options that were applied.

assetsvaluerequired

One entry per produced asset.

Node Info

Internal name

ai_image_generate

Category

AI/Generative/Image

Version

4