Skip to main content

kapi exec media-refine

kapi media-refine [files...]

Re-read low-confidence OCR/ASR lines with a configurable multimodal LLM

Commandexec media-refine
Try it (demo)

Demo mode — illustrative output from a built-in stub, not a real model. Install the CLI to run with your own API key.

kapi exec media-refine
Flags
FlagTypeDefaultDescription
--api-keystringAPI key for the AI provider
--concurrency, -jint0max parallel files (0 = auto)
--credentialstringsaved credential name to use (see 'kapi credentials list')
--encoding, -estringUTF-8input file encoding
--fail-on-unknownboolfalseexit with error if any file cannot be processed (default: skip with warning)
--format, -fstringoverride input format detection
--jsonboolfalseoutput results as JSON
--map, -mstringArraymap glob pattern to format (e.g. '*.docx=okf_openxml:test')
--modelstringMultimodal model name
--no-warnboolfalsesuppress warnings for skipped files
--output, -ostringoutput path template (variables: {dir}, {name}, {ext}, {lang})
--output-dirstringwrite outputs under DIR/{lang}/ (default: beside the input, mirroring its locale layout)
--packboolfalsewhen transforming a .kpz, also eject the result to the .kpz (auto-pack)
--parallel-blocksint0fan out block processing across N goroutines (0 = off)
--progress, -pboolfalseshow progress bar
--providerstringanthropicMultimodal AI provider (Anthropic, OpenAI, Gemini, Azure OpenAI, Claude Code, Ollama, Demo (illustrative))
--source-langstringensource language (e.g. en, en-US)
--strictboolfalsealias for --fail-on-unknown
--target-langstringtarget language (e.g. fr, de-DE)
--thresholdfloat640.85Re-read extracted lines whose confidence is below this
--tracestringwrite flow trace JSON to file (for flow visualization)

← Back to the Command Reference