post-txt2img-ip-adapter-inferences
Generate images from text prompts using a reference image to guide style or character consistency in the Scenario.com MCP Server.
Instructions
Trigger a new image generation in Txt2Img mode with one IpAdapter reference image that guides the generation process.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| originalAssets | No | If set to true, returns the original asset without transformation | |
| dryRun | No | ||
| ipAdapterImageIds | No | ||
| ipAdapterImageId | No | Deprecated for type txt2img-ip-adapter and img2img-ip-adapter, use `ipAdapterImageIds` instead. The IpAdapter image as an AssetId. Cannot be set if `ipAdapterImage` is provided. Will be ignored if the `ipAdapterImageIds` parameter is provided. | |
| ipAdapterScale | No | Deprecated for type txt2img-ip-adapter and img2img-ip-adapter, use `ipAdapterScales` instead. IpAdapter scale factor (within [0.0, 1.0], default: 0.9). Will be ignored if the `ipAdapterScales` parameter is provided | |
| seed | No | Used to reproduce previous results. Default: randomly generated number. | |
| modelId | Yes | The model id to use for the inference | |
| ipAdapterType | No | The type of IP Adapter model to use. Must be one of [`style`, `character`], default to `style`` | |
| modelEpoch | No | The epoch of the model to use for the inference. Only available for Flux Lora Trained models. | |
| hideResults | No | If set, generated assets will be hidden and not returned in the list of images of the inference or when listing assets (default: false) | |
| aspectRatio | No | The aspect ratio of the generated images. Only used for the model flux.1.1-pro-ultra. The aspect ratio is a string formatted as "width:height" (example: "16:9"). | |
| ipAdapterScales | No | ||
| ipAdapterImage | No | Deprecated for type txt2img-ip-adapter and img2img-ip-adapter, use `ipAdapterImages` instead. The IpAdapter image as a data url. Will be ignored if the `ipAdapterImages` parameter is provided. | |
| negativePrompt | No | The prompt not to guide the image generation, ignored when guidance < 1 (example: "((ugly face))") For Flux based model (not Fast-Flux): requires negativePromptStrength > 0 and active only for inference types txt2img / img2img / controlnet. | |
| scheduler | No | The scheduler to use to override the default configured for the model. See detailed documentation for more details. | |
| intermediateImages | No | Enable or disable the intermediate images generation (default: false) | |
| concepts | No | ||
| guidance | No | Controls how closely the generated image follows the prompt. Higher values result in stronger adherence to the prompt. Default and allowed values depend on the model type: - For Flux dev models, the default is 3.5 and allowed values are within [0, 10] - For Flux pro models, the default is 3 and allowed values are within [2, 5] - For SDXL models, the default is 6 and allowed values are within [0, 20] - For SD1.5 models, the default is 7.5 and allowed values are within [0, 20] | |
| numInferenceSteps | No | The number of denoising steps for each image generation (within [1, 150], default: 30) | |
| numSamples | No | The number of images to generate (within [1, 128], default: 4) | |
| ipAdapterImages | No | ||
| width | No | The width of the generated images, must be a 8 multiple (within [64, 2048], default: 512) If model.type is `sd-xl`, `sd-xl-lora`, `sd-xl-composition` the width must be within [512, 2048] If model.type is `sd-1_5`, the width must be within [64, 1024] If model.type is `flux.1.1-pro-ultra`, you can use the aspectRatio parameter instead | |
| negativePromptStrength | No | Only applicable for flux-dev based models for `txt2img`, `img2img`, and `controlnet` inference types. Controls the influence of the negative prompt. Default 0 means the negative prompt has no effect. Higher values increase negative prompt influence. Must be > 0 if negativePrompt is provided. | |
| baseModelId | No | The base model to use for the inference. Only Flux LoRA models can use this parameter. Allowed values are available in the model's attribute: `compliantModelIds` | |
| prompt | Yes | Full text prompt including the model placeholder. (example: "an illustration of phoenix in a fantasy world, flying over a mountain, 8k, bokeh effect") | |
| height | No | The height of the generated images, must be a 8 multiple (within [64, 2048], default: 512) If model.type is `sd-xl`, `sd-xl-lora`, `sd-xl-composition` the height must be within [512, 2048] If model.type is `sd-1_5`, the height must be within [64, 1024] If model.type is `flux.1.1-pro-ultra`, you can use the aspectRatio parameter instead |