Skip to main content
Version: V2

Find artwork by ID

GET 
/v2/artworks/:id

Fetch a single artwork by its ID. Useful when polling a task you started earlier or looking up the result of a webhook callback.

Request​

Path Parameters

    id stringrequired

Responses​

Schema

    oneOf

    id uuidrequired
    artworkType stringrequired

    Possible values: [selena]

    parameters

    object

    required

    model string

    Possible values: [tengrai-20231128-m-d.safetensors, tengrai-20240423-m-f.safetensors]

    batch integer

    Possible values: >= 1 and <= 2

    Default value: 2

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

    promptMode string

    Possible values: [seer, servitor]

    Default value: servitor

    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

    creativity integer

    Possible values: >= 1 and <= 5

    Default value: 3

    details integer

    Possible values: >= 1 and <= 5

    Default value: 3

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

    height integer

    Possible values: >= 512 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 (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
    colorTone string

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

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

    cameraAngle string

    Possible values: [closeUp, eyeLevel, lowAngle, highAngle, wormsEye, birdsEye, fishEye, aerialView, dutchAngle, firstPersonView]

    Camera framing/perspective. Prepended to the prompt; flows through SEER improvement.

    webhook uri

    Optional webhook URL. When provided, the server will POST the final artwork result to this URL upon completion.

    duration numberrequired
    results string[]required
    status stringrequired

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

    createdAt date-timerequired
Loading...