Examples
ModelsExpand Collapse
ExampleListResponse object { examples }
examples: array of object { asset, modelId, inferenceId, 2 more }
asset: object { id, authorId, collectionIds, 24 more } Asset generated by the inference
Asset generated by the inference
editCapabilities: array of "DETECTION" or "GENERATIVE_FILL" or "PIXELATE" or 8 moreList of edit capabilities
List of edit capabilities
metadata: object { kind, type, angular, 106 more } Metadata of the asset with some additional information
Metadata of the asset with some additional information
type: "3d-texture" or "3d-texture-albedo" or "3d-texture-metallic" or 72 moreThe type of the asset. Ex: ‘inference-txt2img’ will represent an asset generated from a text to image model
The type of the asset. Ex: ‘inference-txt2img’ will represent an asset generated from a text to image model
How angular is the surface? 0 is like a sphere, 1 is like a mechanical object
The optional aspect ratio given for the generation, only applicable for some models
Int to set between 0 and 255 for the opacity of the background in the result images.
A bounding box around the object of interest, in the format [x1, y1, x2, y2].
Remove small dark spots (i.e. “pepper”) and connect small bright cracks.
The control image already processed by canny detector. Must reference an existing AssetId.
Ensure upscaled tile have the same color histogram as original tile.
concepts: optional array of object { modelId, scale, modelEpoch } Flux Kontext LoRA to style the image.
For Flux Kontext Prompt Editing.
Flux Kontext LoRA to style the image. For Flux Kontext Prompt Editing.
Allow the generation of “hallucinations” during the upscale process, which adds additional details and deviates from the original image. Default: optimized for your preset and style.
Amount of decay in creativity over the upscale process. The lowest the value, the less the creativity will be preserved over the upscale process.
The control image processed by depth estimator. Must reference an existing AssetId.
Determine the scale at which the upscale process works.
- With a small value, the upscale works at the largest scale, resulting in fewer added details and more coherent images. Ideal for portraits, for example.
- With a large value, the upscale works at the smallest scale, resulting in more added details and more hallucinations. Ideal for landscapes, for example.
(info): A small value is slower and more expensive to run.
Apply extra control to the Skybox 360 geometry. The higher the value, the more the 360 geometry will influence the generated skybox image.
Use with caution. Default is adapted to the other parameters.
The input image to process. Must reference an existing AssetId or be a data URL.
Strengthen the similarity to the original image during the upscale. Default: optimized for your preset and style.
imageType: optional "seamfull" or "skybox" or "texture"Preserve the seamless properties of skybox or texture images. Input has to be of same type (seamless).
Preserve the seamless properties of skybox or texture images. Input has to be of same type (seamless).
inputFidelity: optional "high" or "low"When set to high, allows to better preserve details from the input images in the output.
This is especially useful when using images that contain elements like faces or logos that
require accurate preservation in the generated image.
You can provide multiple input images that will all be preserved with high fidelity, but keep
in mind that the first image will be preserved with richer textures and finer details, so if
you include elements such as faces, consider placing them in the first image.
Only available for the gpt-image-1 model.
When set to high, allows to better preserve details from the input images in the output.
This is especially useful when using images that contain elements like faces or logos that
require accurate preservation in the generated image.
You can provide multiple input images that will all be preserved with high fidelity, but keep in mind that the first image will be preserved with richer textures and finer details, so if you include elements such as faces, consider placing them in the first image.
Only available for the gpt-image-1 model.
inputLocation: optional "bottom" or "left" or "middle" or 2 moreLocation of the input image in the output.
Location of the input image in the output.
How polished is the surface? 0 is like a rough surface, 1 is like a mirror
modelType: optional "custom" or "elevenlabs-voice" or "flux.1" or 34 moreThe type of the generator used
The type of the generator used
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.
The number of denoising steps for each image generation.
Override the embeddings of the model. Only your prompt and negativePrompt will be used. Use with caution.
List of points (label, x, y) in the image where label = 0 for background and 1 for object.
How polished is the surface? 0 is like a rough surface, 1 is like a mirror
Increase the fidelity to the prompt during upscale. Default: optimized for your preset and style.
How raised is the surface? 0 is flat like water, 1 is like a very rough rock
The reference images used for the asset generation or editing
Additional refinement steps before scaling.
If scalingFactor == 1, the refinement process will be applied (1 + refinementSteps) times. If scalingFactor > 1, the refinement process will be applied refinementSteps times.
Save a flipbook of the texture. Deactivated when the input texture is larger than 2048x2048px
The seed used to generate this asset. <!> Can be a string or a number in some cases <!>.
How shiny is the surface? 0 is like a matte surface, 1 is like a diamond
Strength for the input image structure preservation
The control image for structure. A canny detector will be applied to this image. Must reference an existing AssetId.
The higher the value the more it will look like the style image(s)
List of style images. Most of the time, only one image is enough. It must be existing AssetIds.
Condition the influence of the style image(s). The higher the value, the more the style images will influence the upscaled image.
Target width for the upscaled image, take priority over scaling factor
A textual description / keywords describing the object of interest.
The owner (project) ID (example: “proj_23tlk332lkht3kl2” or “team_dlkhgs23tlk3hlkth32lkht3kl2” for old teams)
properties: object { size, animationFrameCount, bitrate, 20 more } The properties of the asset, content may depend on the kind of asset returned
The properties of the asset, content may depend on the kind of asset returned
source: "3d23d" or "3d23d:texture" or "3d:texture" or 72 moresource of the asset
source of the asset
The description, it will contain in priority:
- the manual description
- the advanced captioning when the asset is used in training flow
- the automatic captioning
The embedding of the asset when requested.
Only available when an asset can be embedded (ie: not Detection maps)
firstFrame: optional object { assetId, url } The video asset’s first frame.
Contains the assetId and the url of the first frame.
The video asset’s first frame.
Contains the assetId and the url of the first frame.
lastFrame: optional object { assetId, url } The video asset’s last frame.
Contains the assetId and the url of the last frame.
The video asset’s last frame.
Contains the assetId and the url of the last frame.
The original file url.
Contains the url of the original file. without any conversion. Only available for some specific video, audio and threeD assets. Is only specified if the given asset data has been replaced with a new file during the creation of the asset.
The output index of the asset within a job This index is an positive integer that starts at 0 It is used to differentiate between multiple outputs of the same job If the job has only one output, this index is 0
inferenceParameters: optional object { prompt, type, aspectRatio, 36 more } The inference parameters used to generate the asset
The inference parameters used to generate the asset
Full text prompt including the model placeholder. (example: “an illustration of phoenix in a fantasy world, flying over a mountain, 8k, bokeh effect”)
type: "controlnet" or "controlnet_img2img" or "controlnet_inpaint" or 15 moreThe type of inference to use. Example: txt2img, img2img, etc.
Selecting the right type will condition the expected parameters.
Note: if model.type is sd-xl* or sd-1_5*, when using the "inpaint" inference type, Scenario determines the best available baseModel for a given modelId: one of `[“stable-diffusion-inpainting”, “stable-diffusion-xl-1.0-inpainting-0.1”] will be used.
The type of inference to use. Example: txt2img, img2img, etc.
Selecting the right type will condition the expected parameters.
Note: if model.type is sd-xl* or sd-1_5*, when using the "inpaint" inference type, Scenario determines the best available baseModel for a given modelId: one of `[“stable-diffusion-inpainting”, “stable-diffusion-xl-1.0-inpainting-0.1”] will be used.
aspectRatio: optional "16:9" or "1:1" or "21:9" or 8 moreThe 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”).
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”).
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
concepts: optional array of object { modelId, scale, modelEpoch }
Specifies how long the ControlNet guidance should be applied during the inference process.
Only available for Flux.1-dev based models.
The value represents the percentage of total inference steps where the ControlNet guidance is active. For example:
- 1.0: ControlNet guidance is applied during all inference steps
- 0.5: ControlNet guidance is only applied during the first half of inference steps
Default values:
- 0.5 for Canny modality
- 0.6 for all other modalities
Specifies the starting point of the ControlNet guidance during the inference process.
Only available for Flux.1-dev based models.
The value represents the percentage of total inference steps where the ControlNet guidance starts. For example:
- 0.0: ControlNet guidance starts at the beginning of the inference steps
- 0.5: ControlNet guidance starts at the middle of the inference steps
If set to true, the entire input image will likely change during inpainting. This results in faster inferences, but the output image will be harder to integrate if the input is just a small part of a larger image.
If false, the process uses the given image to detect the modality. If true (default), the process will not try to detect the modality of the given image.
For example:
with pose modality and false value, the process will detect the pose of people in the given image
with depth modality and false value, the process will detect the depth of the given image
with scribble modality and truevalue, the process will use the given image as a scribble
⚠️ For models of the FLUX schnell or dev families, this parameter is ignored. The modality detection is always disabled. ⚠️
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]
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
If set, generated assets will be hidden and not returned in the list of images of the inference or when listing assets (default: false)
Enable or disable the intermediate images generation (default: false)
IpAdapter scale factor (within [0.0, 1.0], default: 0.9).
IpAdapter scale factors (within [0.0, 1.0], default: 0.9).
ipAdapterType: optional "character" or "style"The type of IP Adapter model to use. Must be one of [style, character], default to `style“
The type of IP Adapter model to use. Must be one of [style, character], default to `style“
The modality associated with the control image used for the generation: it can either be an object with a combination of maximum
For models of SD1.5 family:
- up to 3 modalities from
canny,pose,depth,lines,seg,scribble,lineart,normal-map,illusion - or one of the following presets:
character,landscape,city,interior.
For models of the SDXL family:
- up to 3 modalities from
canny,pose,depth,seg,illusion,scribble - or one of the following presets:
character,landscape.
For models of the FLUX schnell or dev families:
- one modality from:
canny,tile,depth,blur,pose,gray,low-quality
Optionally, you can associate a value to these modalities or presets. The value must be within ]0.0, 1.0].
Examples:
cannydepth:0.5,pose:1.0canny:0.5,depth:0.5,lines:0.3landscapecharacter:0.5illusion:1
Note: if you use a value that is not supported by the model family, this will result in an error.
The epoch of the model to use for the inference. Only available for Flux Lora Trained models.
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.
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.
The number of denoising steps for each image generation (within [1, 150], default: 30)
The number of images to generate (within [1, 128], default: 4)
Whether to use reference query for self attention’s context Only for “reference” inference type
scheduler: optional "DDIMScheduler" or "DDPMScheduler" or "DEISMultistepScheduler" or 12 moreThe scheduler to use to override the default configured for the model. See detailed documentation for more details.
The scheduler to use to override the default configured for the model. See detailed documentation for more details.
Used to reproduce previous results. Default: randomly generated number.
Controls the noise intensity introduced to the input image, where a value of 1.0 completely erases the original image’s details. Available for img2img and inpainting. (within [0.01, 1.0], default: 0.75)
If style_fidelity=1.0, control more important, else if style_fidelity=0.0, prompt more important, else balanced Only for “reference” inference type
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
job: optional object { createdAt, jobId, jobType, 8 more } The job associated with the asset
The job associated with the asset
jobType: "assets-download" or "canvas-export" or "caption" or 36 moreThe type of job
The type of job
metadata: object { assetIds, error, flow, 6 more } Metadata of the job with some additional information
Metadata of the job with some additional information
flow: optional array of object { id, status, type, 15 more } The flow of the job. Only available for workflow jobs.
The flow of the job. Only available for workflow jobs.
status: "failure" or "pending" or "processing" or 2 moreThe status of the node. Only available for WorkflowJob nodes.
The status of the node. Only available for WorkflowJob nodes.
Fixed number of iterations for a ForEach node.
When set, the loop runs exactly count times regardless of array input.
When not set, the loop iterates over the resolved array input.
Only available for ForEach nodes.
The nodes that this node depends on. Only available for nodes that have dependencies. Mainly used for user approval nodes.
If true, the outputs of this node will be included in the workflow job’s final output.
Only applicable to producing nodes (custom-model, inference, etc.).
By default, only last nodes (nodes not referenced by other nodes) contribute to outputs.
Set this to true to also include intermediate nodes in the final output.
Note: This should only be set to true or left undefined.
inputs: optional array of object { name, type, allowedValues, 26 more } The inputs of the node.
The inputs of the node.
The allowed values for the input. For `string` or `number` types, creates a single-select dropdown. For `string_array` type, creates a multi-select dropdown.
backgroundBehavior: optional "opaque" or "transparent"Specifies the background behavior for the input. Only available for `file` and `file_array`
input types with kind `image`.
Specifies the background behavior for the input. Only available for `file` and `file_array` input types with kind `image`.
Help text displayed in the UI to provide additional information about the input
Used to visually group inputs together in the UI. Inputs with the same group value appear consecutively in the UI.
The list of inputs which form an object within a container array. All inputs are the same as the current object. This is only available for type inputs_array inputs.
items: optional array of array of object { name, type, allowedValues, 25 more } The configured items for inputs_array type inputs.
Each item is an array of SubNodeInput that need ref/value resolution.
Only available for inputs_array type.
The configured items for inputs_array type inputs. Each item is an array of SubNodeInput that need ref/value resolution. Only available for inputs_array type.
The allowed values for the input. For `string` or `number` types, creates a single-select dropdown. For `string_array` type, creates a multi-select dropdown.
backgroundBehavior: optional "opaque" or "transparent"Specifies the background behavior for the input. Only available for `file` and `file_array`
input types with kind `image`.
Specifies the background behavior for the input. Only available for `file` and `file_array` input types with kind `image`.
Help text displayed in the UI to provide additional information about the input
Used to visually group inputs together in the UI. Inputs with the same group value appear consecutively in the UI.
The list of inputs which form an object within a container array. All inputs are the same as the current object. This is only available for type inputs_array inputs.
kind: optional "3d" or "audio" or "document" or 4 moreThe asset kind of the input. Only taken into account for `file` and `file_array` input types.
If model provides multiple kinds,
the input will be not able to create the asset on the flight on API side with dataurl without data:kind, prefix
The asset kind of the input. Only taken into account for `file` and `file_array` input types. If model provides multiple kinds, the input will be not able to create the asset on the flight on API side with dataurl without data:kind, prefix
The maximum allowed length for `string` inputs. Also applies to each item in `string_array`.
The maximum allowed file size in bytes. Only applies to `file` and `file_array` input types. Validated against `asset.properties.size` at job creation time.
The minimum allowed length for string inputs. Also applies to each item in `string_array`.
modelTypes: optional array of "custom" or "elevenlabs-voice" or "flux.1" or 34 moreThe allowed model types for this input. Example: `[“flux.1-lora”]`.
Only available for `model_array` input type.
The allowed model types for this input. Example: `[“flux.1-lora”]`. Only available for `model_array` input type.
Whether this input represents a parent asset to assign to the produced assets. Only available for `file` and `file_array` input types.
For `file_array`, the parent asset is the first item in the array.
Whether the input is a prompt. When true, displays as a text area with prompt spark feature. Only available for `string` input type.
Whether the input is used with prompt spark. Only available for `string` input type.
ref: optional object { conditional, equal, name, node } The reference to another input or output of the same workflow.
Must have at least one of node or conditional.
The reference to another input or output of the same workflow. Must have at least one of node or conditional.
The conditional nodes to reference. If the conditional nodes are successful, the node will be successful. If the conditional nodes are skipped, the node will be skipped. Contains an array of node ids used to check the status of the nodes.
The name of the input or output to reference. If the type is ‘workflow’, the name is the name of the input of the workflow is required If the type is ‘node’, the name is not mandatory, except if you want all outputs of the node. To get all outputs of a node, you can use the name ‘all’.
required: optional object { always, conditionalValues, ifDefined, ifNotDefined } Set of rules that describes when this input is required:
- `always`: Input is always required
- `ifNotDefined`: Input is required when another specified input is not defined
- `ifDefined`: Input is required when another specified input is defined
- `conditionalValues`: Input is required when another input has a specific value
By default, the input is not required.
Set of rules that describes when this input is required:
- `always`: Input is always required
- `ifNotDefined`: Input is required when another specified input is not defined
- `ifDefined`: Input is required when another specified input is defined
- `conditionalValues`: Input is required when another input has a specific value
By default, the input is not required.
Makes this input required when another input has a specific value:
- Key: name of the input to check
- Value: operation and allowed values that trigger the requirement
kind: optional "3d" or "audio" or "document" or 4 moreThe asset kind of the input. Only taken into account for `file` and `file_array` input types.
If model provides multiple kinds,
the input will be not able to create the asset on the flight on API side with dataurl without data:kind, prefix
The asset kind of the input. Only taken into account for `file` and `file_array` input types. If model provides multiple kinds, the input will be not able to create the asset on the flight on API side with dataurl without data:kind, prefix
The maximum allowed length for `string` inputs. Also applies to each item in `string_array`.
The maximum allowed file size in bytes. Only applies to `file` and `file_array` input types. Validated against `asset.properties.size` at job creation time.
The minimum allowed length for string inputs. Also applies to each item in `string_array`.
modelTypes: optional array of "custom" or "elevenlabs-voice" or "flux.1" or 34 moreThe allowed model types for this input. Example: `[“flux.1-lora”]`.
Only available for `model_array` input type.
The allowed model types for this input. Example: `[“flux.1-lora”]`. Only available for `model_array` input type.
Whether this input represents a parent asset to assign to the produced assets. Only available for `file` and `file_array` input types.
For `file_array`, the parent asset is the first item in the array.
Whether the input is a prompt. When true, displays as a text area with prompt spark feature. Only available for `string` input type.
Whether the input is used with prompt spark. Only available for `string` input type.
ref: optional object { conditional, equal, name, node } The reference to another input or output of the same workflow.
Must have at least one of node or conditional.
The reference to another input or output of the same workflow. Must have at least one of node or conditional.
The conditional nodes to reference. If the conditional nodes are successful, the node will be successful. If the conditional nodes are skipped, the node will be skipped. Contains an array of node ids used to check the status of the nodes.
The name of the input or output to reference. If the type is ‘workflow’, the name is the name of the input of the workflow is required If the type is ‘node’, the name is not mandatory, except if you want all outputs of the node. To get all outputs of a node, you can use the name ‘all’.
required: optional object { always, conditionalValues, ifDefined, ifNotDefined } Set of rules that describes when this input is required:
- `always`: Input is always required
- `ifNotDefined`: Input is required when another specified input is not defined
- `ifDefined`: Input is required when another specified input is defined
- `conditionalValues`: Input is required when another input has a specific value
By default, the input is not required.
Set of rules that describes when this input is required:
- `always`: Input is always required
- `ifNotDefined`: Input is required when another specified input is not defined
- `ifDefined`: Input is required when another specified input is defined
- `conditionalValues`: Input is required when another input has a specific value
By default, the input is not required.
Makes this input required when another input has a specific value:
- Key: name of the input to check
- Value: operation and allowed values that trigger the requirement
Statically-configured items for a List node. The node outputs this array as-is when executed. Only available for List nodes. The values can be strings, numbers, or asset IDs.
Zero-based index of the iteration this node copy belongs to. Set on dynamically-created copies of loop body nodes.
If the flow is part of a WorkflowJob, this is the jobId for the node. jobId is only available for nodes started. A node “Pending” for a running workflow job is not started.
logic: optional object { cases, default, transform } The logic of the node.
Only available for logic nodes.
The logic of the node. Only available for logic nodes.
IDs of the body template nodes that belong to this ForEach loop. At runtime these templates are cloned once per iteration and marked Skipped. Only available for ForEach nodes.
statusHistory: array of object { date, status } The history of the different statuses the job went through with the ISO string date
of when the job reached each statuses.
The history of the different statuses the job went through with the ISO string date of when the job reached each statuses.
ExampleUpdateResponse object { examples }
examples: array of object { asset, modelId, inferenceId, 2 more }
asset: object { id, authorId, collectionIds, 24 more } Asset generated by the inference
Asset generated by the inference
editCapabilities: array of "DETECTION" or "GENERATIVE_FILL" or "PIXELATE" or 8 moreList of edit capabilities
List of edit capabilities
metadata: object { kind, type, angular, 106 more } Metadata of the asset with some additional information
Metadata of the asset with some additional information
type: "3d-texture" or "3d-texture-albedo" or "3d-texture-metallic" or 72 moreThe type of the asset. Ex: ‘inference-txt2img’ will represent an asset generated from a text to image model
The type of the asset. Ex: ‘inference-txt2img’ will represent an asset generated from a text to image model
How angular is the surface? 0 is like a sphere, 1 is like a mechanical object
The optional aspect ratio given for the generation, only applicable for some models
Int to set between 0 and 255 for the opacity of the background in the result images.
A bounding box around the object of interest, in the format [x1, y1, x2, y2].
Remove small dark spots (i.e. “pepper”) and connect small bright cracks.
The control image already processed by canny detector. Must reference an existing AssetId.
Ensure upscaled tile have the same color histogram as original tile.
concepts: optional array of object { modelId, scale, modelEpoch } Flux Kontext LoRA to style the image.
For Flux Kontext Prompt Editing.
Flux Kontext LoRA to style the image. For Flux Kontext Prompt Editing.
Allow the generation of “hallucinations” during the upscale process, which adds additional details and deviates from the original image. Default: optimized for your preset and style.
Amount of decay in creativity over the upscale process. The lowest the value, the less the creativity will be preserved over the upscale process.
The control image processed by depth estimator. Must reference an existing AssetId.
Determine the scale at which the upscale process works.
- With a small value, the upscale works at the largest scale, resulting in fewer added details and more coherent images. Ideal for portraits, for example.
- With a large value, the upscale works at the smallest scale, resulting in more added details and more hallucinations. Ideal for landscapes, for example.
(info): A small value is slower and more expensive to run.
Apply extra control to the Skybox 360 geometry. The higher the value, the more the 360 geometry will influence the generated skybox image.
Use with caution. Default is adapted to the other parameters.
The input image to process. Must reference an existing AssetId or be a data URL.
Strengthen the similarity to the original image during the upscale. Default: optimized for your preset and style.
imageType: optional "seamfull" or "skybox" or "texture"Preserve the seamless properties of skybox or texture images. Input has to be of same type (seamless).
Preserve the seamless properties of skybox or texture images. Input has to be of same type (seamless).
inputFidelity: optional "high" or "low"When set to high, allows to better preserve details from the input images in the output.
This is especially useful when using images that contain elements like faces or logos that
require accurate preservation in the generated image.
You can provide multiple input images that will all be preserved with high fidelity, but keep
in mind that the first image will be preserved with richer textures and finer details, so if
you include elements such as faces, consider placing them in the first image.
Only available for the gpt-image-1 model.
When set to high, allows to better preserve details from the input images in the output.
This is especially useful when using images that contain elements like faces or logos that
require accurate preservation in the generated image.
You can provide multiple input images that will all be preserved with high fidelity, but keep in mind that the first image will be preserved with richer textures and finer details, so if you include elements such as faces, consider placing them in the first image.
Only available for the gpt-image-1 model.
inputLocation: optional "bottom" or "left" or "middle" or 2 moreLocation of the input image in the output.
Location of the input image in the output.
How polished is the surface? 0 is like a rough surface, 1 is like a mirror
modelType: optional "custom" or "elevenlabs-voice" or "flux.1" or 34 moreThe type of the generator used
The type of the generator used
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.
The number of denoising steps for each image generation.
Override the embeddings of the model. Only your prompt and negativePrompt will be used. Use with caution.
List of points (label, x, y) in the image where label = 0 for background and 1 for object.
How polished is the surface? 0 is like a rough surface, 1 is like a mirror
Increase the fidelity to the prompt during upscale. Default: optimized for your preset and style.
How raised is the surface? 0 is flat like water, 1 is like a very rough rock
The reference images used for the asset generation or editing
Additional refinement steps before scaling.
If scalingFactor == 1, the refinement process will be applied (1 + refinementSteps) times. If scalingFactor > 1, the refinement process will be applied refinementSteps times.
Save a flipbook of the texture. Deactivated when the input texture is larger than 2048x2048px
The seed used to generate this asset. <!> Can be a string or a number in some cases <!>.
How shiny is the surface? 0 is like a matte surface, 1 is like a diamond
Strength for the input image structure preservation
The control image for structure. A canny detector will be applied to this image. Must reference an existing AssetId.
The higher the value the more it will look like the style image(s)
List of style images. Most of the time, only one image is enough. It must be existing AssetIds.
Condition the influence of the style image(s). The higher the value, the more the style images will influence the upscaled image.
Target width for the upscaled image, take priority over scaling factor
A textual description / keywords describing the object of interest.
The owner (project) ID (example: “proj_23tlk332lkht3kl2” or “team_dlkhgs23tlk3hlkth32lkht3kl2” for old teams)
properties: object { size, animationFrameCount, bitrate, 20 more } The properties of the asset, content may depend on the kind of asset returned
The properties of the asset, content may depend on the kind of asset returned
source: "3d23d" or "3d23d:texture" or "3d:texture" or 72 moresource of the asset
source of the asset
The description, it will contain in priority:
- the manual description
- the advanced captioning when the asset is used in training flow
- the automatic captioning
The embedding of the asset when requested.
Only available when an asset can be embedded (ie: not Detection maps)
firstFrame: optional object { assetId, url } The video asset’s first frame.
Contains the assetId and the url of the first frame.
The video asset’s first frame.
Contains the assetId and the url of the first frame.
lastFrame: optional object { assetId, url } The video asset’s last frame.
Contains the assetId and the url of the last frame.
The video asset’s last frame.
Contains the assetId and the url of the last frame.
The original file url.
Contains the url of the original file. without any conversion. Only available for some specific video, audio and threeD assets. Is only specified if the given asset data has been replaced with a new file during the creation of the asset.
The output index of the asset within a job This index is an positive integer that starts at 0 It is used to differentiate between multiple outputs of the same job If the job has only one output, this index is 0
inferenceParameters: optional object { prompt, type, aspectRatio, 36 more } The inference parameters used to generate the asset
The inference parameters used to generate the asset
Full text prompt including the model placeholder. (example: “an illustration of phoenix in a fantasy world, flying over a mountain, 8k, bokeh effect”)
type: "controlnet" or "controlnet_img2img" or "controlnet_inpaint" or 15 moreThe type of inference to use. Example: txt2img, img2img, etc.
Selecting the right type will condition the expected parameters.
Note: if model.type is sd-xl* or sd-1_5*, when using the "inpaint" inference type, Scenario determines the best available baseModel for a given modelId: one of `[“stable-diffusion-inpainting”, “stable-diffusion-xl-1.0-inpainting-0.1”] will be used.
The type of inference to use. Example: txt2img, img2img, etc.
Selecting the right type will condition the expected parameters.
Note: if model.type is sd-xl* or sd-1_5*, when using the "inpaint" inference type, Scenario determines the best available baseModel for a given modelId: one of `[“stable-diffusion-inpainting”, “stable-diffusion-xl-1.0-inpainting-0.1”] will be used.
aspectRatio: optional "16:9" or "1:1" or "21:9" or 8 moreThe 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”).
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”).
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
concepts: optional array of object { modelId, scale, modelEpoch }
Specifies how long the ControlNet guidance should be applied during the inference process.
Only available for Flux.1-dev based models.
The value represents the percentage of total inference steps where the ControlNet guidance is active. For example:
- 1.0: ControlNet guidance is applied during all inference steps
- 0.5: ControlNet guidance is only applied during the first half of inference steps
Default values:
- 0.5 for Canny modality
- 0.6 for all other modalities
Specifies the starting point of the ControlNet guidance during the inference process.
Only available for Flux.1-dev based models.
The value represents the percentage of total inference steps where the ControlNet guidance starts. For example:
- 0.0: ControlNet guidance starts at the beginning of the inference steps
- 0.5: ControlNet guidance starts at the middle of the inference steps
If set to true, the entire input image will likely change during inpainting. This results in faster inferences, but the output image will be harder to integrate if the input is just a small part of a larger image.
If false, the process uses the given image to detect the modality. If true (default), the process will not try to detect the modality of the given image.
For example:
with pose modality and false value, the process will detect the pose of people in the given image
with depth modality and false value, the process will detect the depth of the given image
with scribble modality and truevalue, the process will use the given image as a scribble
⚠️ For models of the FLUX schnell or dev families, this parameter is ignored. The modality detection is always disabled. ⚠️
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]
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
If set, generated assets will be hidden and not returned in the list of images of the inference or when listing assets (default: false)
Enable or disable the intermediate images generation (default: false)
IpAdapter scale factor (within [0.0, 1.0], default: 0.9).
IpAdapter scale factors (within [0.0, 1.0], default: 0.9).
ipAdapterType: optional "character" or "style"The type of IP Adapter model to use. Must be one of [style, character], default to `style“
The type of IP Adapter model to use. Must be one of [style, character], default to `style“
The modality associated with the control image used for the generation: it can either be an object with a combination of maximum
For models of SD1.5 family:
- up to 3 modalities from
canny,pose,depth,lines,seg,scribble,lineart,normal-map,illusion - or one of the following presets:
character,landscape,city,interior.
For models of the SDXL family:
- up to 3 modalities from
canny,pose,depth,seg,illusion,scribble - or one of the following presets:
character,landscape.
For models of the FLUX schnell or dev families:
- one modality from:
canny,tile,depth,blur,pose,gray,low-quality
Optionally, you can associate a value to these modalities or presets. The value must be within ]0.0, 1.0].
Examples:
cannydepth:0.5,pose:1.0canny:0.5,depth:0.5,lines:0.3landscapecharacter:0.5illusion:1
Note: if you use a value that is not supported by the model family, this will result in an error.
The epoch of the model to use for the inference. Only available for Flux Lora Trained models.
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.
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.
The number of denoising steps for each image generation (within [1, 150], default: 30)
The number of images to generate (within [1, 128], default: 4)
Whether to use reference query for self attention’s context Only for “reference” inference type
scheduler: optional "DDIMScheduler" or "DDPMScheduler" or "DEISMultistepScheduler" or 12 moreThe scheduler to use to override the default configured for the model. See detailed documentation for more details.
The scheduler to use to override the default configured for the model. See detailed documentation for more details.
Used to reproduce previous results. Default: randomly generated number.
Controls the noise intensity introduced to the input image, where a value of 1.0 completely erases the original image’s details. Available for img2img and inpainting. (within [0.01, 1.0], default: 0.75)
If style_fidelity=1.0, control more important, else if style_fidelity=0.0, prompt more important, else balanced Only for “reference” inference type
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
job: optional object { createdAt, jobId, jobType, 8 more } The job associated with the asset
The job associated with the asset
jobType: "assets-download" or "canvas-export" or "caption" or 36 moreThe type of job
The type of job
metadata: object { assetIds, error, flow, 6 more } Metadata of the job with some additional information
Metadata of the job with some additional information
flow: optional array of object { id, status, type, 15 more } The flow of the job. Only available for workflow jobs.
The flow of the job. Only available for workflow jobs.
status: "failure" or "pending" or "processing" or 2 moreThe status of the node. Only available for WorkflowJob nodes.
The status of the node. Only available for WorkflowJob nodes.
Fixed number of iterations for a ForEach node.
When set, the loop runs exactly count times regardless of array input.
When not set, the loop iterates over the resolved array input.
Only available for ForEach nodes.
The nodes that this node depends on. Only available for nodes that have dependencies. Mainly used for user approval nodes.
If true, the outputs of this node will be included in the workflow job’s final output.
Only applicable to producing nodes (custom-model, inference, etc.).
By default, only last nodes (nodes not referenced by other nodes) contribute to outputs.
Set this to true to also include intermediate nodes in the final output.
Note: This should only be set to true or left undefined.
inputs: optional array of object { name, type, allowedValues, 26 more } The inputs of the node.
The inputs of the node.
The allowed values for the input. For `string` or `number` types, creates a single-select dropdown. For `string_array` type, creates a multi-select dropdown.
backgroundBehavior: optional "opaque" or "transparent"Specifies the background behavior for the input. Only available for `file` and `file_array`
input types with kind `image`.
Specifies the background behavior for the input. Only available for `file` and `file_array` input types with kind `image`.
Help text displayed in the UI to provide additional information about the input
Used to visually group inputs together in the UI. Inputs with the same group value appear consecutively in the UI.
The list of inputs which form an object within a container array. All inputs are the same as the current object. This is only available for type inputs_array inputs.
items: optional array of array of object { name, type, allowedValues, 25 more } The configured items for inputs_array type inputs.
Each item is an array of SubNodeInput that need ref/value resolution.
Only available for inputs_array type.
The configured items for inputs_array type inputs. Each item is an array of SubNodeInput that need ref/value resolution. Only available for inputs_array type.
The allowed values for the input. For `string` or `number` types, creates a single-select dropdown. For `string_array` type, creates a multi-select dropdown.
backgroundBehavior: optional "opaque" or "transparent"Specifies the background behavior for the input. Only available for `file` and `file_array`
input types with kind `image`.
Specifies the background behavior for the input. Only available for `file` and `file_array` input types with kind `image`.
Help text displayed in the UI to provide additional information about the input
Used to visually group inputs together in the UI. Inputs with the same group value appear consecutively in the UI.
The list of inputs which form an object within a container array. All inputs are the same as the current object. This is only available for type inputs_array inputs.
kind: optional "3d" or "audio" or "document" or 4 moreThe asset kind of the input. Only taken into account for `file` and `file_array` input types.
If model provides multiple kinds,
the input will be not able to create the asset on the flight on API side with dataurl without data:kind, prefix
The asset kind of the input. Only taken into account for `file` and `file_array` input types. If model provides multiple kinds, the input will be not able to create the asset on the flight on API side with dataurl without data:kind, prefix
The maximum allowed length for `string` inputs. Also applies to each item in `string_array`.
The maximum allowed file size in bytes. Only applies to `file` and `file_array` input types. Validated against `asset.properties.size` at job creation time.
The minimum allowed length for string inputs. Also applies to each item in `string_array`.
modelTypes: optional array of "custom" or "elevenlabs-voice" or "flux.1" or 34 moreThe allowed model types for this input. Example: `[“flux.1-lora”]`.
Only available for `model_array` input type.
The allowed model types for this input. Example: `[“flux.1-lora”]`. Only available for `model_array` input type.
Whether this input represents a parent asset to assign to the produced assets. Only available for `file` and `file_array` input types.
For `file_array`, the parent asset is the first item in the array.
Whether the input is a prompt. When true, displays as a text area with prompt spark feature. Only available for `string` input type.
Whether the input is used with prompt spark. Only available for `string` input type.
ref: optional object { conditional, equal, name, node } The reference to another input or output of the same workflow.
Must have at least one of node or conditional.
The reference to another input or output of the same workflow. Must have at least one of node or conditional.
The conditional nodes to reference. If the conditional nodes are successful, the node will be successful. If the conditional nodes are skipped, the node will be skipped. Contains an array of node ids used to check the status of the nodes.
The name of the input or output to reference. If the type is ‘workflow’, the name is the name of the input of the workflow is required If the type is ‘node’, the name is not mandatory, except if you want all outputs of the node. To get all outputs of a node, you can use the name ‘all’.
required: optional object { always, conditionalValues, ifDefined, ifNotDefined } Set of rules that describes when this input is required:
- `always`: Input is always required
- `ifNotDefined`: Input is required when another specified input is not defined
- `ifDefined`: Input is required when another specified input is defined
- `conditionalValues`: Input is required when another input has a specific value
By default, the input is not required.
Set of rules that describes when this input is required:
- `always`: Input is always required
- `ifNotDefined`: Input is required when another specified input is not defined
- `ifDefined`: Input is required when another specified input is defined
- `conditionalValues`: Input is required when another input has a specific value
By default, the input is not required.
Makes this input required when another input has a specific value:
- Key: name of the input to check
- Value: operation and allowed values that trigger the requirement
kind: optional "3d" or "audio" or "document" or 4 moreThe asset kind of the input. Only taken into account for `file` and `file_array` input types.
If model provides multiple kinds,
the input will be not able to create the asset on the flight on API side with dataurl without data:kind, prefix
The asset kind of the input. Only taken into account for `file` and `file_array` input types. If model provides multiple kinds, the input will be not able to create the asset on the flight on API side with dataurl without data:kind, prefix
The maximum allowed length for `string` inputs. Also applies to each item in `string_array`.
The maximum allowed file size in bytes. Only applies to `file` and `file_array` input types. Validated against `asset.properties.size` at job creation time.
The minimum allowed length for string inputs. Also applies to each item in `string_array`.
modelTypes: optional array of "custom" or "elevenlabs-voice" or "flux.1" or 34 moreThe allowed model types for this input. Example: `[“flux.1-lora”]`.
Only available for `model_array` input type.
The allowed model types for this input. Example: `[“flux.1-lora”]`. Only available for `model_array` input type.
Whether this input represents a parent asset to assign to the produced assets. Only available for `file` and `file_array` input types.
For `file_array`, the parent asset is the first item in the array.
Whether the input is a prompt. When true, displays as a text area with prompt spark feature. Only available for `string` input type.
Whether the input is used with prompt spark. Only available for `string` input type.
ref: optional object { conditional, equal, name, node } The reference to another input or output of the same workflow.
Must have at least one of node or conditional.
The reference to another input or output of the same workflow. Must have at least one of node or conditional.
The conditional nodes to reference. If the conditional nodes are successful, the node will be successful. If the conditional nodes are skipped, the node will be skipped. Contains an array of node ids used to check the status of the nodes.
The name of the input or output to reference. If the type is ‘workflow’, the name is the name of the input of the workflow is required If the type is ‘node’, the name is not mandatory, except if you want all outputs of the node. To get all outputs of a node, you can use the name ‘all’.
required: optional object { always, conditionalValues, ifDefined, ifNotDefined } Set of rules that describes when this input is required:
- `always`: Input is always required
- `ifNotDefined`: Input is required when another specified input is not defined
- `ifDefined`: Input is required when another specified input is defined
- `conditionalValues`: Input is required when another input has a specific value
By default, the input is not required.
Set of rules that describes when this input is required:
- `always`: Input is always required
- `ifNotDefined`: Input is required when another specified input is not defined
- `ifDefined`: Input is required when another specified input is defined
- `conditionalValues`: Input is required when another input has a specific value
By default, the input is not required.
Makes this input required when another input has a specific value:
- Key: name of the input to check
- Value: operation and allowed values that trigger the requirement
Statically-configured items for a List node. The node outputs this array as-is when executed. Only available for List nodes. The values can be strings, numbers, or asset IDs.
Zero-based index of the iteration this node copy belongs to. Set on dynamically-created copies of loop body nodes.
If the flow is part of a WorkflowJob, this is the jobId for the node. jobId is only available for nodes started. A node “Pending” for a running workflow job is not started.
logic: optional object { cases, default, transform } The logic of the node.
Only available for logic nodes.
The logic of the node. Only available for logic nodes.
IDs of the body template nodes that belong to this ForEach loop. At runtime these templates are cloned once per iteration and marked Skipped. Only available for ForEach nodes.
statusHistory: array of object { date, status } The history of the different statuses the job went through with the ISO string date
of when the job reached each statuses.
The history of the different statuses the job went through with the ISO string date of when the job reached each statuses.