This tutorial assumes that you have already deployed a model using Picsell.ia. If you want to learn how to do so, please check the page below :

Make predictions

To make predictions with the models you deployed using Picsll.ia, you can use the following snippet (it can be found in the deployment tab on the platform)

import requests
token = "your api token"
model_id = "chosen model id"
headers = {
    "Authorization": "Token " + token
}
name = "path/to/your/image.jpg"
​
r = requests.post(
    url="https://eyes.picsellia.com/predict/{}".format(model_id), 
    files={'media': open(name, 'rb')},
    headers=headers)

The only things you need to perform prediction is your api token to authenticate you and the API endpoint of your model (which contains the model id). If you don't know it, you can find it in the deployment tab on the platform.

Send images back to Picsell.ia

If you just want the images your perform predictions on to be sent on Picsell.ia, either in your Datalake or directly in a Dataset, here are the few things you must add.

Send to Datalake

Now, we will send a JSON body with our request.

data = {
    'loop': True,
}
r = requests.post(
    url="https://eyes.picsellia.com/predict/{}".format(model_id), 
    files={'media': open(name, 'rb')}, data=data,
    headers=headers)

You just have to set the loop parameter to True and the images will automatically be sent to your Datalake.

If you want to choose the name of the file to be saved in your Datalake you can add an argument to our JSON

data = {
    'loop': True,
    'name': 'my_super_image.jpg'
}
r = requests.post(
    url="https://eyes.picsellia.com/predict/{}".format(model_id), 
    files={'media': open(name, 'rb')}, data=data,
    headers=headers)

Now the image will be saved with the name 'my_super_image.jpg' in your Datalake !

Add tags to images

If you want to add some tags to the images such as the name of the model or whatever you want, you can add a tags parameter to the JSON just like this.

​

data = {
    'loop': True,
    'name': 'my_super_image.jpg',
    'tags': ['model_name', 'camera1']
}
r = requests.post(
    url="https://eyes.picsellia.com/predict/{}".format(model_id), 
    files={'media': open(name, 'rb')}, data=data,
    headers=headers)

Send to Datalake + add to a Dataset

If you want to not only add the image to your Datalake but also automatically add it to a Dataset of your choice, it's really simple, just add a dataset parameter to the JSON.

data = {
    'loop': True,
    'name': 'my_super_image.jpg',
    'dataset': 'my_awesome_dataset/version_name'
}
r = requests.post(
    url="https://eyes.picsellia.com/predict/{}".format(model_id), 
    files={'media': open(name, 'rb')}, data=data,
    headers=headers)

See ? The images are now automatically added to your Datalake AND your awesome Dataset 😉

Send images + predictions

If you want to send the predictions (bounding-boxes, masks, classifications) along with the images to one of your Dataset, it's also possible with just two new parameters.

data = {
    'loop': True,
    'dataset': 'my_awesome_dataset/version_name',
    'send_prediction': True,
    'threshold': 0.85
}
r = requests.post(
    url="https://eyes.picsellia.com/predict/{}".format(model_id), 
    files={'media': open(name, 'rb')}, data=data,
    headers=headers)

Just set send_prediction to True and the predictions will be sent along with images, you can also adjust the threshold of the predictions to send (the default threshold is 0.7).

That's it ! You now know how to build fully operational pipelines using only Picsell.ia !

See you on the next tutorials 👋