Create txt2img artwork

POST 
/v1/artworks/txt2img

Generate artwork using text-to-image (txt2img) conversion.

Request

application/json

Body

required

model string

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

Default value: tengrai-20231128-m-d

promptMode string

Possible values: [seer, servitor]

Default value: seer

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]

Default value: 1:1

nsfw boolean

Responses

201

Response indicating that the artwork was successfully created.

application/json

Schema

Schema

id uuidrequired
artworkType stringrequired

Possible values: [txt2img]

parameters

object

required

model string

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

Default value: tengrai-20231128-m-d

promptMode string

Possible values: [seer, servitor]

Default value: seer

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]

Default value: 1:1

nsfw boolean
duration numberrequired
results string[]required
status stringrequired

Possible values: [done, failed]

createdAt date-timerequired

Example (from schema)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "artworkType": "txt2img",
  "parameters": {
    "model": "tengrai-20231128-m-d",
    "promptMode": "seer",
    "prompt": "cat",
    "negativePrompt": "string",
    "style": "default",
    "creativity": 3,
    "details": 3,
    "aspectRatio": "1:1",
    "nsfw": false
  },
  "duration": 0,
  "results": [
    "string"
  ],
  "status": "done",
  "createdAt": "2024-07-29T15:51:28.071Z"
}

400

Bad Request

application/json

Schema

Schema

message stringrequired
statusCode numberrequired
error string

Available only when the message includes additional error details.

Example (from schema)

{
  "message": "string",
  "statusCode": 0,
  "error": "string"
}

401

Unauthorized

application/json

Schema

Schema

message stringrequired
statusCode numberrequired
error string

Available only when the message includes additional error details.

Example (from schema)

{
  "message": "string",
  "statusCode": 0,
  "error": "string"
}

403

Forbidden

application/json

Schema

Schema

message stringrequired
statusCode numberrequired
error string

Available only when the message includes additional error details.

Example (from schema)

{
  "message": "string",
  "statusCode": 0,
  "error": "string"
}

500

Internal Server Error

application/json

Schema

Schema

message stringrequired
statusCode numberrequired
error string

Available only when the message includes additional error details.

Example (from schema)

{
  "message": "string",
  "statusCode": 0,
  "error": "string"
}

504

Gateway Timeout

application/json

Schema

Schema

message stringrequired
statusCode numberrequired
error string

Available only when the message includes additional error details.

Example (from schema)

{
  "message": "string",
  "statusCode": 0,
  "error": "string"
}

Loading...