Skip to main content
POST /api/v1/convert Convert or resize one file. Conversion doesn’t spend credits. It still needs a key — every plan, Cyclops included, can mint one. Send the bytes, a URL, a job_id from an earlier call, or the asset_id of a file in the Vault. The call waits until the job finishes unless you send wait=false. Image default is webp. Video default is mp4. Anything else is 400 unsupported_format.
Output URLs are signed and expire after ten minutes. Read the job again for fresh ones.
Audio isn’t converted here. Use audio skills. Documents use convert-document, not this endpoint. Both are 400 unsupported_media.