Jim is correct.
If, via Ruby, you give a layer a color with transparency it is ignored and it renders opaque.
Sp currently you can only change a layer's color through the API - there is no alpha OR texture support within the API, although of course you can do both of those manually...