Mistral

Mistral

Mistral의 모델을 쓰려면 MistralModel을 쓰면 돼요. 설치하고 API 키를 환경 변수로 설정한 뒤 이름으로 바로 에이전트를 만들 수 있고, 커스텀 Provider나 HTTP 클라이언트, base URL로 세부 동작을 조절할 수도 있어요.

출처: 공식문서

설치

MistralModel을 쓰려면 pydantic-ai를 설치하거나 pydantic-ai-slim을 mistral 옵션 그룹과 함께 설치해야 해요.

Terminal

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

Terminal

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

설정

Mistral API를 쓰려면 console.mistral.ai/api-keys/에 가서 API 키를 생성하는 곳을 찾아보면 돼요.

LatestMistralModelNames에는 가장 인기 있는 Mistral 모델 목록이 들어 있어요.

환경 변수

API 키를 받았으면 환경 변수로 설정해요.

Terminal

export MISTRAL_API_KEY='your-api-key'

이제 MistralModel을 이름으로 쓸 수 있어요.

from pydantic_ai import Agent

agent = Agent('mistral:mistral-large-latest')
...

또는 모델 이름만으로 직접 초기화할 수도 있어요.

from pydantic_ai import Agent
from pydantic_ai.models.mistral import MistralModel

model = MistralModel('mistral-small-latest')
agent = Agent(model)
...

provider 인자

provider 인자로 커스텀 Provider를 제공할 수 있어요.

from pydantic_ai import Agent
from pydantic_ai.models.mistral import MistralModel
from pydantic_ai.providers.mistral import MistralProvider

model = MistralModel(
    'mistral-large-latest', provider=MistralProvider(api_key='your-api-key', base_url='https://<mistral-provider-endpoint>')
)
agent = Agent(model)
...

커스텀 httpx2.AsyncClient로 provider를 커스터마이즈할 수도 있어요.

from httpx2 import AsyncClient

from pydantic_ai import Agent
from pydantic_ai.models.mistral import MistralModel
from pydantic_ai.providers.mistral import MistralProvider

custom_http_client = AsyncClient(timeout=30)
model = MistralModel(
    'mistral-large-latest',
    provider=MistralProvider(api_key='your-api-key', http_client=custom_http_client),
)
agent = Agent(model)
...

Mistral provider는 Pydantic AI v2 동안 레거시 httpx.AsyncClient도 받지만 deprecation 경고를 내요. 새 코드에서는 httpx2.AsyncClient를 쓰고, 레거시 HTTPX 클라이언트 지원은 Pydantic AI v3에서 제거될 예정이에요.

더 알아보기 (Learn more)