v1

latestSwagger 2.02026-07-176096209.1 KB
v2

Submit aesthetic ratings for generated images to be used by LAION and Stability

AI The request has to have been sent as shared: true. You can select the best image in the set, and/or provide a rating for each or some images in the set. If you select best-of image, you will gain 4 kudos. Each rating is 5 kudos. Best-of will be ignored when ratings conflict with it. You can never gain more kudos than you spent for this generation. Your reward at max will be your kudos consumption - 1.

post/v2/generate/rate/{id}

Headers

Client-Agentstring

The client name and version

X-Fieldsstring mask

An optional fields mask

Request body

beststring

The UUID of the best image in this generation batch (only used when 2+ images generated). If 2+ aesthetic ratings are also provided, then they take precedence if they're not tied.

Example request

{
  "best": "6038971e-f0b0-4fdd-a3bb-148f561f815e",
  "ratings": [
    {
      "id": "6038971e-f0b0-4fdd-a3bb-148f561f815e",
      "artifacts": 1
    }
  ]
}

Response

Aesthetics Submitted

rewardnumber

The amount of kudos gained for submitting this request.

Example response

{
  "reward": 10
}