API Reference

Veneer with Multi-Step Whitening

post
https://dentscape.site/v1/simulations/veneer_with_multi_whitening

Generate a veneer treatment simulation image featuring multiple whitening steps based on input whiten_step_list.

Guidelines for the image to be uploaded

1. Technical Requirements
  • Format: JPG or PNG only.
  • File Size: Up to 10 MB.
  • Dimensions: Minimum 1000x1000 pixels.

2. Uploaded Image Requirements

  • Pose: Full-face photo with a natural smile.
  • Jaw Position: No protruding or pushed-forward lower jaw.
  • Angle: Close-up face, centered and facing the camera.
  • Lighting: Adequate and bright lighting is essential.

Acceptable/Unacceptable Image Example: Sample Image

Return Format (after polling completed)

The API will return an object containing URLs for different whitening levels (0-6):

  • whiten_step_0_img_url: URL of veneer simulation for whitening level 0
  • whiten_step_2_img_url: URL of veneer simulation for whitening level 2
  • whiten_step_4_img_url: URL of veneer simulation for whitening level 4
  • whiten_step_6_img_url: URL of veneer simulation for whitening level 6
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
Defaults to https://firebasestorage.googleapis.com/v0/b/backend-server-333005.appspot.com/o/dev%2FDemo_case3.png?alt=media&token=7ca2034c-a408-4f94-808e-07387ce94d41

URL of a frontal facial image. Takes priority over image_base64 if both are provided. If you want to try your image instead of the default one, you should first upload the image to somewhere (eg. https://www.atatus.com/tools/image-to-url) to get the url.

string

Base64-encoded image data. Supports both raw base64 string and data URI format (e.g., 'data:image/jpeg;base64,...'). Use this as an alternative to image_url. Ignored if image_url is also provided.

whiten_step_list
array of integers
required
Defaults to 0,2,4,6
whiten_step_list*
Responses

400

The request could not be understood or was missing required parameters.

401

Invalid or missing authentication credentials.

500

Internal server error.

Updated 5 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 months ago

Did this page help you?