Moonshot AI / Kimi

Use Moonshot AI’s Kimi models through MoonshotAIProvider and the OpenAI-compatible Chat Completions API. The provider prefix is moonshotai:.

Install

Install Pydantic AI with the OpenAI SDK used by this integration:

pip

Terminal

pip install "pydantic-ai-slim[openai]"

uv

Terminal

uv add "pydantic-ai-slim[openai]"

Configuration

Create an API key in the Moonshot Console.

You can set the MOONSHOTAI_API_KEY environment variable and use MoonshotAIProvider by name:

from pydantic_ai import Agent

agent = Agent('moonshotai:kimi-k3')
...

Or initialise the model and provider directly:

from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.moonshotai import MoonshotAIProvider

model = OpenAIChatModel(
    'kimi-k3',
    provider=MoonshotAIProvider(api_key='your-moonshot-api-key'),
)
agent = Agent(model)
...