Question about uploading masks via API

[BobFrederick]

I use 3d modeling software and I'm hoping to generate masks from model layers programmatically. The layers would have prompt keywords.. i.e. glass, tree, face etc. and the layer colors would correspond to the HSV format required.

So after reading the documentation I believe I understand how to generate masks using maximal color distance in HSV format however, I'm still struggling to understand the algorithm for how the regions are tagged and ordered from left to right in the prompt.

I'd like to automate this so that users don't have to upload an image, see the resulting region numbers then subsequently order their prompt based on the generated regions.

It would be great to control region order via the prompt using HSV keywords for the regions. for example:

BREAK HSV 0 red forest BREAK HSV 180 blue car.. etc.

This would allow more explicit control over prompt composition and remove the user step of generating masks button so external tools could use the mask feature of the regional prompter.

Thanks to all the contributors for the amazing work that's been done so far. 🙏