Interface: ImageGenerationRequest

Defined in: packages/agentos/src/media/images/IImageProvider.ts:140

Properties

aspectRatio?

optional aspectRatio: string

Defined in: packages/agentos/src/media/images/IImageProvider.ts:146

---

background?

optional background: ImageBackground

Defined in: packages/agentos/src/media/images/IImageProvider.ts:148

---

consistencyMode?

optional consistencyMode: "balanced" | "strict" | "loose"

Defined in: packages/agentos/src/media/images/IImageProvider.ts:190

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?

optional faceEmbedding: number[]

Defined in: packages/agentos/src/media/images/IImageProvider.ts:176

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?

optional modalities: ImageModality[]

Defined in: packages/agentos/src/media/images/IImageProvider.ts:143

---

modelId?

optional modelId: string

Defined in: packages/agentos/src/media/images/IImageProvider.ts:141

---

n?

optional n: number

Defined in: packages/agentos/src/media/images/IImageProvider.ts:144

---

negativePrompt?

optional negativePrompt: string

Defined in: packages/agentos/src/media/images/IImageProvider.ts:154

---

outputCompression?

optional outputCompression: number

Defined in: packages/agentos/src/media/images/IImageProvider.ts:150

---

outputFormat?

optional outputFormat: ImageOutputFormat

Defined in: packages/agentos/src/media/images/IImageProvider.ts:149

---

prompt

prompt: string

Defined in: packages/agentos/src/media/images/IImageProvider.ts:142

---

providerOptions?

optional providerOptions: Record<string, unknown> | ImageProviderOptionBag

Defined in: packages/agentos/src/media/images/IImageProvider.ts:155

---

quality?

optional quality: string

Defined in: packages/agentos/src/media/images/IImageProvider.ts:147

---

referenceImageUrl?

optional referenceImageUrl: string

Defined in: packages/agentos/src/media/images/IImageProvider.ts:167

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?

optional responseFormat: ImageResponseFormat

Defined in: packages/agentos/src/media/images/IImageProvider.ts:151

---

seed?

optional seed: number

Defined in: packages/agentos/src/media/images/IImageProvider.ts:153

---

size?

optional size: string

Defined in: packages/agentos/src/media/images/IImageProvider.ts:145

---

userId?

optional userId: string

Defined in: packages/agentos/src/media/images/IImageProvider.ts:152