Mistral
Mistral
이 문서에서는 pydantic-ai에서 MistralModel을 설치하고 설정하는 방법을 알려드려요. Mistral의 API를 사용하려면 먼저 API 키를 생성하고, 환경 변수로 설정한 뒤 모델을 이름으로 사용하거나 직접 초기화하면 돼요. 커스텀 Provider나 httpx2.AsyncClient를 넘겨서 구성을 더 세밀하게 조정할 수도 있어요.
출처: 문서
본문
Install
MistralModel을 사용하려면 pydantic-ai를 설치하거나, mistral 옵션 그룹과 함께 pydantic-ai-slim을 설치해야 해요:
Terminal
pip install "pydantic-ai-slim[mistral]"
Terminal
uv add "pydantic-ai-slim[mistral]"
Configuration
Mistral를 API를 통해 사용하려면 console.mistral.ai/api-keys/로 이동해서 API 키를 생성할 수 있는 곳을 찾아보세요.
LatestMistralModelNames에는 가장 인기 있는 Mistral 모델 목록이 들어 있어요.
Environment variable
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 argument
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를 사용해 프로바이더를 맞춤 구성할 수도 있어요:
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 프로바이더는 Pydantic AI v2 동안 레거시 httpx.AsyncClient도 허용하지만, deprecation 경고를 발생시켜요. 새 코드에는 httpx2.AsyncClient를 사용하세요. 레거시 HTTPX 클라이언트 지원은 Pydantic AI v3에서 제거될 예정이에요.