[{"data":1,"prerenderedAt":652},["ShallowReactive",2],{"navigation":3,"\u002Fgetting-started\u002Fapi-quickstart":80,"\u002Fgetting-started\u002Fapi-quickstart-surround":647},[4,30,60,75],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"Getting Started",false,"\u002Fgetting-started","1.getting-started",[10,15,20,25],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-house",{"title":16,"path":17,"stem":18,"icon":19},"WordPress plugin","\u002Fgetting-started\u002Fwordpress-plugin","1.getting-started\u002F2.wordpress-plugin","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":24},"API quickstart","\u002Fgetting-started\u002Fapi-quickstart","1.getting-started\u002F3.api-quickstart","i-lucide-terminal",{"title":26,"path":27,"stem":28,"icon":29},"FAQ","\u002Fgetting-started\u002Ffaq","1.getting-started\u002F4.faq","i-lucide-circle-help",{"title":31,"path":32,"stem":33,"children":34,"page":6},"Reference","\u002Freference","2.reference",[35,40,45,50,55],{"title":36,"path":37,"stem":38,"icon":39},"Optimize API","\u002Freference\u002Foptimize-api","2.reference\u002F1.optimize-api","i-lucide-image",{"title":41,"path":42,"stem":43,"icon":44},"Smart crop","\u002Freference\u002Fsmartcrop","2.reference\u002F2.smartcrop","i-lucide-crop",{"title":46,"path":47,"stem":48,"icon":49},"Job polling","\u002Freference\u002Fjobs","2.reference\u002F3.jobs","i-lucide-list-checks",{"title":51,"path":52,"stem":53,"icon":54},"Plans & limits","\u002Freference\u002Fplans-and-limits","2.reference\u002F4.plans-and-limits","i-lucide-credit-card",{"title":56,"path":57,"stem":58,"icon":59},"Account usage","\u002Freference\u002Faccount","2.reference\u002F5.account","i-lucide-gauge",{"title":61,"path":62,"stem":63,"children":64,"page":6},"AI","\u002Fai","3.ai",[65,70],{"title":66,"path":67,"stem":68,"icon":69},"AI alt text & SEO","\u002Fai\u002Falt-text-and-seo","3.ai\u002F1.alt-text-and-seo","i-lucide-sparkles",{"title":71,"path":72,"stem":73,"icon":74},"AI background removal","\u002Fai\u002Fbackground-removal","3.ai\u002F2.background-removal","i-lucide-scissors",{"title":76,"path":77,"stem":78,"icon":79},"Account API","\u002Faccount-api","4.account-api","i-lucide-key-round",{"id":81,"title":21,"body":82,"description":640,"extension":641,"links":642,"meta":643,"navigation":644,"path":22,"seo":645,"stem":23,"__hash__":646},"docs\u002F1.getting-started\u002F3.api-quickstart.md",{"type":83,"value":84,"toc":634},"minimark",[85,89,94,105,149,153,171,239,247,251,262,318,398,411,435,594,600,604,630],[86,87,88],"p",{},"This walks through calling the API directly, without the WordPress plugin:\nupload an image, wait for it to finish, and read back the result.",[90,91,93],"h2",{"id":92},"authentication","Authentication",[86,95,96,97,104],{},"Every request needs your API key as a bearer token. Get one from the\n",[98,99,103],"a",{"href":100,"rel":101},"https:\u002F\u002Fapp.helloimg.io",[102],"nofollow","helloIMG dashboard",".",[106,107,113],"pre",{"className":108,"code":109,"filename":110,"language":111,"meta":112,"style":112},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Authorization: Bearer \u003Cyour API key>\n","Terminal","bash","",[114,115,116],"code",{"__ignoreMap":112},[117,118,121,125,129,133,136,139,142,146],"span",{"class":119,"line":120},"line",1,[117,122,124],{"class":123},"sBMFI","Authorization:",[117,126,128],{"class":127},"sfazB"," Bearer",[117,130,132],{"class":131},"sMK4o"," \u003C",[117,134,135],{"class":127},"your",[117,137,138],{"class":127}," API",[117,140,141],{"class":127}," ke",[117,143,145],{"class":144},"sTEyZ","y",[117,147,148],{"class":131},">\n",[90,150,152],{"id":151},"upload-an-image","Upload an image",[86,154,155,158,159,162,163,166,167,170],{},[114,156,157],{},"POST \u002Fv1\u002Foptimize"," takes ",[114,160,161],{},"multipart\u002Fform-data",": an ",[114,164,165],{},"image"," file field, and\nan optional ",[114,168,169],{},"data"," field with a JSON string describing how to optimize it.",[106,172,174],{"className":108,"code":173,"filename":110,"language":111,"meta":112,"style":112},"curl -X POST https:\u002F\u002Fapi.helloimg.io\u002Fv1\u002Foptimize \\\n  -H \"Authorization: Bearer \u003Cyour API key>\" \\\n  -F \"image=@photo.jpg\" \\\n  -F 'data={\"level\":\"aggressive\",\"convert\":\"webp\"}'\n",[114,175,176,193,210,225],{"__ignoreMap":112},[117,177,178,181,184,187,190],{"class":119,"line":120},[117,179,180],{"class":123},"curl",[117,182,183],{"class":127}," -X",[117,185,186],{"class":127}," POST",[117,188,189],{"class":127}," https:\u002F\u002Fapi.helloimg.io\u002Fv1\u002Foptimize",[117,191,192],{"class":144}," \\\n",[117,194,196,199,202,205,208],{"class":119,"line":195},2,[117,197,198],{"class":127},"  -H",[117,200,201],{"class":131}," \"",[117,203,204],{"class":127},"Authorization: Bearer \u003Cyour API key>",[117,206,207],{"class":131},"\"",[117,209,192],{"class":144},[117,211,213,216,218,221,223],{"class":119,"line":212},3,[117,214,215],{"class":127},"  -F",[117,217,201],{"class":131},[117,219,220],{"class":127},"image=@photo.jpg",[117,222,207],{"class":131},[117,224,192],{"class":144},[117,226,228,230,233,236],{"class":119,"line":227},4,[117,229,215],{"class":127},[117,231,232],{"class":131}," '",[117,234,235],{"class":127},"data={\"level\":\"aggressive\",\"convert\":\"webp\"}",[117,237,238],{"class":131},"'\n",[86,240,241,242,246],{},"By default this call ",[243,244,245],"strong",{},"blocks until processing finishes"," and returns the\nresult directly. If the exact same image and options were optimized\nrecently, you get the cached result back immediately instead of waiting.",[90,248,250],{"id":249},"or-upload-async-and-poll-yourself","Or upload async and poll yourself",[86,252,253,254,257,258,261],{},"Add ",[114,255,256],{},"?async=true"," to get a ",[114,259,260],{},"job_id"," right away instead of waiting:",[106,263,265],{"className":108,"code":264,"filename":110,"language":111,"meta":112,"style":112},"curl -X POST \"https:\u002F\u002Fapi.helloimg.io\u002Fv1\u002Foptimize?async=true\" \\\n  -H \"Authorization: Bearer \u003Cyour API key>\" \\\n  -F \"image=@photo.jpg\" \\\n  -F 'data={\"level\":\"aggressive\",\"convert\":\"webp\"}'\n",[114,266,267,284,296,308],{"__ignoreMap":112},[117,268,269,271,273,275,277,280,282],{"class":119,"line":120},[117,270,180],{"class":123},[117,272,183],{"class":127},[117,274,186],{"class":127},[117,276,201],{"class":131},[117,278,279],{"class":127},"https:\u002F\u002Fapi.helloimg.io\u002Fv1\u002Foptimize?async=true",[117,281,207],{"class":131},[117,283,192],{"class":144},[117,285,286,288,290,292,294],{"class":119,"line":195},[117,287,198],{"class":127},[117,289,201],{"class":131},[117,291,204],{"class":127},[117,293,207],{"class":131},[117,295,192],{"class":144},[117,297,298,300,302,304,306],{"class":119,"line":212},[117,299,215],{"class":127},[117,301,201],{"class":131},[117,303,220],{"class":127},[117,305,207],{"class":131},[117,307,192],{"class":144},[117,309,310,312,314,316],{"class":119,"line":227},[117,311,215],{"class":127},[117,313,232],{"class":131},[117,315,235],{"class":127},[117,317,238],{"class":131},[106,319,323],{"className":320,"code":321,"language":322,"meta":112,"style":112},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"job_id\": \"job_5f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c\",\n  \"status\": \"processing\",\n  \"poll_url\": \"\u002Fv1\u002Fjobs\u002Fjob_5f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c\"\n}\n","json",[114,324,325,330,353,373,392],{"__ignoreMap":112},[117,326,327],{"class":119,"line":120},[117,328,329],{"class":131},"{\n",[117,331,332,335,338,340,343,345,348,350],{"class":119,"line":195},[117,333,334],{"class":131},"  \"",[117,336,260],{"class":337},"spNyl",[117,339,207],{"class":131},[117,341,342],{"class":131},":",[117,344,201],{"class":131},[117,346,347],{"class":127},"job_5f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c",[117,349,207],{"class":131},[117,351,352],{"class":131},",\n",[117,354,355,357,360,362,364,366,369,371],{"class":119,"line":212},[117,356,334],{"class":131},[117,358,359],{"class":337},"status",[117,361,207],{"class":131},[117,363,342],{"class":131},[117,365,201],{"class":131},[117,367,368],{"class":127},"processing",[117,370,207],{"class":131},[117,372,352],{"class":131},[117,374,375,377,380,382,384,386,389],{"class":119,"line":227},[117,376,334],{"class":131},[117,378,379],{"class":337},"poll_url",[117,381,207],{"class":131},[117,383,342],{"class":131},[117,385,201],{"class":131},[117,387,388],{"class":127},"\u002Fv1\u002Fjobs\u002Fjob_5f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c",[117,390,391],{"class":131},"\"\n",[117,393,395],{"class":119,"line":394},5,[117,396,397],{"class":131},"}\n",[86,399,400,401,404,405,407,408,342],{},"Then poll ",[114,402,403],{},"GET \u002Fv1\u002Fjobs\u002F{job_id}"," until ",[114,406,359],{}," is no longer ",[114,409,410],{},"\"processing\"",[106,412,414],{"className":108,"code":413,"filename":110,"language":111,"meta":112,"style":112},"curl https:\u002F\u002Fapi.helloimg.io\u002Fv1\u002Fjobs\u002Fjob_5f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c \\\n  -H \"Authorization: Bearer \u003Cyour API key>\"\n",[114,415,416,425],{"__ignoreMap":112},[117,417,418,420,423],{"class":119,"line":120},[117,419,180],{"class":123},[117,421,422],{"class":127}," https:\u002F\u002Fapi.helloimg.io\u002Fv1\u002Fjobs\u002Fjob_5f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c",[117,424,192],{"class":144},[117,426,427,429,431,433],{"class":119,"line":195},[117,428,198],{"class":127},[117,430,201],{"class":131},[117,432,204],{"class":127},[117,434,391],{"class":131},[106,436,438],{"className":320,"code":437,"language":322,"meta":112,"style":112},"{\n  \"job_id\": \"job_5f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c\",\n  \"status\": \"completed\",\n  \"result\": {\n    \"image_url\": \"https:\u002F\u002Fcdn.helloimg.io\u002Fhelloimg-optimized\u002Fopt_job_5f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c.webp\",\n    \"original_size\": 855000,\n    \"new_size\": 111000,\n    \"percent\": 87.03,\n    \"processing_time_ms\": 26\n  }\n}\n",[114,439,440,444,462,481,495,516,534,551,568,583,589],{"__ignoreMap":112},[117,441,442],{"class":119,"line":120},[117,443,329],{"class":131},[117,445,446,448,450,452,454,456,458,460],{"class":119,"line":195},[117,447,334],{"class":131},[117,449,260],{"class":337},[117,451,207],{"class":131},[117,453,342],{"class":131},[117,455,201],{"class":131},[117,457,347],{"class":127},[117,459,207],{"class":131},[117,461,352],{"class":131},[117,463,464,466,468,470,472,474,477,479],{"class":119,"line":212},[117,465,334],{"class":131},[117,467,359],{"class":337},[117,469,207],{"class":131},[117,471,342],{"class":131},[117,473,201],{"class":131},[117,475,476],{"class":127},"completed",[117,478,207],{"class":131},[117,480,352],{"class":131},[117,482,483,485,488,490,492],{"class":119,"line":227},[117,484,334],{"class":131},[117,486,487],{"class":337},"result",[117,489,207],{"class":131},[117,491,342],{"class":131},[117,493,494],{"class":131}," {\n",[117,496,497,500,503,505,507,509,512,514],{"class":119,"line":394},[117,498,499],{"class":131},"    \"",[117,501,502],{"class":123},"image_url",[117,504,207],{"class":131},[117,506,342],{"class":131},[117,508,201],{"class":131},[117,510,511],{"class":127},"https:\u002F\u002Fcdn.helloimg.io\u002Fhelloimg-optimized\u002Fopt_job_5f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c.webp",[117,513,207],{"class":131},[117,515,352],{"class":131},[117,517,519,521,524,526,528,532],{"class":119,"line":518},6,[117,520,499],{"class":131},[117,522,523],{"class":123},"original_size",[117,525,207],{"class":131},[117,527,342],{"class":131},[117,529,531],{"class":530},"sbssI"," 855000",[117,533,352],{"class":131},[117,535,537,539,542,544,546,549],{"class":119,"line":536},7,[117,538,499],{"class":131},[117,540,541],{"class":123},"new_size",[117,543,207],{"class":131},[117,545,342],{"class":131},[117,547,548],{"class":530}," 111000",[117,550,352],{"class":131},[117,552,554,556,559,561,563,566],{"class":119,"line":553},8,[117,555,499],{"class":131},[117,557,558],{"class":123},"percent",[117,560,207],{"class":131},[117,562,342],{"class":131},[117,564,565],{"class":530}," 87.03",[117,567,352],{"class":131},[117,569,571,573,576,578,580],{"class":119,"line":570},9,[117,572,499],{"class":131},[117,574,575],{"class":123},"processing_time_ms",[117,577,207],{"class":131},[117,579,342],{"class":131},[117,581,582],{"class":530}," 26\n",[117,584,586],{"class":119,"line":585},10,[117,587,588],{"class":131},"  }\n",[117,590,592],{"class":119,"line":591},11,[117,593,397],{"class":131},[595,596,597],"callout",{},[86,598,599],{},"A sensible poll interval is a few hundred milliseconds to start, backing off\nas the job runs longer — most images finish in well under a second, but\ngive it more room for large uploads.",[90,601,603],{"id":602},"next-steps","Next steps",[605,606,607,614,619,625],"card-group",{},[608,609,611],"card",{"icon":39,"title":610,"to":37},"Optimize API reference",[86,612,613],{},"Every parameter: levels, formats, resize, EXIF, lossless.",[608,615,616],{"icon":44,"title":41,"to":42},[86,617,618],{},"Subject-aware cropping to an exact width and height.",[608,620,622],{"icon":49,"title":621,"to":47},"Job polling reference",[86,623,624],{},"The full set of job states and response shapes.",[608,626,627],{"icon":59,"title":56,"to":57},[86,628,629],{},"Check your current-month usage and, on Free, how close you are to the cap.",[631,632,633],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":112,"searchDepth":120,"depth":195,"links":635},[636,637,638,639],{"id":92,"depth":195,"text":93},{"id":151,"depth":195,"text":152},{"id":249,"depth":195,"text":250},{"id":602,"depth":195,"text":603},"Optimize an image end to end with curl — upload, then poll until it's done.","md",null,{},{"icon":24},{"title":21,"description":640},"Dmet0iHQnik4fMIepSj-m4fkCYlSg5bM0VFqmUa8QC4",[648,650],{"title":16,"path":17,"stem":18,"description":649,"icon":19,"children":-1},"Install LW Image, paste your API key, and every upload gets converted automatically.",{"title":26,"path":27,"stem":28,"description":651,"icon":29,"children":-1},"Honest answers to the basics — formats, sync vs async, what the plugin changes.",1787466465711]