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, you can now purchase subscriptions to get faster generations speeds and more features.