How Python can interact with our powerful Photoshop API<\/h2>\n\n\n\n\n\n<\/p>\n\n\n\n![\"Raymond](\"https:\/\/miro.medium.com\/v2\/resize:fill:88:88\/1*ldF-FsLonNyTUOmQ7cIV_g.jpeg\")
<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/a><\/p>\n\n\n\n\n![\"Adobe](\"https:\/\/miro.medium.com\/v2\/resize:fill:48:48\/1*riyFijvwTfGcWNf1guRNtg.png\")
<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/a><\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n![\"\"]()
<\/picture><\/div>\n<\/div>\n<\/figure>\nThe Photoshop API<\/a> is an incredibly powerful REST-based API for performing Photoshop tasks in the cloud and at scale.<\/p>\nI\u2019ve been demonstrating its features on our blog over the past few months, generally using Node.js, but the API\u2019s simplicity makes it available for any platform out there.<\/p>\n
In this article, I\u2019ll share an example of how Python can be used to interact with the Photoshop API. As a warning, I\u2019m fairly new to Python, but one of the best aspects of the language is just how easy it is to pick up and start using it right away.<\/p>\n
If you haven\u2019t already done so, grab your free trial credentials<\/a> so you can play with the API yourself. With that, let\u2019s get started!<\/p>\nIn general, working with the different parts of the Photoshop APIs involves much the same steps:<\/p>\n
\n- Convert credentials into an access token<\/li>\n
- Determine input and output URLs (as the APIs work with cloud storage, this will depend on your storage system and their SDKs)<\/li>\n
- Call the API endpoint, passing in your URLs and other arguments required for that particular service<\/li>\n
- Check the result of the API call on a schedule to determine the status of the job<\/li>\n<\/ul>\n
So Let\u2019s break these down into individual Python examples.<\/p>\n
Again, assuming you have your credentials, getting an access token is as simple as a call to Adobe\u2019s ims<\/code> endpoint. Here’s an example:<\/p>\nNote that the assumption is that the credentials, CLIENT_ID<\/code> and CLIENT_SECRET<\/code> are available in environment variables. Running this script will dump out the result of the call:<\/p>\nTypically you can just work with the access_token<\/code> result of the call.<\/p>\nThe next step is completely optional, and not generally recommended in production, but it may be a good idea while learning and testing.<\/p>\n
The Photoshop API provides a method that only<\/em> verifies the access token. This is handy as other calls will require working with cloud storage. The hello<\/code> endpoint will do simply that: echo back a greeting if you’ve correctly performed authentication. Let’s update the Python call with a new function testing that, sayHello<\/code>:<\/p>\nAll of our API calls will require two headers for authorization. The first, Authorization<\/code>, includes the access token returned from the earlier request, while x-api-key<\/code> uses the CLIENT_ID<\/code> value from our credentials.<\/p>\nThe result of this script is simply: Response from hello endpoint: Welcome to the Photoshop API!<\/code><\/p>\nThe next thing to do is start a job of some sort. The Photoshop API has many<\/em> features, but for today, let\u2019s consider the Remove Background<\/a> API which, you guessed it, removes the background from an image.<\/p>\nIn order to do this, we need both a source for our input and a place to store the output.<\/p>\n
The Photoshop APIs support cloud storage on Amazon S3, Dropbox, and Azure, and the particularities of each depend on their SDKs. For today, let\u2019s just consider a simple S3 bucket. The Photoshop API team created a nice Python demo<\/a> I can borrow from to simplify making those S3 URLs using the Python boto3<\/code> package.<\/p>\nLet\u2019s look at our updated script:<\/p>\n
There are two big changes here. First note the use of get_presigned_url<\/code>. This lets us create a readable URL for our source image as well as a writeable URL for the output. You can see that towards the bottom of the script where inputURL<\/code> and uploadURL<\/code> are created.<\/p>\nNext, the create_removebg_job<\/code> function is called with our credentials and URLs. In that function, look at data<\/code>. This information is passed to the API and defines how it should operate. In general, every single part of the API will be a version of this, with just the parameters changing based on what operation is being used.<\/p>\nThe end result of this call is a job<\/code> that looks like this:<\/p>\nFor the final part of our sample code, let\u2019s check the job and keep checking it until it finishes.<\/p>\n
Technically, you don\u2019t need to do this in the same script. You could, for example, store the job result in a database and use a scheduled process to check the result at a later time. Since the \u201ctypical\u201d call to the Photoshop API will finish rather quickly, it isn\u2019t too difficult to add it to our script.<\/p>\n
In the code sample below, I\u2019m only sharing the portion where the job is created and how polling for the result is handled. All the code before this portion is the same as before:<\/p>\n
Now we\u2019re taking the URL from the job creation call and continuing to call it until the status of the response is either good or bad. In that loop, the response is also bring printed out. Here\u2019s an example of what that looks like when done:<\/p>\n
If you would like to play with this code, you can find it on my repository here: https:\/\/github.com\/cfjedimaster\/photoshop_api_preso\/tree\/main\/demos\/python<\/a>. Also, you can find a notebook version of it here<\/a>, but be sure to note the requirements for credentials at the top.<\/p>\nLet us know how this works for you, and reach out on our forums<\/a> with any questions!<\/p>\n<\/div>\n
<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/a><\/p>\n <\/a><\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n The Photoshop API<\/a> is an incredibly powerful REST-based API for performing Photoshop tasks in the cloud and at scale.<\/p>\n I\u2019ve been demonstrating its features on our blog over the past few months, generally using Node.js, but the API\u2019s simplicity makes it available for any platform out there.<\/p>\n In this article, I\u2019ll share an example of how Python can be used to interact with the Photoshop API. As a warning, I\u2019m fairly new to Python, but one of the best aspects of the language is just how easy it is to pick up and start using it right away.<\/p>\n If you haven\u2019t already done so, grab your free trial credentials<\/a> so you can play with the API yourself. With that, let\u2019s get started!<\/p>\n In general, working with the different parts of the Photoshop APIs involves much the same steps:<\/p>\n So Let\u2019s break these down into individual Python examples.<\/p>\n Again, assuming you have your credentials, getting an access token is as simple as a call to Adobe\u2019s Note that the assumption is that the credentials, Typically you can just work with the The next step is completely optional, and not generally recommended in production, but it may be a good idea while learning and testing.<\/p>\n The Photoshop API provides a method that only<\/em> verifies the access token. This is handy as other calls will require working with cloud storage. The All of our API calls will require two headers for authorization. The first, The result of this script is simply: The next thing to do is start a job of some sort. The Photoshop API has many<\/em> features, but for today, let\u2019s consider the Remove Background<\/a> API which, you guessed it, removes the background from an image.<\/p>\n In order to do this, we need both a source for our input and a place to store the output.<\/p>\n The Photoshop APIs support cloud storage on Amazon S3, Dropbox, and Azure, and the particularities of each depend on their SDKs. For today, let\u2019s just consider a simple S3 bucket. The Photoshop API team created a nice Python demo<\/a> I can borrow from to simplify making those S3 URLs using the Python Let\u2019s look at our updated script:<\/p>\n There are two big changes here. First note the use of Next, the The end result of this call is a For the final part of our sample code, let\u2019s check the job and keep checking it until it finishes.<\/p>\n Technically, you don\u2019t need to do this in the same script. You could, for example, store the job result in a database and use a scheduled process to check the result at a later time. Since the \u201ctypical\u201d call to the Photoshop API will finish rather quickly, it isn\u2019t too difficult to add it to our script.<\/p>\n In the code sample below, I\u2019m only sharing the portion where the job is created and how polling for the result is handled. All the code before this portion is the same as before:<\/p>\n Now we\u2019re taking the URL from the job creation call and continuing to call it until the status of the response is either good or bad. In that loop, the response is also bring printed out. Here\u2019s an example of what that looks like when done:<\/p>\n If you would like to play with this code, you can find it on my repository here: https:\/\/github.com\/cfjedimaster\/photoshop_api_preso\/tree\/main\/demos\/python<\/a>. Also, you can find a notebook version of it here<\/a>, but be sure to note the requirements for credentials at the top.<\/p>\n Let us know how this works for you, and reach out on our forums<\/a> with any questions!<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n![\"\"](\"https:\/\/miro.medium.com\/v2\/resize:fit:640\/format:webp\/1*X3uTzs55-zrhTgrdb0M7JQ.jpeg)
\n
ims<\/code> endpoint. Here’s an example:<\/p>\nCLIENT_ID<\/code> and CLIENT_SECRET<\/code> are available in environment variables. Running this script will dump out the result of the call:<\/p>\naccess_token<\/code> result of the call.<\/p>\nhello<\/code> endpoint will do simply that: echo back a greeting if you’ve correctly performed authentication. Let’s update the Python call with a new function testing that, sayHello<\/code>:<\/p>\nAuthorization<\/code>, includes the access token returned from the earlier request, while x-api-key<\/code> uses the CLIENT_ID<\/code> value from our credentials.<\/p>\nResponse from hello endpoint: Welcome to the Photoshop API!<\/code><\/p>\nboto3<\/code> package.<\/p>\nget_presigned_url<\/code>. This lets us create a readable URL for our source image as well as a writeable URL for the output. You can see that towards the bottom of the script where inputURL<\/code> and uploadURL<\/code> are created.<\/p>\ncreate_removebg_job<\/code> function is called with our credentials and URLs. In that function, look at data<\/code>. This information is passed to the API and defines how it should operate. In general, every single part of the API will be a version of this, with just the parameters changing based on what operation is being used.<\/p>\njob<\/code> that looks like this:<\/p>\n