
Kimi K3 API Guide: Pricing, 1M Context, Model IDs & Production Fit

Kimi K3 at a glance
The table below contains only information documented by Moonshot on July 16, 2026.
| Field | Confirmed Kimi K3 information | Why developers should care |
|---|---|---|
| Direct API model ID | kimi-k3 | Moonshot customers can use the documented direct route; this is not an EvoLink route confirmation |
| Parameter count | 2.8 trillion parameters | K3 is a very large flagship model, but Moonshot has not published every architectural detail needed for self-hosting estimates |
| Architecture | Kimi Delta Attention plus Attention Residuals | The architecture is designed to improve efficiency and long-context reasoning |
| Context window | 1,048,576 tokens | Supports whole-repository, multi-document, and long-running agent workloads |
| Input modalities | Text, images, and video | Useful for code screenshots, diagrams, design reviews, documents, and multimodal research |
| Reasoning behavior | Always enabled | Simple tasks may incur more latency and output cost than they would on a lighter model |
| Reasoning control | reasoning_effort="max" only at launch | Applications cannot yet select a cheaper or faster reasoning tier |
| Tool controls | Tool calling, tool_choice, and dynamic tool loading | Makes K3 relevant for agents with large or changing tool catalogs |
| Structured output | JSON Mode and strict JSON Schema response formats | Useful for extraction, workflow state, and machine-readable agent results |
| Context caching | Automatically applied | Stable long prefixes can substantially reduce input cost |
| Open weights | Not publicly confirmed in the official sources reviewed | Do not call K3 open source or self-hostable yet |
Kimi K3 model IDs depend on the access channel
The string used to call K3 is not universal. Moonshot's direct developer platform and the Kimi Code subscription product use different identifiers, entitlements, and billing systems.
| Access channel | Model ID | Context and access | Billing model |
|---|---|---|---|
| Moonshot Open Platform API | kimi-k3 | Direct API, documented up to 1,048,576 tokens | Token-based API billing |
| Kimi Code | k3 | Moderato: up to 256K; Allegretto and higher: up to 1M | Membership quota |
| Kimi Code standard coding route | kimi-for-coding | K2.7 Code, up to 256K | Membership quota |
| Kimi Code high-speed route | kimi-for-coding-highspeed | K2.7 Code high speed, up to 256K | Allegretto or higher; consumes quota faster |
| EvoLink | Not yet published | Expected on July 17, 2026 after route verification | EvoLink price not yet published |
kimi-k3 when following Moonshot Open Platform API examples. Use k3 only in supported Kimi Code clients. Most importantly, kimi-for-coding is a K2.7 Code route, not an alias for K3.Kimi Code's plan limits also explain why two developers can select K3 but see different context capacity. The official Kimi Code documentation lists no K3 access for Andante, a 256K K3 limit for Moderato, and up to 1M for Allegretto and higher plans.

What changed from the K2 generation
K3 is not simply K2.6 with a larger context setting. Moonshot describes it as its most capable model and highlights a new architectural combination: Kimi Delta Attention, a hybrid linear-attention approach, and Attention Residuals.
For product teams, the practical changes are easier to understand in workload terms:
| Workload dimension | K2.6-era baseline | K3 change | Product implication |
|---|---|---|---|
| Context | 262,144 tokens | 1,048,576 tokens | More room for repositories, document collections, tool history, and iterative work |
| Reasoning mode | Thinking can be enabled or disabled | Reasoning is always enabled | Stronger focus on difficult work, with less control for lightweight requests |
| Reasoning parameter | K2-style thinking configuration | Top-level reasoning_effort | Existing integrations need a parameter compatibility review |
| Tool catalog | Standard tool calling | Adds tool_choice and dynamic tool loading | Agents can retrieve and inject only the tools needed for the current task |
| Model positioning | General multimodal and agent model | Flagship software engineering and knowledge-work model | K3 should be tested against the hardest part of the workload, not only chat prompts |
reasoning_effort, not the K2.x thinking parameter. An adapter that only swaps the model string may therefore be incomplete.Who should evaluate Kimi K3 now?
K3 has a credible early fit when the value of completing a difficult task is much larger than the token bill.
| Team or workload | Evaluation priority | Why |
|---|---|---|
| Coding-agent teams working across large repositories | High | The 1M context and long-horizon positioning directly match repository-scale work |
| Research products synthesizing many long documents | High | Larger context and structured outputs can reduce manual chunk orchestration |
| AI infrastructure teams with large tool catalogs | High | Dynamic tool loading and forced tool use address real orchestration problems |
| Multimodal review workflows | Medium to high | K3 can accept images and video alongside text |
| High-volume customer support chat | Low initially | Always-on reasoning and premium output pricing may be unnecessary |
| Classification, tagging, or short extraction | Low initially | Smaller routes are usually easier to justify on cost and latency |
| Self-hosted open-weight deployments | Wait | Official weights and license were not publicly confirmed in the reviewed sources |
This is why a benchmark headline alone will not decide K3's production value. Teams need to measure whether the model completes hard tasks with fewer retries, less human correction, or fewer route escalations.
Direct API pricing and practical cost
Moonshot lists one price across the full K3 context range rather than separate short- and long-context tiers:
| Token category | Moonshot direct list price per 1M tokens |
|---|---|
| Cached input | ¥2 |
| Uncached input | ¥20 |
| Output | ¥100 |
These are Moonshot direct API prices, not EvoLink prices. EvoLink pricing cannot be published until the route, provider channel, billing wrapper, and production behavior are verified.
Do not mix three different cost channels:
- Moonshot Open Platform uses the token prices above.
- Kimi Code uses membership quotas and plan entitlements rather than this direct API price table.
- Third-party gateways and aggregators set their own availability, provider routing, and prices. Community posts quoting dollar prices are useful demand signals, but they are not evidence of Moonshot or future EvoLink pricing.
Example cost scenarios
The examples below use Moonshot's direct list price and exclude retries, tools, storage, taxes, gateway pricing, or failed requests.
| Example request | Uncached K3 list-price estimate | Cached-input estimate |
|---|---|---|
| 20K input + 5K output | ¥0.90 | ¥0.54 |
| 100K input + 20K output | ¥4.00 | ¥2.20 |
| 500K input + 50K output | ¥15.00 | ¥6.00 |
| 1M input + 100K output | ¥30.00 | ¥12.00 |
Caching changes the economics materially. A stable 500K-token repository or knowledge prefix costs about ¥10 as uncached K3 input but about ¥1 when the input hits cache. The output remains the expensive part, so applications should still control tool loops, verbosity, retry policy, and completion budgets.
K3 versus K2.6 direct list price
| Model | Cached input / MTok | Uncached input / MTok | Output / MTok | Context |
|---|---|---|---|---|
| Kimi K2.6 | ¥1.10 | ¥6.50 | ¥27 | 262,144 |
| Kimi K3 | ¥2.00 | ¥20.00 | ¥100 | 1,048,576 |
K3's uncached input is about 3.1 times the K2.6 price, while output is about 3.7 times the K2.6 price. That gap supports a routing policy: use K3 when task difficulty, context size, or tool complexity warrants escalation, and keep less expensive models for routine work.
The production metric that matters: cost per successful task
List price is only the beginning. A premium model can still be economical when it prevents retries or completes work that a cheaper route cannot finish. Conversely, a strong model can be a poor default if it overthinks simple tasks or produces long expensive answers.
Measure K3 with:
| Metric | What it reveals |
|---|---|
| First-pass task success | Whether K3 reduces retries and human intervention |
| Accepted patch or deliverable rate | Whether generated work survives review |
| Tool-call accuracy | Whether the model selects the right tool and constructs valid arguments |
| Context-cache hit rate | Whether long repeated prefixes receive the expected cost benefit |
| Output tokens per successful task | Whether always-on reasoning creates avoidable completion cost |
| Time to accepted result | Whether stronger reasoning offsets slower generation |
| Fallback and recovery rate | Whether the route is reliable enough for production traffic |
The useful comparison is not “which model has the cheapest token?” It is “which route completes this workload at the lowest accepted-result cost within the required latency and reliability limits?”
Developer controls: reasoning, tools, and multimodal input
Reasoning behavior and request controls
K3 always reasons. Moonshot's documentation says:
reasoning_effortis the K3 reasoning parameter.- Only the
maxlevel is currently supported. - The K2.x
thinkingparameter should not be used for K3. - Streaming responses separate
reasoning_contentfrom finalcontent. - Multi-turn and tool workflows must return the complete assistant message to the next request.
That last rule is a common agent integration failure. If an application stores only the final text and drops reasoning-related response fields or tool calls, the next turn may not preserve the state expected by the model.
top_p, penalties, or multiple candidates. This makes evaluation prompt design and application-level routing more important than parameter experimentation.Tool use: K3's most important developer feature
K3 adds two controls that matter for production agents:
tool_choicecan require a tool call when the workflow must retrieve data or perform an action before answering.- Dynamic tool loading lets an application inject a tool definition into the conversation only when it becomes relevant.
The recommended pattern for a large tool catalog is:
| Stage | Application action | Benefit |
|---|---|---|
| Start | Provide a small tool-search function and a few universal tools | Keeps the initial prompt small |
| Retrieve | Require tool search for tasks that need external actions | Reduces unsupported memory-based answers |
| Load | Inject only the selected tool definitions | Improves tool selection and saves context |
| Execute | Return tool results with matching tool-call IDs | Preserves the agent loop correctly |
| Continue | Keep the full assistant message in history | Maintains reasoning and tool state |
This is more than a token optimization. Large overlapping tool catalogs often reduce selection accuracy. Dynamic loading turns tool discovery into part of the agent architecture.
Multimodal input and current constraints
K3 accepts text, images, and video, but developers should note the input rules:
- Visual message content must use the documented object-array format.
- Public image URLs are not supported in the K3 quickstart guidance.
- Images can be supplied as base64 data.
- Uploaded files can be referenced through Moonshot's
ms://file mechanism. - Video inputs can be uploaded and referenced as files.
These are direct Moonshot interface details. A future EvoLink route may expose different file handling or compatibility behavior, so applications should not assume the vendor upload flow will be identical on the gateway.
Long context, caching, and common access issues
1M context does not remove the need for context engineering
A million-token window makes larger tasks possible, but it does not make every token useful. Sending an entire repository, tool catalog, log archive, and conversation history can still increase cost, latency, and distraction.
Use the larger window deliberately:
| Context strategy | Recommended use |
|---|---|
| Stable cached prefix | Repository policies, architecture docs, long knowledge references |
| Retrieval before generation | Large document stores where only a subset is relevant |
| Dynamic tool definitions | Large agent tool catalogs |
| Context checkpoints | Long tasks that need resumable state and review |
| Output budgets | Prevent verbose reasoning tasks from consuming unnecessary output |
| Compaction and summaries | Preserve decisions while removing obsolete execution detail |
The best K3 workflow may use fewer carefully selected tokens than the maximum window allows.
Why Kimi K3 may show 256K, return 401, or use more quota
Several launch-week problems come from mixing API behavior with Kimi Code subscription behavior.
| Symptom | Likely explanation | What to check |
|---|---|---|
| K3 shows only 256K context | The Kimi Code account is on Moderato, or the client retains a lower context default | Check the plan; Allegretto or higher is required for Kimi Code's 1M entitlement, and supported clients may need 1048576 configured |
| Request returns 401 | The Kimi Code plan does not include the selected K3 context or model access | Confirm the membership tier and reauthenticate after changing plans |
| K3 is missing from the model selector | The coding client has stale model metadata | Update or restart the client, then select k3 rather than kimi-for-coding |
| Usage jumps after switching models | Kimi Code does not carry the previous model's context cache into the new model | Start a new session when switching to K3 instead of continuing a long cached conversation |
reasoning_effort returns 400 | The request uses an unsupported value or the wrong API surface | On the direct K3 API, use the currently documented max value |
| Later turns lose state or tool context | The application retained only final text and discarded the complete assistant message | Preserve reasoning fields, tool calls, and the full assistant response in conversation history |
Third-party coding clients may expose their own context controls. A “1M-capable” account does not guarantee that every client automatically sends the maximum window.
Production evaluation and remaining unknowns
What remains unverified
Moonshot's launch documentation is unusually concrete about the API, but several important questions remain open:
| Open question | Current safe position |
|---|---|
| Official benchmark table | No complete reproducible K3 benchmark table was found in the reviewed official launch docs |
| Independent benchmark performance | Wait for controlled third-party evaluations using comparable harnesses |
| Open-weight release | Not publicly confirmed in the official sources reviewed |
| License | Do not infer K3's license from older Kimi releases |
| Active parameter count and expert layout | Not documented in the reviewed K3 quickstart |
| Real long-context retrieval quality | Validate with repository and document tasks, not context-window size alone |
| Direct API latency under launch load | Measure over time and across workload sizes |
| Failed-request billing behavior | Verify from billing records and current provider policy |
| EvoLink model ID and price | Not available until EvoLink integration is verified |
Early community demos describe strong coding and web-building results, but they also mention slow responses, overthinking, and launch-night errors. These are useful test ideas, not reliable model facts or production guarantees.
A production evaluation plan
Do not evaluate K3 with one impressive prompt. Build a small workload that represents real customer value.
Phase 1: establish baselines
Choose 20–50 tasks across:
- repository understanding;
- multi-file code changes;
- bug localization;
- long-document synthesis;
- structured extraction;
- multimodal review;
- multi-step tool use.
Record the current route's success rate, latency, input/output tokens, retry count, and reviewer effort.
Phase 2: test K3 directly
Use the official Moonshot route only if direct vendor testing fits your procurement and data policy. Keep prompts, tools, and acceptance criteria consistent. Record cache behavior separately from first-turn uncached cost.
Phase 3: decide the future routing role
K3 does not need to replace the baseline model to be valuable. It may be best as:
- an escalation route after a cheaper model fails;
- a repository-scale coding route;
- a long-document synthesis route;
- a specialist for tool-heavy workflows;
- a premium user-selectable option.
Phase 4: verify the EvoLink route when available
When EvoLink publishes a verified K3 route, repeat a smaller compatibility suite:
- model ID and request shape;
- reasoning field preservation;
- streaming behavior;
- tool calls and structured output;
- image and video input;
- 1M context handling;
- billing and cache accounting;
- timeout, retry, and fallback behavior.
How EvoLink users should prepare
EvoLink's value is not to turn every newly released model into an automatic default. A unified API gateway should make model choice, cost control, provider fallback, and migration easier.
While K3 is not yet integrated, teams can:
- Review the current EvoLink model catalog instead of assuming a K3 route exists.
- Build workload-specific acceptance tests that can be replayed when K3 becomes available.
- Keep model selection behind configuration rather than hard-coding one provider.
- Define cost and latency thresholds for escalation to a premium model.
- Read the developer guide to AI model routing for a broader routing framework.
- Use the Kimi K3 availability tracker for EvoLink-specific status.
The production opportunity is model optionality: route ordinary work economically, reserve premium reasoning for tasks that benefit from it, and keep a fallback when one provider is slow or unavailable.
FAQ
Is Kimi K3 officially released?
Yes. Moonshot published Kimi K3 in its official model list, quickstart, pricing documentation, and direct API examples on July 16, 2026.
What is the official Kimi K3 model ID?
kimi-k3. This does not confirm the future EvoLink route name.Is the Kimi Code k3 model ID the same as kimi-k3?
kimi-k3 on Moonshot Open Platform and k3 in Kimi Code. The endpoints, billing, and plan limits are different.Is kimi-for-coding Kimi K3?
kimi-for-coding as K2.7 Code. Select k3 when the client and membership plan support Kimi K3.Why does Kimi Code show only 256K context for K3?
1048576.Why does Kimi Code return 401 for K3?
A 401 can indicate that the current membership tier does not include the requested model or context entitlement. Check the plan, refresh authentication, and retry in a new session.
Why can quota usage rise after switching to K3?
Kimi Code says context cache is not reused across model switches. Starting a new session avoids carrying a long conversation into a route whose previous cache is no longer valid.
How large is the Kimi K3 context window?
Moonshot documents a 1,048,576-token context window.
Does Kimi K3 support images and video?
Yes. Moonshot documents native visual understanding with text, image, and video input. Direct API visual inputs must follow Moonshot's documented file or base64 formats.
Can Kimi K3 disable reasoning?
reasoning_effort control currently supports only max.How much does Kimi K3 cost?
Moonshot's direct list price is ¥2 per million cached input tokens, ¥20 per million uncached input tokens, and ¥100 per million output tokens. These are not EvoLink prices.
Is Kimi K3 open source?
An official K3 weight release and license were not found in the reviewed launch sources. Do not describe K3 as open source until Moonshot publishes the weights and license.
Is Kimi K3 available on EvoLink?
Should teams replace K2.6 or another current model with K3?
Not automatically. K3 is substantially more expensive at Moonshot's direct list price. Test it on difficult long-context, coding, research, multimodal, and tool-heavy tasks, then choose a specialist, escalation, or premium routing role.
What should developers test first?
Start with tasks that currently fail because of repository size, document volume, long tool histories, or complex reasoning. Measure accepted-result cost and reviewer effort, not only output quality.
Sources
- Moonshot: Kimi K3 quickstart and model overview
- Moonshot: Kimi K3 direct API pricing
- Moonshot: current model list
- Moonshot: model parameter reference
- Moonshot: Kimi K3 tool-calling best practices
- Moonshot: direct API rate-limit tiers
- Kimi Code: supported model IDs, plans, context limits, and switching behavior
Community discussions were used only to identify evaluation questions and early adoption concerns. Model facts, prices, IDs, limits, and API behavior in this review are based on Moonshot's official documentation.


