Media API
No API key. No account. No sign-up. Post a file, and the response body is the finished file. No job id, nothing to poll.
Last updated: 1 September 2026
First, the key bit
There is no API for converting images, and that is deliberate. HEIC to JPG, WEBP to JPG and the rest run entirely inside your own browser, so the picture never reaches a server at all. There is nothing to call and nothing we could expose without making it worse for you.
What this API does cover is the work that genuinely needs a machine: video, audio, e-books, camera RAW and vector tracing.
Quick start
# a video into a GIF
$ curl -s -o out.gif -F "file=@clip.mp4" \
https://convert.shinobitools.com/api/gif
# the soundtrack out of a video
$ curl -s -o out.mp3 -F "file=@clip.mp4" -F "formaat=mp3" \
https://convert.shinobitools.com/api/audio
# a logo traced into an SVG
$ curl -s -o logo.svg -F "file=@logo.png" \
https://convert.shinobitools.com/api/vectorizeEndpoints
All take multipart/form-data with a file field, and all return the finished file directly.
| Endpoint | Options | You get back |
|---|---|---|
POST /api/gif | fps (12), breedte (480), start_s, duur_s | image/gif |
POST /api/audio | formaat (mp3) | the audio track |
POST /api/mute | none | the video without sound |
POST /api/volume | db (6.0) | the video, louder or quieter |
POST /api/rotate | graden (90) | the rotated video |
POST /api/video | doel_mb (25.0) | the video shrunk towards that size |
POST /api/convert-video | formaat (mp4) | the video in another container |
POST /api/merge | files, repeated per video | one joined video |
POST /api/vectorize | modus (color) | image/svg+xml |
POST /api/ebook | doelformaat (MOBI) | the converted e-book |
POST /api/raw | formaat (JPEG) | a camera RAW developed into a normal photo |
/api/raw is only for camera RAW files such as CR2, NEF and ARW. Send it an ordinary JPG and it will tell you so, because that conversion belongs in your browser.
Limits
| Maximum video | 1200 MB. Length limit 20 minutes on /api/gif, /api/audio, /api/mute, /api/volume, /api/rotate, /api/convert-video and, per clip, /api/merge; /api/video (shrink to a target size) has no length limit |
|---|---|
| Maximum camera RAW | 200 MB |
| Requests per day | No cap, except vector tracing (/api/vectorize): 3 a day on the free tier, then 402 until midnight |
| Queue | Two jobs at a time per kind of work (video, e-book, camera RAW, vector tracing). If no slot frees up within 20 seconds (90 for e-books and camera RAW), the call fails with 503 and Busy right now, try again in a moment. |
Errors
Errors come back as JSON with a detail key, so check the status before writing the body to a file.
| Status | Meaning |
|---|---|
400 | The file is not what this endpoint needs, for example an image sent to a video endpoint. |
402 | The free daily vectorizations are used up; the count resets at midnight. |
413 | Over the size limit for that endpoint, or a video longer than 20 minutes. |
422 | A required field is missing. |
503 | Busy right now: both slots for that kind of work were taken for the whole wait. Try again in a moment. |
$ curl -s -F "file=@logo.png" https://convert.shinobitools.com/api/gif
{"detail":"That file has no playable video track."}Using it in your own project
Build on it, including in something you charge for. If your project lists what it uses, a link back to convert.shinobitools.com is what keeps this free. Planning real volume? Say hello on the contact page first.
Questions
Why is there no image conversion API?
Because those conversions happen in your browser and the file never leaves your machine. Putting them on a server would be a downgrade, not a feature.
Do I need an API key?
No. No key, no account, no sign-up.
Is it synchronous?
Yes. The response body is the finished file. No job id, no polling.
Can I trace a photo into an SVG?
You can, but tracing works best on flat artwork such as logos and icons. A photograph turns into thousands of paths and rarely looks good.
Is there an API for converting images?
No, and on purpose. Image conversions such as HEIC to JPG run entirely inside your own browser, so the picture never reaches a server. There is nothing to call. The API covers video, audio, e-books, camera RAW and vector tracing, which need real processing.
Is the response the file itself?
Yes. These endpoints are synchronous: no job id and nothing to poll. Write the response body straight to disk.
What are the size limits?
1200 MB for video and 200 MB for a camera RAW file. There is no daily cap except vector tracing (3 a day on the free tier), and when both slots for a kind of work are busy a call can fail with a 503 after a short wait.
Can I turn a logo into an SVG?
Yes. Post a PNG or JPG to /api/vectorize and you get an SVG back in the same response.
Terms are on the terms page, and what happens to your files is on the privacy page.