Skip to main content
Version: v2

Selena Variete (image variation)

POST 
/v2/studio/artworks/selena-variete

Start a selena-variete generation. Billed to your Studio credits. The result arrives by webhook or polling.

Request​

Body

required

    imageUrl urirequired

    URL of the source image to process.

    model string

    Possible values: [Sun, Moon]

    Selena model variant (Sun / Moon). Optional — when omitted, the artwork is generated with both models. Mapped to the upstream model id at dispatch time.

    batch integer

    Possible values: >= 1 and <= 2

    Default value: 2

    Number of images to generate per task (1-2). Default 2.

    prompt string

    Default value: cat

    Limited to 256 words; additional content will be truncated.

    negativePrompt string

    Limited to 64 words; additional content will be truncated.

    style string

    Possible values: [default, portraiture, landscape, photographer, analog, car, food, horror, stained-glass, impasto, abstract-ink, illustration, aquarelle, water-cute, sphericute, fairytale, machinart, isometric, logo, abstractpen, lineart, manga, infiny-weave, infiny-pattern, infiny-flow]

    Default value: default

    processingMode stringrequired

    Possible values: [sketch-to-image, reimagine, 3d, ai-rchitect, human-pose, retake]

    Image processing mode that determines how the source image is used.

    promptMode string

    Possible values: [seer, servitor]

    Default value: servitor

    Controls prompt enhancement. SEER enables AI-powered improvement, SERVITOR uses the prompt as-is.

    creativity integer

    Possible values: >= 1 and <= 5

    Default value: 3

    details integer

    Possible values: >= 1 and <= 5

    Default value: 3

    denoising integer

    Possible values: >= 1 and <= 5

    Default value: 3

    Denoising strength from 1 (very subtle) to 5 (extreme). Ignored for sketch-to-image, ai-rchitect, and human-pose modes which always use full generation.

    aspectRatio string

    Possible values: [1:1, 7:9, 2:3, 4:7, 9:16, 9:21, 9:7, 3:2, 7:4, 16:9, 21:9]

    Defaults to a 1:1 ratio (1024 × 1024) if width and height are not specified.

    width integer

    Possible values: >= 256 and <= 2048

    Use aspectRatio instead of custom width and height for better quality. If defined, the total area (width × height) must not exceed 1,478,656 pixels.

    height integer

    Possible values: >= 256 and <= 2048

    Use aspectRatio instead of custom width and height for better quality. If defined, the total area (width × height) must not exceed 1,478,656 pixels.

    nsfw boolean

    Set to true to allow NSFW output. When false (the default), safety negatives are injected into the negative prompt to suppress NSFW content.

    transparentBackground boolean
    colorTone string

    Possible values: [cool, warm, blackAndWhite, pastel, vibrantColors, sepia, mutedColors, neonColors]

    Overall color palette. Prepended to the prompt; flows through SEER improvement.

    seed integer

    Possible values: >= 1 and <= 2147483647

    Optional random seed for deterministic generation. Range: 1-2147483647.

    outputFormat string

    Possible values: [auto, png, webp]

    Default value: auto

    Output image format. auto lets the provider pick. Supported: auto, png, webp.

    webhook uri

    Optional HTTPS callback URL. Receives a signed delivery when the artwork finalizes.

Responses​

Accepted — generation queued.

Schema

    id string

    Artwork id. Poll GET /studio/artworks/{id} or await the webhook.

Loading...