Interface BaseProjectParams

Optional client app/source label to attach to the project request for server-side attribution.

Optional workload attribution for this project. Fields override the immutable defaults configured on SogniClient.

Select how eligible jobs should be billed.

• auto: use Unlimited subscription coverage when available, otherwise use tokens.
• subscription: require Unlimited subscription coverage; fail if unavailable.
• tokens: opt out of Unlimited coverage and use Spark/SOGNI tokens.

Requested content-filter policy. The server remains authoritative.

Guidance 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.

LoRA IDs to apply, in the order they should be chained.

Which LoRAs are available depends on the model; the Krea 2 family carries the largest set. Workers download a LoRA on first use, so the first render with an uncached one takes longer to start.

Order is significant. The LoRAs are applied in sequence and the same set in a different order produces a measurably different image, because these models run fp8-quantized and the patches do not commute.

Up to 8 per render. IDs are resolved to filenames by the worker. Example: ['krea2-detail-enhancer', 'krea2-amateur']

Strength for each entry in loras, positionally matched. Defaults to 1.0.

Not restricted to positive values. Most Krea 2 LoRAs are bipolar sliders where a negative strength applies the inverse effect and 0 does nothing - Warm Light warms at 2 and cools at -2. Each LoRA has its own valid range and its author's recommended band; values outside the valid range are clamped server-side, and pushing past the recommended band usually costs detail rather than adding effect.

Example: [3, -2]

ID of the model to use, available models are available in the availableModels property of the ProjectsApi instance.

Prompt for what to be avoided. LTX 2.5, LTX 2.3, and WAN video workflows accept this field; provider workflows such as MiniMax H3 and Seedance do not. If not provided, the server or workflow default is used.

Override 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.

Prompt for what to be created

Seed for one of images in project. Other will get random seed. Must be Uint32

Number of steps. For most Stable Diffusion models, optimal value is 20.

Image style prompt. If not provided, server default is used.

Select which tokens to use for the project. If not specified, the Sogni token will be used.