Skip to main content

V2 Changes

Changes​

Queue System​

The new API uses a queue system to handle skin generation requests.
This means instead of making a request and receiving back the skin data after a few seconds, you will now receive the ID of a queued job which you can periodically check the status of.

Response Changes​

Skin Generation Response​

V1 Response

{
  "id": 1045962434,
  "idStr": "1045962434",
  "uuid": "d3e63217abb442f5af6cd515d02e3b6e",
  "hash": "093d83daa385a423e0ad13bcafe059c2eb0b0a53",
  "name": "cool skin",
  "model": "steve",
  "variant": "classic",
  "data": {
      "uuid": "4d2731c7-7e7a-4b32-9514-4eb8784408cc",
      "texture": {
          "value": "ewogIC...H0KICB9Cn0=",
          "signature": "YpcyLNC/c8gg45d...080EoKOA=",
          "url": "http://textures.minecraft.net/texture/1...003b4",
          "urls": {
              "skin": "http://textures.minecraft.net/texture/103c20c...b4"
          }
      }
  },
  "timestamp": 1729157818,
  "duration": 2056,
  "accountId": 1271,
  "account": 1271,
  "server": "avocado",
  "private": false,
  "views": 0,
  "duplicate": false,
  "nextRequest": 2,
  "delayInfo": {
      "millis": 2000,
      "seconds": 2
  },
  "warnings": []
}

V2 Response

{
  "success": true,
  "skin": {
      "uuid": "9c7b6f5f285c4c5b9b1ca4be73fa857b",
      "visibility": "public",
      "variant": "classic",
      "name": "cool skin",
      "texture": {
          "data": {
              "value": "ewogI...CB9CiAgfQp9",
              "signature": "wk7AdG2gmQYz7...sq6biLS3RxdqphmII="
          },
          "hash": {
              "skin": "103c...836c003b4"
          },
          "url": {
              "skin": "https://textures.minecraft.net/texture/103c20c...003b4"
          }
      },
      "generator": {
          "timestamp": 1728658625018,
          "account": "b74eb5b1...56f01",
          "server": "nugget",
          "worker": "nugget",
          "version": "unknown",
          "duration": 2343
      },
      "views": 0,
      "duplicate": true
  },
  "rateLimit": {
      "next": {
          "absolute": 1729157756450,
          "relative": 0
      },
      "delay": {
          "millis": 2000,
          "seconds": 2
      },
      "limit": {
          "limit": 20,
          "remaining": 20
      }
  },
  "warnings": [],
  "messages": [],
  "links": {
      "skin": "/v2/skins/9c7b6f5f285c4c5b9b1ca4be73fa857b"
  }
}

Relaxed rate limits and credits​

V2 aims to make using the API and skin generation requests in general a bit easier by shifting more of the delays and rate limits away from clients. So fixed delays between requests have been (mostly) replaced by “classic” rate limits, e.g. 5 requests per 10 seconds.

Additionally, there is now a credits system which allows you to generate skins faster. You are automatically granted 100 free credits per month with an additional 10 credits per day. Each new skin generation uses up 1 credit. But don't worry: if you use up all your credits, you can still generate skins, but your requests are given a lower priority and will take longer to complete.