We use analytics and minimal tracking across our websites to help improve performance and user experience. Our privacy policy.
curl --request POST \
--url https://api.private-ai.com/deid/v3/process/files/uri \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"uri": "https://example.com/example-image.jpeg",
"entity_detection": {
"accuracy": "high",
"return_entity": true
},
"pdf_options": {
"density": 150
},
"audio_options": {
"bleep_start_padding": 0,
"bleep_end_padding": 0
}
}
'{
"result_uri": "<string>",
"processed_text": "<string>",
"entities": [
{
"processed_text": "<string>",
"text": "<string>",
"location": {
"stt_idx": 123,
"end_idx": 123,
"stt_idx_processed": 123,
"end_idx_processed": 123
},
"best_label": "<string>",
"labels": {}
}
],
"entities_present": true
}Process File
Detect entities such as PII, PHI or PCI in the file located at the provided URI using Private AI’s entity detection engine. After entity detection, a copy of the file with all entities removed is created and placed in the folder specified by PAI_OUTPUT_FILE_DIR.
This route is similar to /v3/process/files/base64, but relies on URIs instead of base64-encoded strings. As this route avoids the overhead of base64 encoding, it is more suitable for processing large files and large volumes of data.
This route supports multiple filetypes, with the content type recognized automatically and processed accordingly.
curl --request POST \
--url https://api.private-ai.com/deid/v3/process/files/uri \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"uri": "https://example.com/example-image.jpeg",
"entity_detection": {
"accuracy": "high",
"return_entity": true
},
"pdf_options": {
"density": 150
},
"audio_options": {
"bleep_start_padding": 0,
"bleep_end_padding": 0
}
}
'{
"result_uri": "<string>",
"processed_text": "<string>",
"entities": [
{
"processed_text": "<string>",
"text": "<string>",
"location": {
"stt_idx": 123,
"end_idx": 123,
"stt_idx_processed": 123,
"end_idx_processed": 123
},
"best_label": "<string>",
"labels": {}
}
],
"entities_present": true
}Authorizations
Headers
Body
URI of the file to be processed. It can be an URL (e.g www.foo.com/files/random-image.jpeg) or an accessible file path on the host machine (e.g. /Users/sam/files/file.pdf).
This section contains a set of parameters to control the PII detection process. All fields have sensible default that can be changed for specific needs.
Show child attributes
Show child attributes
Options to process PDF files, such as the rendering quality when each page is turned into an image.
Show child attributes
Show child attributes
Options to process audio files, such as the padding to add while redacting audio segments.
Show child attributes
Show child attributes
Response
Successful Response
URI of the processed file in the output directory (e.g. /Users/sam/files/file.redacted.pdf).
This field contains the redacted version of any text that was extracted from the input file. It corresponds to a redacted ASR transcript for audio files and any text found inside a document such as a PDF or image file.
A list of all entities found in the provided file.
Show child attributes
Show child attributes
Returns True if the list of detected entities is not empty.