Image Recognition

HTTP Method: POST

API Endpoint

http://api.open.tuputech.com/v3/recognition/your_secretId

NOTE: 'your_secretId' need to be replaced by your own secretId, please contact Tuputech to create a secretId.

Request Method:

POST

Request Header:

Content-Type: multipart/form-data

Request parameters

Parameter Type Required Description
image String or File Yes 1. Support adding image URL or uploading image file. However, one request only supports one type of image inputting. Image URL and image file cannot appear in one request.
2. Support uploading multiple images at a time.
3. Only supports static image file formats like png, jpg, jpeg, tif, webp. For animated image file formats like gif, see Video Recognition.
4. To speed up the transmission, the size of an image to be uploaded should be smaller than 1 MB. It is suggested that images be compressed until the longest side of the image is between 256 and 512 pixels.
timestamp String Yes The current UNIX timestamp of the server (can be displayed in both seconds and milliseconds).
nonce String Yes Random number. It is recommended to use decimal number between 0 and 1, for example 0.1527317095951506.
signature String Yes The algorithm used for digital signature is "RSA-SHA256", and the signature will be base64 encoded. Please follow the steps below for authentication:
1. All the parameters involving in the authentication process are secretId, timestamp, and nounce. Separate them with half-width comma, obtain sign string.
2. Use your private key to generate signature based on "RSA-SHA256" algorithm, encode in base64, and obtain value of signature parameter.

See Public Key Management to learn how to generate private key and upload your public key for authentication.
tag String No Additional description of image or text moderated (such as room ID, streamers’ user ID) used for specific image or text searching.
1. Support multiple tag parameters. Each tag parameter corresponds to each image or text parameter.
2. If the number of tag parameters is less than the one of image and text, it will complement with the last uploaded tag.
referer String No During the image downloading from URLs, it is assigned to HTTP Header Referer for anti-leech.
task String No Use this parameter to run specific tasks in the API based on different task ID, for example: 54bcfc6c329af61034f7c2fc. Without this parameter, all the tasks in the API will be performed.

QPS Limits

  • maximum 10 queries per second
  • maximum 10 images per query

To increase concurrency, please contact Tuputech team.

Sample curl request

For one image
curl -X POST --header 'Content-Type: multipart/form-data' \
-F 'image=@your_image_file_path_or_url' \
-F 'timestamp=1553249299' \
-F 'nonce=0.04708760756305974' \
-F 'signature=your_signature' \
'http://api.open.tuputech.com/v3/recognition/your_secret_id'
For multiple images
curl -X POST --header 'Content-Type: multipart/form-data' \
-F 'image=@your_image_file_path_or_url_0' \
-F 'image=@your_image_file_path_or_url_1' \
-F 'timestamp=1553249299' \
-F 'nonce=0.04708760756305974' \
-F 'signature=your_signature' \
'http://api.open.tuputech.com/v3/recognition/your_secret_id'
Sample curl request for specific task
  • Only run pornography detection task
 curl -X POST --header 'Content-Type: multipart/form-data' \
 -F 'image=@your_image_file_path_or_url' \
 -F 'timestamp=1553249299' \
 -F 'task=54bcfc6c329af61034f7c2fc' \
 -F 'nonce=0.04708760756305974' \
 -F 'signature=your_signature' \
'http://api.open.tuputech.com/v3/recognition/your_secret_id'
  • Only run task for pornography and violence detection
curl -X POST --header 'Content-Type: multipart/form-data' \
-F 'image=@your_image_file_path_or_url' \
-F 'timestamp=1553249299' \
-F 'task=54bcfc6c329af61034f7c2fc' \
-F 'task=5acb135cc40c6772b10ec73a' \
-F 'nonce=0.04708760756305974' \
-F 'signature=your_signature' \
'http://api.open.tuputech.com/v3/recognition/your_secret_id'

results matching ""

    No results matching ""