Find artworks

GET 
https://api.tengr.ai/v1/artworks

Retrieve a list of artworks with details including ID, type, parameters, duration, results, status, and creation date.

Request

Query Parameters

offset number

Default value: 0

limit number

Possible values: >= 1 and <= 500

Default value: 10

Responses

200

List of artworks.

application/json

Schema

Schema

• Array [

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"
}

• nodejs
• python
• curl
• csharp
• go
• ruby
• php
• java
• powershell

• AXIOS
• NATIVE

Request Collapse all

Base URL

https://api.tengr.ai

Auth

Bearer Token

Parameters

offset — query

limit — query

ResponseClear

Click the Send API Request button above and see the response here!