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, 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, or frontImageUrl. backImage, leftImage, rightImage and their *Url variants on their own are rejected with 400 — they only ever accompanied a front view.

    • images
      Type: 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 images multipart fields.

    • backImage
      Type: string
      deprecated

      Deprecated — send the photo in images instead. Back view image file; still accepted, but the label is not trusted: the image is pooled with images and its view is re-judged.

    • backImageUrl
      Type: string Format: uri
      deprecated

      Deprecated — send the photo in images instead. Back view image URL; still accepted, but the label is not trusted: the image is pooled with images and its view is re-judged.

    • frontImage
      Type: string
      deprecated

      Deprecated — send the photo in images instead. Front view image file; still accepted, but the label is not trusted: the image is pooled with images and its view is re-judged.

    • frontImageUrl
      Type: string Format: uri
      deprecated

      Deprecated — send the photo in images instead. Front view image URL; still accepted, but the label is not trusted: the image is pooled with images and its view is re-judged.

    • leftImage
      Type: string
      deprecated

      Deprecated — send the photo in images instead. Left view image file; still accepted, but the label is not trusted: the image is pooled with images and its view is re-judged.

    • leftImageUrl
      Type: string Format: uri
      deprecated

      Deprecated — send the photo in images instead. Left view image URL; still accepted, but the label is not trusted: the image is pooled with images and its view is re-judged.

    • modelFormat
      Type: string enum

      Output 3D model format

      values
      • glb
      • obj
      • usdz
    • modelType
      Type: string enum

      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.

      values
      • standard
      • premium
      • ultra
    • rightImage
      Type: string
      deprecated

      Deprecated — send the photo in images instead. Right view image file; still accepted, but the label is not trusted: the image is pooled with images and its view is re-judged.

    • rightImageUrl
      Type: string Format: uri
      deprecated

      Deprecated — send the photo in images instead. Right view image URL; still accepted, but the label is not trusted: the image is pooled with images and its view is re-judged.

    • tags
      Type: array string[]

      Optional client-supplied tags returned as-is in the response