{"openapi":"3.1.0","info":{"title":"Splixir Media Transformation API","version":"1.0.0","description":"Managed FFmpeg media transformation API on elastic compute. Submit structured jobs, get back verified files. Failed jobs bill $0.00.","contact":{"name":"Splixir","url":"https://docs.splixir.com"}},"servers":[{"url":"https://api.splixir.com","description":"Splixir API"},{"url":"https://mcp.splixir.com","description":"Splixir Remote MCP Server (Streamable HTTP)"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Jobs","description":"Submit, inspect, verify, and cancel media jobs"},{"name":"Uploads","description":"Pre-signed R2 staging uploads for local files"},{"name":"Billing","description":"Wallet balances and 30-day usage telemetry"},{"name":"System","description":"Health and API discovery"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"splx_live_...","description":"API key created in the Splixir Console (https://console.splixir.com/keys)."}},"schemas":{"ImageOperation":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"resize"},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384},"fit":{"default":"inside","type":"string","enum":["contain","cover","fill","inside","outside"]},"withoutEnlargement":{"default":true,"type":"boolean"},"background":{"type":"string","pattern":"^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"}},"required":["type","fit","withoutEnlargement"],"additionalProperties":false},{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"crop"},"mode":{"type":"string","const":"region"},"x":{"type":"integer","minimum":0,"maximum":9007199254740991},"y":{"type":"integer","minimum":0,"maximum":9007199254740991},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384}},"required":["type","mode","x","y","width","height"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"crop"},"mode":{"type":"string","const":"aspect"},"aspectRatio":{"type":"string","pattern":"^[1-9]\\d{0,3}:[1-9]\\d{0,3}$"},"gravity":{"default":"center","type":"string","enum":["center","north","south","east","west","smart"]}},"required":["type","mode","aspectRatio","gravity"],"additionalProperties":false}]},{"type":"object","properties":{"type":{"type":"string","const":"convert"},"format":{"type":"string","enum":["webp","avif","png","jpeg"]},"quality":{"type":"integer","minimum":1,"maximum":100},"lossless":{"type":"boolean"},"progressive":{"type":"boolean"}},"required":["type","format"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"strip_metadata"},"keepOrientation":{"default":true,"type":"boolean"},"keepColorProfile":{"default":true,"type":"boolean"}},"required":["type","keepOrientation","keepColorProfile"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"rotate"},"angle":{"type":"number","enum":[90,180,270]}},"required":["type","angle"],"additionalProperties":false}]},"CreateImageJobRequest":{"type":"object","properties":{"kind":{"default":"image","type":"string","const":"image"},"input":{"anyOf":[{"type":"string","format":"uri"},{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"],"additionalProperties":false}]},"operations":{"minItems":1,"maxItems":10,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"resize"},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384},"fit":{"default":"inside","type":"string","enum":["contain","cover","fill","inside","outside"]},"withoutEnlargement":{"default":true,"type":"boolean"},"background":{"type":"string","pattern":"^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"}},"required":["type","fit","withoutEnlargement"],"additionalProperties":false},{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"crop"},"mode":{"type":"string","const":"region"},"x":{"type":"integer","minimum":0,"maximum":9007199254740991},"y":{"type":"integer","minimum":0,"maximum":9007199254740991},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384}},"required":["type","mode","x","y","width","height"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"crop"},"mode":{"type":"string","const":"aspect"},"aspectRatio":{"type":"string","pattern":"^[1-9]\\d{0,3}:[1-9]\\d{0,3}$"},"gravity":{"default":"center","type":"string","enum":["center","north","south","east","west","smart"]}},"required":["type","mode","aspectRatio","gravity"],"additionalProperties":false}]},{"type":"object","properties":{"type":{"type":"string","const":"convert"},"format":{"type":"string","enum":["webp","avif","png","jpeg"]},"quality":{"type":"integer","minimum":1,"maximum":100},"lossless":{"type":"boolean"},"progressive":{"type":"boolean"}},"required":["type","format"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"strip_metadata"},"keepOrientation":{"default":true,"type":"boolean"},"keepColorProfile":{"default":true,"type":"boolean"}},"required":["type","keepOrientation","keepColorProfile"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"rotate"},"angle":{"type":"number","enum":[90,180,270]}},"required":["type","angle"],"additionalProperties":false}]}},"output":{"default":{},"type":"object","properties":{"format":{"type":"string","enum":["webp","avif","png","jpeg"]},"quality":{"type":"integer","minimum":1,"maximum":100},"destination":{"type":"string","format":"uri"}},"additionalProperties":false},"callbackUrl":{"type":"string","format":"uri"},"idempotencyKey":{"type":"string","minLength":1,"maxLength":128},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","maxLength":256}},"wait":{"default":false,"type":"boolean"}},"required":["kind","input","operations","output","wait"],"additionalProperties":false},"CreateJobRequest":{"type":"object","properties":{"kind":{"default":"image","type":"string","enum":["image","video","audio"]},"input":{"anyOf":[{"type":"string","format":"uri"},{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"],"additionalProperties":false}]},"operations":{"minItems":1,"maxItems":10,"type":"array","items":{"anyOf":[{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"resize"},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384},"fit":{"default":"inside","type":"string","enum":["contain","cover","fill","inside","outside"]},"withoutEnlargement":{"default":true,"type":"boolean"},"background":{"type":"string","pattern":"^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"}},"required":["type","fit","withoutEnlargement"],"additionalProperties":false},{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"crop"},"mode":{"type":"string","const":"region"},"x":{"type":"integer","minimum":0,"maximum":9007199254740991},"y":{"type":"integer","minimum":0,"maximum":9007199254740991},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384}},"required":["type","mode","x","y","width","height"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"crop"},"mode":{"type":"string","const":"aspect"},"aspectRatio":{"type":"string","pattern":"^[1-9]\\d{0,3}:[1-9]\\d{0,3}$"},"gravity":{"default":"center","type":"string","enum":["center","north","south","east","west","smart"]}},"required":["type","mode","aspectRatio","gravity"],"additionalProperties":false}]},{"type":"object","properties":{"type":{"type":"string","const":"convert"},"format":{"type":"string","enum":["webp","avif","png","jpeg"]},"quality":{"type":"integer","minimum":1,"maximum":100},"lossless":{"type":"boolean"},"progressive":{"type":"boolean"}},"required":["type","format"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"strip_metadata"},"keepOrientation":{"default":true,"type":"boolean"},"keepColorProfile":{"default":true,"type":"boolean"}},"required":["type","keepOrientation","keepColorProfile"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"rotate"},"angle":{"type":"number","enum":[90,180,270]}},"required":["type","angle"],"additionalProperties":false}]},{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"transcode"},"codec":{"type":"string","enum":["h264","hevc","av1"]},"resolution":{"type":"string","enum":["540p","720p","1080p","1440p","4k","8k"]},"quality":{"default":"balanced","type":"string","enum":["draft","balanced","best"]}},"required":["type","codec","resolution","quality"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"trim"},"startSeconds":{"type":"number","minimum":0},"endSeconds":{"type":"number","exclusiveMinimum":0},"durationSeconds":{"type":"number","exclusiveMinimum":0}},"required":["type","startSeconds"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"thumbnail"},"timestampSeconds":{"default":0,"type":"number","minimum":0},"format":{"default":"jpeg","type":"string","enum":["webp","avif","png","jpeg"]},"width":{"type":"integer","minimum":1,"maximum":16384}},"required":["type","timestampSeconds","format"],"additionalProperties":false}]},{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"convert"},"format":{"type":"string","enum":["mp3","aac","flac","opus","wav"]},"bitrateKbps":{"type":"integer","minimum":32,"maximum":1411},"sampleRateHz":{"type":"integer","minimum":8000,"maximum":192000}},"required":["type","format"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"normalize"},"targetLufs":{"default":-14,"type":"number","minimum":-70,"maximum":0},"truePeakDbtp":{"default":-1,"type":"number","minimum":-10,"maximum":0}},"required":["type","targetLufs","truePeakDbtp"],"additionalProperties":false}]}]}},"output":{"default":{},"type":"object","properties":{"format":{"type":"string","enum":["webp","avif","png","jpeg"]},"quality":{"type":"integer","minimum":1,"maximum":100},"destination":{"type":"string","format":"uri"}},"additionalProperties":false},"callbackUrl":{"type":"string","format":"uri"},"idempotencyKey":{"type":"string","minLength":1,"maxLength":128},"metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","maxLength":256}},"wait":{"default":false,"type":"boolean"}},"required":["kind","input","operations","output","wait"],"additionalProperties":false},"VerificationReport":{"type":"object","properties":{"verified":{"type":"boolean"},"engine":{"type":"string"},"inputProbe":{"type":"object","properties":{"width":{"type":"integer","minimum":0,"maximum":9007199254740991},"height":{"type":"integer","minimum":0,"maximum":9007199254740991},"format":{"type":"string"},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"hasExif":{"type":"boolean"},"colorSpace":{"type":"string"}},"required":["width","height","format","bytes","hasExif","colorSpace"],"additionalProperties":false},"outputProbe":{"type":"object","properties":{"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"format":{"type":"string","enum":["webp","avif","png","jpeg"]},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"exifStripped":{"type":"boolean"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["width","height","format","bytes","exifStripped","sha256"],"additionalProperties":false},"checks":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"passed":{"type":"boolean"},"detail":{"type":"string"}},"required":["name","passed"],"additionalProperties":false}},"timingsMs":{"type":"object","properties":{"probe":{"type":"number","minimum":0},"download":{"type":"number","minimum":0},"transform":{"type":"number","minimum":0},"verify":{"type":"number","minimum":0},"upload":{"type":"number","minimum":0},"total":{"type":"number","minimum":0}},"required":["probe","download","transform","verify","upload","total"],"additionalProperties":false}},"required":["verified","engine","inputProbe","outputProbe","checks","timingsMs"],"additionalProperties":false},"JobResponse":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","video","audio"]},"state":{"type":"string","enum":["accepted","probing","rejected","queued","provisioning","running","verifying","delivered","failed","canceled"]},"input":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"],"additionalProperties":false},"operations":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"resize"},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384},"fit":{"default":"inside","type":"string","enum":["contain","cover","fill","inside","outside"]},"withoutEnlargement":{"default":true,"type":"boolean"},"background":{"type":"string","pattern":"^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"}},"required":["type","fit","withoutEnlargement"],"additionalProperties":false},{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"crop"},"mode":{"type":"string","const":"region"},"x":{"type":"integer","minimum":0,"maximum":9007199254740991},"y":{"type":"integer","minimum":0,"maximum":9007199254740991},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384}},"required":["type","mode","x","y","width","height"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"crop"},"mode":{"type":"string","const":"aspect"},"aspectRatio":{"type":"string","pattern":"^[1-9]\\d{0,3}:[1-9]\\d{0,3}$"},"gravity":{"default":"center","type":"string","enum":["center","north","south","east","west","smart"]}},"required":["type","mode","aspectRatio","gravity"],"additionalProperties":false}]},{"type":"object","properties":{"type":{"type":"string","const":"convert"},"format":{"type":"string","enum":["webp","avif","png","jpeg"]},"quality":{"type":"integer","minimum":1,"maximum":100},"lossless":{"type":"boolean"},"progressive":{"type":"boolean"}},"required":["type","format"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"strip_metadata"},"keepOrientation":{"default":true,"type":"boolean"},"keepColorProfile":{"default":true,"type":"boolean"}},"required":["type","keepOrientation","keepColorProfile"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"rotate"},"angle":{"type":"number","enum":[90,180,270]}},"required":["type","angle"],"additionalProperties":false}]},{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"transcode"},"codec":{"type":"string","enum":["h264","hevc","av1"]},"resolution":{"type":"string","enum":["540p","720p","1080p","1440p","4k","8k"]},"quality":{"default":"balanced","type":"string","enum":["draft","balanced","best"]}},"required":["type","codec","resolution","quality"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"trim"},"startSeconds":{"type":"number","minimum":0},"endSeconds":{"type":"number","exclusiveMinimum":0},"durationSeconds":{"type":"number","exclusiveMinimum":0}},"required":["type","startSeconds"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"thumbnail"},"timestampSeconds":{"default":0,"type":"number","minimum":0},"format":{"default":"jpeg","type":"string","enum":["webp","avif","png","jpeg"]},"width":{"type":"integer","minimum":1,"maximum":16384}},"required":["type","timestampSeconds","format"],"additionalProperties":false}]},{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"convert"},"format":{"type":"string","enum":["mp3","aac","flac","opus","wav"]},"bitrateKbps":{"type":"integer","minimum":32,"maximum":1411},"sampleRateHz":{"type":"integer","minimum":8000,"maximum":192000}},"required":["type","format"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"normalize"},"targetLufs":{"default":-14,"type":"number","minimum":-70,"maximum":0},"truePeakDbtp":{"default":-1,"type":"number","minimum":-10,"maximum":0}},"required":["type","targetLufs","truePeakDbtp"],"additionalProperties":false}]}]}},"output":{"type":"object","properties":{"format":{"type":"string"},"destination":{"type":"string","format":"uri"},"downloadUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"additionalProperties":false},"verificationReport":{"type":"object","properties":{"verified":{"type":"boolean"},"engine":{"type":"string"},"inputProbe":{"type":"object","properties":{"width":{"type":"integer","minimum":0,"maximum":9007199254740991},"height":{"type":"integer","minimum":0,"maximum":9007199254740991},"format":{"type":"string"},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"hasExif":{"type":"boolean"},"colorSpace":{"type":"string"}},"required":["width","height","format","bytes","hasExif","colorSpace"],"additionalProperties":false},"outputProbe":{"type":"object","properties":{"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"format":{"type":"string","enum":["webp","avif","png","jpeg"]},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"exifStripped":{"type":"boolean"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["width","height","format","bytes","exifStripped","sha256"],"additionalProperties":false},"checks":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"passed":{"type":"boolean"},"detail":{"type":"string"}},"required":["name","passed"],"additionalProperties":false}},"timingsMs":{"type":"object","properties":{"probe":{"type":"number","minimum":0},"download":{"type":"number","minimum":0},"transform":{"type":"number","minimum":0},"verify":{"type":"number","minimum":0},"upload":{"type":"number","minimum":0},"total":{"type":"number","minimum":0}},"required":["probe","download","transform","verify","upload","total"],"additionalProperties":false}},"required":["verified","engine","inputProbe","outputProbe","checks","timingsMs"],"additionalProperties":false},"costMicros":{"type":"integer","minimum":0,"maximum":9007199254740991},"costUsd":{"type":"number","minimum":0},"billed":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"completedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["id","kind","state","input","operations","output","costMicros","costUsd","billed","createdAt","updatedAt"],"additionalProperties":false},"ListJobsResponse":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","video","audio"]},"state":{"type":"string","enum":["accepted","probing","rejected","queued","provisioning","running","verifying","delivered","failed","canceled"]},"input":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"],"additionalProperties":false},"operations":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"resize"},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384},"fit":{"default":"inside","type":"string","enum":["contain","cover","fill","inside","outside"]},"withoutEnlargement":{"default":true,"type":"boolean"},"background":{"type":"string","pattern":"^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"}},"required":["type","fit","withoutEnlargement"],"additionalProperties":false},{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"crop"},"mode":{"type":"string","const":"region"},"x":{"type":"integer","minimum":0,"maximum":9007199254740991},"y":{"type":"integer","minimum":0,"maximum":9007199254740991},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384}},"required":["type","mode","x","y","width","height"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"crop"},"mode":{"type":"string","const":"aspect"},"aspectRatio":{"type":"string","pattern":"^[1-9]\\d{0,3}:[1-9]\\d{0,3}$"},"gravity":{"default":"center","type":"string","enum":["center","north","south","east","west","smart"]}},"required":["type","mode","aspectRatio","gravity"],"additionalProperties":false}]},{"type":"object","properties":{"type":{"type":"string","const":"convert"},"format":{"type":"string","enum":["webp","avif","png","jpeg"]},"quality":{"type":"integer","minimum":1,"maximum":100},"lossless":{"type":"boolean"},"progressive":{"type":"boolean"}},"required":["type","format"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"strip_metadata"},"keepOrientation":{"default":true,"type":"boolean"},"keepColorProfile":{"default":true,"type":"boolean"}},"required":["type","keepOrientation","keepColorProfile"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"rotate"},"angle":{"type":"number","enum":[90,180,270]}},"required":["type","angle"],"additionalProperties":false}]},{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"transcode"},"codec":{"type":"string","enum":["h264","hevc","av1"]},"resolution":{"type":"string","enum":["540p","720p","1080p","1440p","4k","8k"]},"quality":{"default":"balanced","type":"string","enum":["draft","balanced","best"]}},"required":["type","codec","resolution","quality"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"trim"},"startSeconds":{"type":"number","minimum":0},"endSeconds":{"type":"number","exclusiveMinimum":0},"durationSeconds":{"type":"number","exclusiveMinimum":0}},"required":["type","startSeconds"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"thumbnail"},"timestampSeconds":{"default":0,"type":"number","minimum":0},"format":{"default":"jpeg","type":"string","enum":["webp","avif","png","jpeg"]},"width":{"type":"integer","minimum":1,"maximum":16384}},"required":["type","timestampSeconds","format"],"additionalProperties":false}]},{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"convert"},"format":{"type":"string","enum":["mp3","aac","flac","opus","wav"]},"bitrateKbps":{"type":"integer","minimum":32,"maximum":1411},"sampleRateHz":{"type":"integer","minimum":8000,"maximum":192000}},"required":["type","format"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"normalize"},"targetLufs":{"default":-14,"type":"number","minimum":-70,"maximum":0},"truePeakDbtp":{"default":-1,"type":"number","minimum":-10,"maximum":0}},"required":["type","targetLufs","truePeakDbtp"],"additionalProperties":false}]}]}},"output":{"type":"object","properties":{"format":{"type":"string"},"destination":{"type":"string","format":"uri"},"downloadUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"additionalProperties":false},"verificationReport":{"type":"object","properties":{"verified":{"type":"boolean"},"engine":{"type":"string"},"inputProbe":{"type":"object","properties":{"width":{"type":"integer","minimum":0,"maximum":9007199254740991},"height":{"type":"integer","minimum":0,"maximum":9007199254740991},"format":{"type":"string"},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"hasExif":{"type":"boolean"},"colorSpace":{"type":"string"}},"required":["width","height","format","bytes","hasExif","colorSpace"],"additionalProperties":false},"outputProbe":{"type":"object","properties":{"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"format":{"type":"string","enum":["webp","avif","png","jpeg"]},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"exifStripped":{"type":"boolean"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["width","height","format","bytes","exifStripped","sha256"],"additionalProperties":false},"checks":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"passed":{"type":"boolean"},"detail":{"type":"string"}},"required":["name","passed"],"additionalProperties":false}},"timingsMs":{"type":"object","properties":{"probe":{"type":"number","minimum":0},"download":{"type":"number","minimum":0},"transform":{"type":"number","minimum":0},"verify":{"type":"number","minimum":0},"upload":{"type":"number","minimum":0},"total":{"type":"number","minimum":0}},"required":["probe","download","transform","verify","upload","total"],"additionalProperties":false}},"required":["verified","engine","inputProbe","outputProbe","checks","timingsMs"],"additionalProperties":false},"costMicros":{"type":"integer","minimum":0,"maximum":9007199254740991},"costUsd":{"type":"number","minimum":0},"billed":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"additionalProperties":false},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"completedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["id","kind","state","input","operations","output","costMicros","costUsd","billed","createdAt","updatedAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["jobs","nextCursor"],"additionalProperties":false},"BalanceResponse":{"type":"object","properties":{"totalAvailableMicros":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalAvailableUsd":{"type":"number","minimum":0},"promoMicros":{"type":"integer","minimum":0,"maximum":9007199254740991},"promoGrants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"reason":{"type":"string"},"initialMicros":{"type":"integer","minimum":0,"maximum":9007199254740991},"remainingMicros":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["id","reason","initialMicros","remainingMicros","expiresAt","createdAt"],"additionalProperties":false}},"subscriptionMicros":{"type":"integer","minimum":0,"maximum":9007199254740991},"subscription":{"type":"object","properties":{"planTier":{"anyOf":[{"type":"string","enum":["starter","growth","scale","studio"]},{"type":"null"}]},"status":{"type":["string","null"]},"resetsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},{"type":"null"}]}},"required":["planTier","status","resetsAt"],"additionalProperties":false},"purchasedMicros":{"type":"integer","minimum":0,"maximum":9007199254740991},"reservedMicros":{"type":"integer","minimum":0,"maximum":9007199254740991},"spendOrder":{"default":["promo","subscription","purchased"],"type":"array","prefixItems":[{"type":"string","const":"promo"},{"type":"string","const":"subscription"},{"type":"string","const":"purchased"}],"items":false,"minItems":3,"maxItems":3}},"required":["totalAvailableMicros","totalAvailableUsd","promoMicros","promoGrants","subscriptionMicros","subscription","purchasedMicros","reservedMicros","spendOrder"],"additionalProperties":false},"PresignUploadRequest":{"type":"object","properties":{"filename":{"type":"string","default":"upload.bin"},"contentType":{"type":"string","example":"image/jpeg"},"bytes":{"type":"integer","minimum":1,"maximum":52428800}}},"PresignUploadResponse":{"type":"object","required":["uploadUrl","inputUrl","key","expiresInSeconds"],"properties":{"uploadUrl":{"type":"string","format":"uri"},"inputUrl":{"type":"string","format":"uri"},"key":{"type":"string"},"expiresInSeconds":{"type":"integer"}}},"ErrorResponse":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"details":{}}}}},"paths":{"/health":{"get":{"tags":["System"],"summary":"Health check","security":[],"responses":{"200":{"description":"Service healthy","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"}}}}}}}}},"/v1/jobs":{"post":{"tags":["Jobs"],"summary":"Create a structured media transformation job","description":"Runs edge SSRF + magic-byte pre-flight probe ($0 if rejected), reserves estimated microdollars, and dispatches to elastic compute. Pass wait=true to wait up to 25s for synchronous completion.","parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Wait up to 25s for synchronous completion and return 200 OK."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateImageJobRequest"},"example":{"kind":"image","input":{"url":"https://example.com/photo.jpg"},"operations":[{"type":"resize","width":1200,"fit":"inside","withoutEnlargement":true},{"type":"strip_metadata","keepOrientation":true,"keepColorProfile":true},{"type":"convert","format":"webp","quality":82}],"wait":true}}}},"responses":{"200":{"description":"Job completed synchronously within 25s","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"202":{"description":"Job accepted and queued for asynchronous processing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"402":{"description":"Insufficient wallet balance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Pre-flight probe rejected input ($0 billed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"501":{"description":"Requested media kind (video/audio) is coming soon","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Jobs"],"summary":"List jobs for the authenticated account","parameters":[{"name":"state","in":"query","schema":{"type":"string"}},{"name":"kind","in":"query","schema":{"type":"string","enum":["image","video","audio"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated job list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListJobsResponse"}}}}}}},"/v1/jobs/{id}":{"get":{"tags":["Jobs"],"summary":"Get a job by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Job details including downloadUrl and verificationReport when delivered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"404":{"description":"Job not found"}}},"delete":{"tags":["Jobs"],"summary":"Cancel an active job and release its wallet reservation ($0 billed)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Job canceled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"409":{"description":"Job already delivered"}}}},"/v1/jobs/{id}/report":{"get":{"tags":["Jobs"],"summary":"Get the VerificationReport for a job","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Verification report","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationReport"}}}},"404":{"description":"Job or report not found"},"409":{"description":"Job has not completed yet"}}}},"/v1/uploads/presign":{"post":{"tags":["Uploads"],"summary":"Create a pre-signed R2 staging upload URL for local files","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignUploadRequest"}}}},"responses":{"200":{"description":"Presigned PUT uploadUrl and readable inputUrl","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignUploadResponse"}}}}}}},"/v1/balance":{"get":{"tags":["Billing"],"summary":"Get current wallet balance breakdown","responses":{"200":{"description":"Wallet balance in integer microdollars and USD","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BalanceResponse"}}}}}}},"/v1/usage":{"get":{"tags":["Billing"],"summary":"Get 30-day job and spend telemetry summary","responses":{"200":{"description":"Usage summary","content":{"application/json":{"schema":{"type":"object","properties":{"periodDays":{"type":"integer"},"totalJobs":{"type":"integer"},"deliveredJobs":{"type":"integer"},"failedJobs":{"type":"integer"},"rejectedJobs":{"type":"integer"},"totalCostMicros":{"type":"integer"},"totalCostUsd":{"type":"number"}}}}}}}}}}}