docs.pixble.comQuick start - pixble

Quick start | pixble Link Search Menu Expand Document pixble Quick start This site uses Just the Docs , a documentation theme for Jekyll. Quick start Pixble transforms images into professional edited images. Our API utilizes state of the art Artificial Intelligence to enhance lighting, color, tone and sharpen blurry images. API Key Sign up an account at here . Navigate to /key and generate a new API key. Authentication Pixble use an API key to authenticate requests. Authentication to the API is performed via parameters. Provide your API key when you send request as key=[API key] . You do not need to provide a password. Making a request To process images, make a POST request to the endpoint with the parameter key being set to your API key along with other operations. Depending on image size, the processing time varies. You can use a Webhook to make sure it is handled when your image is processed. API Endpoint https://api.pixble.com/job/new Request body Bash curl -X POST https://api.pixble.com/job/new \ -H "Content-Type: application/json" \ -d "{ ’task’: 9 \ ’key’: [Your API Key] \ ’data’: [Base64 image data] \ }" Javscript const fs = require ( " fs " ) const request = require ( ’ request ’ ); const data = fs . readFileSync ( ’ ./image.jpeg ’ , { encoding : ’ base64 ’ }); request ( " https://api.pixble.com/job/new " , { method : " POST " , headers : { " Content-Type’: ’application/json " } body : JSON . stringify ({ " task " : 9 , " key " : [ Your API Key ], " data " : data }) }). then (( res ) = { console . log ( res ) }) Python import requests import base64 image = open ( ’./image.jpeg’ , ’rb’ ) data = base64 . encodestring ( image . read ()) body = { "task" : 9 , "key" : [ Your API Key ], "data" : data } res = requests . post ( "https://api.pixble.com/job/new" , data = body ) print ( res ) Tasks The request needs to specify which task to perform on the image. Task Name Description 9 Pixble Magic Automatically fix lighting, color, tone. Sharpen blurry images Parameters ** Task 9: Pixble Magic** clarify_image Boolean: 1 and 0 (default: 1). Toggle AI pixel enhancement option. It automatically clarifies blurry images by using state of the art AI algorithm. adv_illumin Float: 0 to 5 (default: 1.3). Adjust the illumination of the image with AI algorithm. 0 is no adjustment and 5 is being the maximum brightness. color_correction Boolean: 1 and 0 (default: 1). Advanced color and tone correction option. It automatically balance all the colors and tone to make sure they look stunning. Response Once the request is made, a response is sent as following: { error_code: ’’ , error_message: ’’ , status: true , result: { sid: ’si_ 3 CRjTFLXIpZTYxraY 2 lP 1 ’ , job_id: ’jb_M 0 M 2 NfgnXIjL 1 VnyQVs 8 v’ , credit_left: 137.8 , credit_used: 1.2 , uuid: ’ 39 b 394 cf -649 c -4 ccb-a 0 b 4 -f 83e2103737 e’ }, timestamp: 1639335021377 } The parameters below are important for the request. status Boolean. It is to describe if the request is successful job_id Varchar. It is the unique job id to retrieve the result image in the later time Retrieve the result Depending on the size of the image, the processing can vary from 30 seconds to 15 minutes. To check the status of the job, make a GET request to the following endpoint with your job id and your API key. API Endpoint https://api.pixble.com/job/info/[job id]?key=[API key] The response is as followed. For the both input and output file, we store them for 60 days once they are done. status int. There are different status code for the request. Please see below section. 11 is sccuessful. 312 is processing. 912 is failed. { "error_code" : "" , "error_message" : "" , "status" : true , "result" :{ "job_id" : "jb_M0M2NfgnXIjL1VnyQVs8v" , "task_id" : "9" , "status" : 11 , "created_at" : "2021-12-12T18:50:21.128Z" , "last_update" : "2021-12-12T18:51:31.931Z" , "completed_at" : "2021-12-12T18:51:31.931Z" , "created_via" : "key" , "input_file" : "fi_T-Yq6xNxIl4FZZCIfu4BK" , "output_file" : "fi_9WhrmvOrkqk-tbqZlXT2V" , "files" :[ { "file_id" : "fi_T-Yq6xNxIl4FZZCIfu4BK" , "job_id" : "jb_M0M2NfgnXIjL1VnyQVs8v" , "source" : "USER_API_UPLOAD" , "url" : null , "content_type" : "image/jpeg" , "size" : 12872 , "dim" : "100x125" , "link" : "https://api.pixble.com/media/get/fi_T-Yq6xNxIl4FZZCIfu4BK" , "preview" : "https://api.pixble.com/media/preview/fi_T-Yq6xNxIl4FZZCIfu4BK" }, { "file_id" : "fi_9WhrmvOrkqk-tbqZlXT2V" , "job_id" : "jb_M0M2NfgnXIjL1VnyQVs8v" , "source" : "OUTPUT" , "url" : null , "content_type" : "image/jpeg" , "size" : 9957 , "dim" : "100x125" , "link" : "https://api.pixble.com/media/get/fi_9WhrmvOrkqk-tbqZlXT2V" , "preview" : "https://api.pixble.com/media/preview/fi_9WhrmvOrkqk-tbqZlXT2V" } ] }, "timestamp" : 1639335895382 } To download the images, make a GET request to the following endpoint with your file id or job id and API key https://api.pixble.com/media/get/fi_9WhrmvOrkqk-tbqZlXT2V?key=[API key] Webhooks The easiest way to be notified when the job is done is to setup a callback. You can setup a email callback and a webhook call at the account page after you login. The webhook send the POST request once the job is done. If your server responds with error (status code ≥ 400), the next retry will occur in 10 seconds. 1 minutes after the previous request and 2 minutes...