Create txt2img artwork
POST/v1/artworks/txt2img
Generate artwork using text-to-image (txt2img) conversion.
Request
- application/json
Body
required
Possible values: [tengrai-20231128-m-d, tengrai-20240423-m-f]
Default value: tengrai-20231128-m-d
Possible values: [seer, servitor]
Default value: seer
Default value: cat
Limited to 256 words; additional content will be truncated.
Limited to 64 words; additional content will be truncated.
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
Possible values: >= 1 and <= 5
Default value: 3
Possible values: >= 1 and <= 5
Default value: 3
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.
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).
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).
Responses
- 201
- 400
- 401
- 403
- 429
- 500
- 504
Response indicating that the artwork was successfully created.
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [txt2img]
parameters
object
required
Possible values: [tengrai-20231128-m-d, tengrai-20240423-m-f]
Default value: tengrai-20231128-m-d
Possible values: [seer, servitor]
Default value: seer
Default value: cat
Limited to 256 words; additional content will be truncated.
Limited to 64 words; additional content will be truncated.
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
Possible values: >= 1 and <= 5
Default value: 3
Possible values: >= 1 and <= 5
Default value: 3
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.
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).
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).
Possible values: [done, failed]
{
"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",
"width": 1024,
"height": 1024,
"nsfw": false
},
"duration": 0,
"results": [
"string"
],
"status": "done",
"createdAt": "2024-07-29T15:51:28.071Z"
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Too Many Requests
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Gateway Timeout
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}