Çĥööšé à ţŕàñšļàţîöñ ḿöđéļ

Ĝöàļ: þöîñţ kapi àţ ţĥé ḿöđéļ ýöü ŵàñţ (ƒöŕ kapi up, kapi translate, àñđ éṽéŕý ÀÎ-ƃàçķéđ šţéþ), šüþþļý àñý çŕéđéñţîàļ šàƒéļý, àñđ ḿàķé ţĥé çĥöîçé à đéƒàüļţ šö ýöü šţöþ ŕéþéàţîñĝ ƒļàĝš. Ƒöŕ ţĥé çöñçéþţ (ĥöŵ ţŕàñšļàţîöñ ŵöŕķš àš à šîñĝļé ţööļ) šéé Ţŕàñšļàţîöñ. Ţĥé šàṽéđ đéƒàüļţ îš šĥàŕéđ ƃéţŵééñ ţĥé ÇĻÎ àñđ Kapi Đéšķţöþ; îñ à þŕöĵéçţ, šéţ îţ öñçé îñ ţĥé ŕéçîþé defaults àñđ éṽéŕý ƒļöŵ îñĥéŕîţš îţ.

Đéšķţöþ

1. Çöññéçţ ýöüŕ ÀÎ. Öñ ƒîŕšţ öþéñ, à çàŕđ öƒƒéŕš ŵĥàţ ţĥé àþþ đéţéçţš (à Çļàüđé Çöđé šîĝñ-îñ ţĥàţ üšéš ýöüŕ Çļàüđé šüƃšçŕîþţîöñ, öŕ à ļöçàļ Öļļàḿà ḿöđéļ) îñ öñé çļîçķ, ñöţĥîñĝ šţöŕéđ.
2. Àđđ àñ ÀÞÎ ķéý öñļý ŵĥéñ ýöü ñééđ öñé. Šéţţîñĝš → ÀÎ Ḿöđéļš ĥöļđš ţĥé çŕéđéñţîàļš: þîçķ ţĥé þŕöṽîđéŕ (Àñţĥŕöþîç, ÖþéñÀÎ, Ĝéḿîñî, …) àñđ þàšţé ţĥé ķéý öñçé; îţ ļàñđš îñ ţĥé ÖŠ ķéýçĥàîñ, ñéṽéŕ îñ ţĥé çöḿḿîţţéđ ŕéçîþé. Šéé Šţöŕé ÀÎ çŕéđéñţîàļš.
3. Éṽéŕý ŕüñ ŕéšöļṽéš îţ. Ƒļöŵš, ǫüîçķ ţööļš, àñđ Ƃŕîñĝ üþ ţö đàţé þîçķ üþ ţĥé çöñƒîĝüŕéđ þŕöṽîđéŕ àüţöḿàţîçàļļý, àñđ ţĥé šàḿé šàṽéđ đéƒàüļţ ƃàçķš ÇĻÎ ŕüñš öƒ ţĥé þŕöĵéçţ.

Àĝéñţ (Çļàüđé)

Ŵöŕķîñĝ îñ Çļàüđé (šķîļļ öŕ ḾÇÞ) ñééđš ñö þŕöṽîđéŕ àţ àļļ: Çļàüđé îš ţĥé ŵŕîţéŕ, kapi àþþļîéš àñđ çĥéçķš, ŵîţĥ ñö šéçöñđ ḿöđéļ àñđ ñö ķéý. À þŕöṽîđéŕ öñļý éñţéŕš ŵĥéñ kapi îţšéļƒ ḿüšţ ţŕàñšļàţé (àñ üñàţţéñđéđ kapi up, à ƒļöŵ ŵîţĥ à translate šţéþ). Ţĥéñ àšķ:

Šéţ üþ kapi'š ÀÎ þŕöṽîđéŕ öñ ţĥîš ḿàçĥîñé.

Ţĥé àššîšţàñţ ŕüñš kapi models setup, ŵĥîçĥ đéţéçţš îţš öŵñ šîĝñ-îñ ƒîŕšţ: ýöüŕ Çļàüđé šüƃšçŕîþţîöñ ƃéçöḿéš kapi'š þŕöṽîđéŕ ŵîţĥ öñé çöñƒîŕḿ, ñö ķéý. Šüƃšçŕîþţîöñ àüţĥ îš üšàĝé-ŵîñđöŵ-ļîḿîţéđ àñđ ƃöüñđ ţö ýöüŕ šîĝñ-îñ, šö ƒöŕ ÇÎ îţ ŵîļļ þöîñţ ýöü ţö àñ ÀÞÎ ķéý îñšţéàđ.

ÇĻÎ

Šţàŕţ ŵîţĥ đéţéçţîöñ, üšüàļļý öñé çöñƒîŕḿ ŕàţĥéŕ ţĥàñ à ķéý þàšţé:

kapi models setup     # detect, pick, verify with a test call, save the default

Îţ ļööķš ƒöŕ, îñ öŕđéŕ: à Çļàüđé Çöđé šîĝñ-îñ (üšéš ýöüŕ Çļàüđé šüƃšçŕîþţîöñ; ñöţ ƒöŕ ÇÎ); ÀÞÎ ķéýš àļŕéàđý îñ ţĥé éñṽîŕöñḿéñţ (Àñţĥŕöþîç, ÖþéñÀÎ, Ĝéḿîñî; ţĥé ŕîĝĥţ çĥöîçé ƒöŕ ÇÎ); àñđ à ŕüññîñĝ Öļļàḿà šéŕṽéŕ (ļöçàļ, öñ-đéṽîçé ḿöđéļš).

Þîçķ éẋþļîçîţļý. --provider šéļéçţš ţĥé ƃàçķéñđ, --model à ḿöđéļ ŵîţĥîñ îţ; kapi models list šĥöŵš éṽéŕýţĥîñĝ kapi çàñ üšé: đéţéçţéđ ķéýļéšš þŕöṽîđéŕš, ļöçàļ Öļļàḿà ḿöđéļš, þļüĝîñ ḿöđéļš, àñđ çļöüđ þŕöṽîđéŕš:

kapi models list
kapi translate input.html --target-lang fr --provider anthropic --model claude-sonnet-5

Ţĥé đéƒàüļţ þŕöṽîđéŕ îš anthropic; openai, gemini, azureopenai, àñđ öñ-đéṽîçé ollama àŕé ƃüîļţ îñ, àñđ ţĥé ĝéñéŕàţéđ ţööļ ŕéƒéŕéñçé ļîšţš ţĥé çüŕŕéñţ þàŕàḿéţéŕš àñđ đéƒàüļţ ḿöđéļ ƒöŕ éàçĥ. Ţĥé ķéýļéšš demo þŕöṽîđéŕ þŕöđüçéš đéţéŕḿîñîšţîç, çļéàŕļý-ḿàŕķéđ îļļüšţŕàţîṽé öüţþüţ ƒöŕ ţŕýîñĝ ƒļöŵš àñđ ÇÎ šḿöķé ţéšţš, ñéṽéŕ ƒöŕ ŕéàļ ţŕàñšļàţîöñ.

Šüþþļý à ķéý šàƒéļý. À ķéý îš ñéṽéŕ ŕéàđ ƒŕöḿ ţĥé kapi.yaml ŕéçîþé, šö ţĥé ŕéçîþé šţàýš šàƒé ţö çöḿḿîţ. Ŕéšöļüţîöñ öŕđéŕ: îñļîñé --api-key, ţĥéñ à šàṽéđ --credential, ţĥéñ ţĥé þŕöṽîđéŕ'š éñṽîŕöñḿéñţ ṽàŕîàƃļé (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY ţĥéñ GOOGLE_API_KEY, AZURE_OPENAI_API_KEY):

kapi credentials add my-anthropic --provider anthropic --api-key …   # once, into the OS keychain
kapi translate input.html --target-lang fr --credential my-anthropic

À šéļƒ-ĥöšţéđ öŕ þŕîṽàţé-çļöüđ éñđþöîñţ ţŕàṽéļš ŵîţĥ ţĥé ķéý. --base-url îš þàŕţ öƒ ţĥé šàṽéđ çŕéđéñţîàļ ŕàţĥéŕ ţĥàñ öƒ ţĥé ŕéçîþé: à çöḿḿîţţéđ ƒîļé ḿüšţ ñöţ ƃé àƃļé ţö đéçîđé ŵĥéŕé ýöüŕ ķéý îš šéñţ. Ţĥàţ àļšö ḿéàñš à çüšţöḿ éñđþöîñţ ţàķéš éƒƒéçţ öñļý öñ ţĥé --credential ŕöüţé: àñ îñļîñé --api-key, öŕ à ķéý þîçķéđ üþ ƒŕöḿ ţĥé éñṽîŕöñḿéñţ, ŕéšöļṽéš ƃéƒöŕé àñ éñđþöîñţ îš àţţàçĥéđ àñđ çàļļš ţĥé þŕöṽîđéŕ'š þüƃļîç ĥöšţ. Šàṽé ƃöţĥ ţöĝéţĥéŕ àñđ ñàḿé ţĥé çŕéđéñţîàļ:

kapi credentials add internal-mt --provider openai --api-key … --base-url https://mt.internal.example/v1
kapi translate input.html --target-lang fr --credential internal-mt

Ḿàķé îţ ţĥé đéƒàüļţ, ĝļöƃàļļý öŕ þéŕ þŕöĵéçţ îñ ţĥé ŕéçîþé (šàƒé ţö çöḿḿîţ; îţ çàŕŕîéš ñö ķéý). Àñ éẋþļîçîţ --provider ƒļàĝ, îñļîñé šţéþ çöñƒîĝ, öŕ ŕéçîþé đéƒàüļţ öṽéŕŕîđéš ţĥé šţöŕéđ ṽàļüé:

kapi config set ai.provider ollama
kapi config set ai.model llama3.2:3b

defaults:
  tools:
    translate:
      provider: ollama
      model: llama3.2:3b

Ţŕàñšļàţé öñ-đéṽîçé ŵîţĥ Öļļàḿà: ñö ķéý, ñöţĥîñĝ šéñţ ţö à šéŕṽéŕ; kapi çĥéçķš ţĥé ŕüñţîḿé îš üþ àñđ þüļļš à ḿîššîñĝ ḿöđéļ îţšéļƒ:

kapi models ollama install                # platform-specific install guidance
kapi models ollama pull llama3.2:3b       # download a translation model
kapi translate input.html --target-lang fr --provider ollama --model llama3.2:3b

llama3.2:3b îš à šţŕöñĝ, ļîĝĥţŵéîĝĥţ đéƒàüļţ; qwen3:1.7b îš ƒàšţéŕ àñđ šḿàļļéŕ; gemma4:e2b îš ţĥé ǫüàļîţý þîçķ ƒöŕ ţöüĝĥéŕ ḿüļţîļîñĝüàļ ĝŕàḿḿàŕ.

Ñéẋţ

• Üšé ŵîţĥ Çļàüđé: ƃöţĥ đîŕéçţîöñš; Çļàüđé đŕîṽéš kapi, öŕ kapi ŕüñš Çļàüđé.
• Ŕéüšé ŵĥàţ ýöü'ṽé ţŕàñšļàţéđ: ļéṽéŕàĝé þàšţ ŵöŕķ ƃéƒöŕé àñý þŕöṽîđéŕ šééš çöñţéñţ.
• Šĥîþ ĝàţéš & ÇÎ: ĝàţé ǫüàļîţý öñçé à þŕöṽîđéŕ îš ŵîŕéđ.