fyi, PDF::API3 doesn't appear to be maintained. and its documentation states it's the "beginning of a rewrite", so it's not expected to be complete. stick with PDF::API2 or give CAM::PDF a try.
Comment on Re: Trying to add an image to a pdf file using PDF::API3::Compat::API2;