TwoDToThreeDRequest
Request body for 2D to 3D conversion.
Send all photos of the product in images, as file uploads or URLs, in any order. The service selects and
prepares the views itself. The named view fields are deprecated: they are still accepted, but every image —
named or not — is pooled and re-judged, so a name confers nothing.
At least one image is required, and the request is accepted only when one of these is present: images
(one or more entries), frontImage, or frontImageUrl. backImage, leftImage, rightImage and their
*Url variants on their own are rejected with 400 — they only ever accompanied a front view.
Request body for 2D to 3D conversion. Send all photos of the product in
images, as file uploads or URLs, in any order. The service selects and prepares the views itself. The named view fields are deprecated: they are still accepted, but every image — named or not — is pooled and re-judged, so a name confers nothing. At least one image is required, and the request is accepted only when one of these is present:images(one or more entries),frontImage, orfrontImageUrl.backImage,leftImage,rightImageand their*Urlvariants on their own are rejected with 400 — they only ever accompanied a front view.Request body for 2D to 3D conversion. Send all photos of the product in
images, as file uploads or URLs, in any order. The service selects and prepares the views itself. The named view fields are deprecated: they are still accepted, but every image — named or not — is pooled and re-judged, so a name confers nothing. At least one image is required, and the request is accepted only when one of these is present:images(one or more entries),frontImage, orfrontImageUrl.backImage,leftImage,rightImageand their*Urlvariants on their own are rejected with 400 — they only ever accompanied a front view.- imagesType: array 1…required
All photos of the product, as image files or URLs, in any order. This is the current way to submit a conversion. The service judges each photo — which product, whether it is alone in the frame, which angle — and prepares the views for the reconstruction model from that; listing galleries with group shots, props and close-ups are handled. Send as repeated
imagesmultipart fields. - back
Image deprecatedDeprecated — send the photo in
imagesinstead. Back view image file; still accepted, but the label is not trusted: the image is pooled withimagesand its view is re-judged. - backType: stringFormat: uri
Image Url deprecatedDeprecated — send the photo in
imagesinstead. Back view image URL; still accepted, but the label is not trusted: the image is pooled withimagesand its view is re-judged. - front
Image deprecatedDeprecated — send the photo in
imagesinstead. Front view image file; still accepted, but the label is not trusted: the image is pooled withimagesand its view is re-judged. - frontType: stringFormat: uri
Image Url deprecatedDeprecated — send the photo in
imagesinstead. Front view image URL; still accepted, but the label is not trusted: the image is pooled withimagesand its view is re-judged. - left
Image deprecatedDeprecated — send the photo in
imagesinstead. Left view image file; still accepted, but the label is not trusted: the image is pooled withimagesand its view is re-judged. - leftType: stringFormat: uri
Image Url deprecatedDeprecated — send the photo in
imagesinstead. Left view image URL; still accepted, but the label is not trusted: the image is pooled withimagesand its view is re-judged. - modelType: "glb" or "obj" or "usdz"enum
Format Output 3D model format
- modelType: "standard" or "premium" or "ultra"enum
Type Model quality tier.
standard— faster generation; the model receives the front and, when established, the back view.premium— higher-quality generation; the model receives the front, back, left, right and three-quarter views that could be established from the photos.ultra— highest quality: materials such as fleece, leather, cane and corrugated board are reconstructed as surface detail rather than flat colour, and depth is judged more reliably from few views. Receives the front, back, left and right views (a three-quarter view stands in for a missing side). Generation takes 7–15 minutes; priced above premium. - right
Image deprecatedDeprecated — send the photo in
imagesinstead. Right view image file; still accepted, but the label is not trusted: the image is pooled withimagesand its view is re-judged. - rightType: stringFormat: uri
Image Url deprecatedDeprecated — send the photo in
imagesinstead. Right view image URL; still accepted, but the label is not trusted: the image is pooled withimagesand its view is re-judged. - tagsType: array of string
Optional client-supplied tags returned as-is in the response
