Skip to main content
Version: V2

Quantum

POST 
/v2/artworks/quantum

Kick off a text-to-image generation with the Quantum model. Returns a task ID you can poll, or wire a webhook to get notified when the image is ready.

Request​

Body

required

    prompt string

    Limited to 200 words; additional content will be truncated. If empty, uses the style's default prompt.

    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, tengrai-anime, folktale]

    The style to apply to the generated image.

    promptMode string

    Possible values: [seer, servitor]

    Default value: servitor

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

    aspectRatio string

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

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

    width integer

    Possible values: >= 512 and <= 1360

    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 (e.g., 1216 × 1216).

    height integer

    Possible values: >= 512 and <= 1360

    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 (e.g., 1216 × 1216).

    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
    seed integer

    Possible values: >= 1 and <= 2147483647

    Optional random seed for deterministic generation. The Tengrai pipeline applies a deterministic transform (floor(seed * 1.2) + 17) before submitting to the workflow engine. Range: 1-2147483647. Omit to let the server pick a random seed.

    webhook uri

    Optional webhook URL. When provided, the server will POST the final artwork result to this URL upon completion. Must be HTTPS and a publicly routable host — loopback, link-local, private, and cloud-metadata addresses are rejected.

    outputFormat string

    Possible values: [auto, png, webp]

    Default value: auto

    Output image format. auto (the default) uses the server default (webp with high-quality settings); png is lossless; webp is equivalent to auto.

Responses​

Response indicating that the artwork was successfully created.

Schema

    id uuidrequired
    artworkType stringrequired

    Possible values: [quantum]

    parameters

    object

    required

    prompt string

    Limited to 200 words; additional content will be truncated. If empty, uses the style's default prompt.

    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, tengrai-anime, folktale]

    The style to apply to the generated image.

    promptMode string

    Possible values: [seer, servitor]

    Default value: servitor

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

    aspectRatio string

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

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

    width integer

    Possible values: >= 512 and <= 1360

    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 (e.g., 1216 × 1216).

    height integer

    Possible values: >= 512 and <= 1360

    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 (e.g., 1216 × 1216).

    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
    seed integer

    Possible values: >= 1 and <= 2147483647

    Optional random seed for deterministic generation. The Tengrai pipeline applies a deterministic transform (floor(seed * 1.2) + 17) before submitting to the workflow engine. Range: 1-2147483647. Omit to let the server pick a random seed.

    webhook uri

    Optional webhook URL. When provided, the server will POST the final artwork result to this URL upon completion. Must be HTTPS and a publicly routable host — loopback, link-local, private, and cloud-metadata addresses are rejected.

    outputFormat string

    Possible values: [auto, png, webp]

    Default value: auto

    Output image format. auto (the default) uses the server default (webp with high-quality settings); png is lossless; webp is equivalent to auto.

    duration numberrequired
    results string[]required
    status stringrequired

    Possible values: [starting, processing, succeeded, failed, canceled]

    createdAt date-timerequired
Loading...