Developers

The same tools, from your code

Three HTTP calls, no SDK, no account. A credit code (0TK-…) is your API key: buy the Print 100 + API pack (or any pack) and pass the code as a bearer token. Every image is processed and deleted: 1 hour after download, 24 hours at most.

1. Create a job

curl -X POST https://airpic.app/api/jobs \
  -F "file=@photo.jpg" \
  -F "tool=upscale" \
  -F 'options={"mode":"x8","style":"sharp"}' \
  -F "lang=en"
# → {"job_id":"…","tool":"upscale"}

tool	options (JSON)	credit
`upscale`	`mode`: x4 · x8 · x16 · max250 (default x4) · `style`: sharp · paint	x4 = standard · x8/x16/max250 = large format
`anime`	—	standard
`remove-bg`	`bg`: transparent · white · black	standard
`compress`	`format`: jpeg · webp · png · `quality`: 30–95 · `target_kb`	standard
`colorize`	—	standard
`denoise`	—	standard

Input: JPG, PNG, WebP or TIFF up to 100 MB and 37.5 MP (32 MP for a direct ×4). Output up to 600 MP (PNG up to 32 MP, JPEG q92 above).

2. Poll the status

curl https://airpic.app/api/jobs/JOB_ID
# → {"status":"queued"|"processing"}
# → {"status":"done","output":{"width":5120,"height":3840,"bytes":…,"ext":"png",
#     "url":"/api/download/JOB_ID","preview_url":"/api/preview/JOB_ID"}}
# → {"status":"error","error":"…"}   (nothing is charged)

Poll every 1–2 s. A cold engine adds 60–90 s the first time; a large ×16 can take several minutes. The preview (≤ 1600 px) is free to fetch.

3. Download the full file

curl -L -o result.png \
  -H "Authorization: Bearer 0TK-XXXXXXXXXXXX" \
  https://airpic.app/api/download/JOB_ID

The first download of a job consumes 1 credit of the right kind (standard or large format) from the code; later downloads of the same job are free. Without credit you get 402 with {"need":"std"|"gf"}. Check a balance any time:

curl https://airpic.app/api/credits/0TK-XXXXXXXXXXXX
# → {"std":0,"gf":97}

Limits & fair use

20 jobs per hour per IP. Need more? Write to us with your code and we raise it.
Concurrent GPU workers are shared: batch politely, at most 2 jobs in flight.
Codes are bearer tokens: keep them server-side, never in a browser or app binary.

During the beta downloads are free and the bearer header is optional. Pricing and packs: airpic.app/en/#precios.