Interface: ImageGenerationRequest
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:154
Properties
aspectRatio?
optionalaspectRatio:string
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:160
background?
optionalbackground:ImageBackground
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:162
consistencyMode?
optionalconsistencyMode:"balanced"|"strict"|"loose"
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:204
Character consistency mode controlling identity preservation strength.
'strict'— Maximum preservation. Uses Pulid/InstantID. Face guaranteed consistent but output creativity is constrained.'balanced'— Moderate preservation. IP-Adapter strength ~0.6. Good for expression variants where some variation is acceptable.'loose'— Light guidance. Reference influences mood/style but face may drift. Good for "inspired by" generations.
Default
'balanced'
faceEmbedding?
optionalfaceEmbedding:number[]
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:190
Pre-computed 512-dim face embedding vector for drift detection.
When provided alongside referenceImageUrl, the AvatarPipeline
verifies generated face identity via cosine similarity against
this anchor vector.
modalities?
optionalmodalities:ImageModality[]
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:157
modelId?
optionalmodelId:string
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:155
n?
optionaln:number
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:158
negativePrompt?
optionalnegativePrompt:string
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:168
outputCompression?
optionaloutputCompression:number
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:164
outputFormat?
optionaloutputFormat:ImageOutputFormat
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:163
prompt
prompt:
string
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:156
providerOptions?
optionalproviderOptions:Record<string,unknown> |ImageProviderOptionBag
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:169
quality?
optionalquality:string
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:161
referenceImageUrl?
optionalreferenceImageUrl:string
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:181
Reference image URL or data URI for character/face consistency.
Providers that support identity preservation map this to model-specific inputs:
- Replicate (Pulid):
main_face_image - Replicate (Flux Redux):
image - Fal (IP-Adapter):
ip_adapter_image - SD-Local: ControlNet with IP-Adapter preprocessor
- OpenAI/Stability/OpenRouter/BFL: ignored (debug warning logged)
responseFormat?
optionalresponseFormat:ImageResponseFormat
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:165
seed?
optionalseed:number
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:167
size?
optionalsize:string
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:159
userId?
optionaluserId:string
Defined in: packages/agentos/src/io/media/images/IImageProvider.ts:166