OptionalcontextOptionalcontrolControlNet model parameters
OptionaldisableNSFWFilterDisable NSFW filter for Project. Default is false, meaning NSFW filter is enabled. If image triggers NSFW filter, it will not be available for download.
OptionalguidanceGuidance scale. For most Stable Diffusion models, optimal value is 7.5.
For video models: Regular models range 0.7-8.0, LoRA version (lightx2v) range 0.7-1.6, step 0.01.
This maps to guidanceScale in the keyFrame for both image and video models.
OptionalheightOutput image height. Only used if sizePreset is "custom"
OptionallorasArray of LoRA IDs to apply. Available LoRAs are model-specific. The worker will download the LoRA if not already present on the persistent volume. LoRA IDs are resolved to filenames via the worker config API. Example: ['multiple_angles']
OptionalloraArray of LoRA strengths corresponding to each LoRA in the loras array. Values should be between 0.0 and 2.0. Defaults to 1.0 if not specified. Example: [0.9]
ID of the model to use, available models are available in the availableModels property of the ProjectsApi instance.
OptionalnegativePrompt for what to be avoided. If not provided, server default is used.
OptionalnetworkOverride current network type. Default value can be read from sogni.account.currentAccount.network
Number of media files to generate. Depending on project type, this can be number of images or number of videos.
OptionalnumberNumber of previews to generate. Note that previews affect project cost
OptionaloutputOutput format. Can be 'png' or 'jpg'. Defaults to 'png'.
Prompt for what to be created
OptionalsamplerSampler, available options depend on the model. Use sogni.projects.getModelOptions(modelId)
to get the list of available samplers.
OptionalschedulerScheduler, available options depend on the model. Use sogni.projects.getModelOptions(modelId)
to get the list of available schedulers.
OptionalseedSeed for one of images in project. Other will get random seed. Must be Uint32
OptionalsizeSize preset ID to use. You can query available size presets
from sogni.projects.sizePresets(network, modelId)
OptionalstartingStarting image for img2img workflows.
Supported types:
File - file object from input[type=file]
Buffer - Node.js buffer object with image data
Blob - blob object with image data
true - indicates that the image is already uploaded to the server
OptionalstartingHow strong effect of starting image should be. From 0 to 1, default 0.5
OptionalstepsNumber of steps. For most Stable Diffusion models, optimal value is 20.
OptionalstyleImage style prompt. If not provided, server default is used.
OptionaltokenSelect which tokens to use for the project. If not specified, the Sogni token will be used.
OptionalwidthOutput image width. Only used if sizePreset is "custom"
Context images for multi-reference image generation. Flux.2 Dev supports up to 6 context images. Qwen Image Edit Plus supports up to 3 context images. Flux Kontext supports up to 2 context images.