kapi translate
kapi translate [files...]Oversett filer gjennom den innebygde oversettelsesflyten: gjenbruk et bundet content memory først (ingen operasjon uten ett), oversett resten med den konfigurerte AI-leverandøren, og kjør deretter de deterministiske kontrollene (plasshodere, inline-koder, uoversatt tekst) over det som ble produsert.
Dette er den sikrede stavemåten: den samme tre-trinns flyten 'kapi up' looper over et prosjekt, brukt på ad hoc-filer. Det rå oversettelsesverktøyet (ingen Memory-pass, ingen kontroller) er fortsatt tilgjengelig som 'kapi exec translate'. For å holde et helt prosjekt oppdatert, bruk 'kapi up'.
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 translate messages.json --target-lang frFlags
| Flag | Type | Default | Description |
|---|---|---|---|
| --api-key | string | API-nøkkel for AI-leverandøren | |
| --batching | string | hvor mange blokker som deler ett LLM-kall: auto (standard), single | |
| --concurrency , -j | int | 0 | antall filer som behandles samtidig (0 = auto) |
| --context | string | hva modellen får vite om en blokk utover blokken: none, key (standard), neighbours | |
| --credential | string | navn på lagret legitimasjon som skal brukes (se 'kapi credentials list') | |
| --encoding , -e | string | tegnkoding for inndatafil | |
| --engine | string | format engine for detected files: native or a plugin name (default: native, then plugins) | |
| --explain | bool | false | skriv ut de løste kilde → mål-bindingene og avslutt uten å kjøre |
| --fail-on-unknown | bool | false | avslutt med feil hvis en fil ikke kan behandles (standard: hopp over med en advarsel) |
| --format , -f | string | overstyr gjenkjenning av inngangsformat | |
| --input , -i | stringSlice | innfilsti(er); gjenta for flere filer | |
| --instruction | string | ekstra veiledning til modellen under oversettelse (f.eks. "uformelt register; behold produktnavn på engelsk") | |
| --memory | string | navngitt Memory for resirkuleringsflyt (løses fra KAPI_HOME) | |
| --model | string | navn på AI-modell | |
| --output , -o | string | utdatasti eller mal (f.eks. ./out/{name}_{lang}.{ext}) | |
| --pack | bool | false | når du transformerer en .kpz, skriv også resultatet tilbake til .kpz (auto-pack) |
| --parallel-blocks | int | 0 | fordel blokkbehandling på N goroutiner (0 = av) |
| --print-ops | bool | false | write no file and print the change set the run would apply, for kapi apply |
| --progress | string | strøm fremdriftshendelser til stderr som NDJSON (verdi: jsonl); hendelser bruker vokabularet for flyt-kjøringshendelser | |
| --project , -p | string | sti til en kapi.yaml-prosjektoppskrift eller dens mappe (oppdages automatisk fra cwd hvis utelatt) | |
| --provider | string | anthropic | AI-leverandør (anthropic, openai, ollama) |
| --source-lang | string | kildespråk (f.eks. en, en-US; standard er prosjektets source_language, ellers en) | |
| --stats | bool | false | inkluder del-/blokkantall i utdata |
| --strict | bool | false | alias for --fail-on-unknown |
| --target-lang | string | målspråk (f.eks. fr, de-DE) | |
| --termstore | string | navngitt termlager for term-oppslag/håndhevelse (løses fra KAPI_HOME) | |
| --trace | string | skriv flyt-sporing som JSON til fil (for flytvisualisering) |
More examples
kapi translate docs/*.md --target-lang de -o out/{name}_{lang}.{ext} kapi translate app.xliff --target-lang ja --provider ollama← Back to the Command Reference