Image to 3D API. Built into your app.

Angle-sheet preview

$0.00

No credits charged, subject to your account’s preview allowance. Review the preview before the paid build.

Per full 3D build · pay as you go

$0.64

64 credits for the final angle sheet and textured GLB. This is the full photo-to-3D workflow.

API & MCP access

Included

Use your account and credits through either integration. No separate connector fee.

Read renderCredits in the render response before building; it is the credit cost for that render. Keep approval and spending limits in your application. Failed 3D builds refund their credits. Prices shown use your current currency and pricing offer.

1. 01

   Upload and preview

   Send a JPEG, PNG or WebP file as multipart form data. Keep the returned render ID and check progress.

2. 02

   Approve the build

   Show the preview and credit cost in your UI. Call the build endpoint only when you are ready to spend credits.

3. 03

   Retrieve the GLB

   Poll for completion from your server, handle failures and download the finished model with your API key.

1. 01 · Upload your photo

   Use your own product.jpg. The response includes id, status and renderCredits. The image field is a file, not a JSON image_url.

   POST /api/rendersCopy

   curl --fail-with-body "$EASYRENDER_URL/api/renders" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY" \
     --form "image=@product.jpg"

2. 02 · Choose visibility

   Replace EASYRENDER_RENDER_ID with the id from the response. Finished renders are public by default. This request keeps the render out of the public gallery; send it before starting the build.

   PATCH /api/renders/{id}Copy

   export EASYRENDER_RENDER_ID="REPLACE_WITH_RESPONSE_ID"
   
   curl --fail-with-body --request PATCH \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY" \
     --header "Content-Type: application/json" \
     --data '{"isPublic":false}'

3. 03 · Wait for the preview

   Repeat the first request with a delay until status is preview_ready. Then run the second request and inspect preview.webp. Use renderCredits from the JSON response to show the build cost. Stop if status is failed.

   GET status → GET previewCopy

   curl --fail-with-body \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY"
   
   curl --fail-with-body \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID/preview" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY" \
     --output preview.webp

4. 04 · Start the paid build

   This request spends credits. Run it only after reviewing the preview, confirming the cost and ensuring your account has enough credits. Your application must implement its own approval step.

   POST /api/renders/{id}/renderCopy

   export EASYRENDER_MAX_CREDITS="REPLACE_WITH_APPROVED_CREDIT_CEILING"
   
   curl --fail-with-body --request POST \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID/render" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY" \
     --header "Content-Type: application/json" \
     --data '{"maxCredits":'"$EASYRENDER_MAX_CREDITS"'}'

5. 05 · Download when ready

   Repeat the status request with a delay until status is ready and hasModel is true. Only then run the download request. A failed status ends the job; failed builds refund their credits.

   GET status → GET modelCopy

   curl --fail-with-body \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY"
   
   curl --fail-with-body \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID/model?download=1" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY" \
     --output product.glb

Use polling with a delay and a timeout in your application. These examples show individual requests, not an automatic retry loop. For HTTP errors, inspect the JSON error and code fields.