mistralai/client-python

Mistral Python Client 는 무엇인가요?

이 리포지토리는 Mistral AI의 클라우드 서비스 — 채팅 완성, 임베딩, 오디오, 파일 처리, 에이전트 등 — 에 대한 공식 Python SDK를 제공합니다. 개발자들이 수동으로 HTTP 요청을 작성하지 않고도 Python 코드에서 Mistral의 REST API를 동기 및 asyncio를 통해 비동기로 호출할 수 있게 해줍니다.

주요 기능 (README에 설명됨)

영역	SDK로 할 수 있는 일
채팅 완성	`mistral-large-latest` 같은 모델로부터 텍스트 응답을 생성. 스트리밍 및 사용자 정의 응답 형식 지원.
임베딩	`mistral-embed`를 통해 하나 또는 여러 입력 문자열의 벡터 임베딩을 얻을 수 있습니다.
파일 업로드	파인튜닝이나 RAG를 위해 워크스페이스에 파일을 업로드할 수 있습니다.
에이전트	상태를 유지하는 상호작용을 지원하는 에이전트 엔드포인트를 호출할 수 있으며, 동기 및 비동기 API 모두 제공됩니다.
오디오	음성 합성 (`Audio.Speech`) 및 음성 인식 (`Audio.Transcriptions`)을 지원하며, Server-Sent Events를 통한 스트리밍 인식도 가능합니다.
배치 작업	장시간 실행되는 배치 작업의 목록 조회, 생성, 취소, 삭제를 지원합니다.
베타 리소스	에이전트, 커넥터, 대화, 라이브러리, 문서를 관리할 수 있으며, 생성, 목록 조회, 업데이트, 삭제, 페이지네이션 등이 가능합니다.
클라우드 제공업체 래퍼	Azure AI 및 Google Cloud (Vertex AI)용 미리 준비된 클라이언트로, 엔드포인트 구성, 인증, 토큰 갱신을 자동으로 처리합니다.
유틸리티	내장된 페이지네이션, 재시도, 오류 처리, 사용자 정의 HTTP 클라이언트 삽입, 텔레메트리 훅, IDE 친화적인 타입 힌트를 제공합니다.

시작하기

API 키 획득: Mistral 콘솔에서 (또는 Azure/GCP를 사용하는 경우 해당 플랫폼에서) API 키를 획득합니다. MISTRAL_API_KEY (또는 제공업체별 환경 변수)로 내보내세요.
패키지 설치: 다음 중 하나로 설치 가능:
```
# uv (빠른 설치기)
uv add mistralai

# pip (기본)
pip install mistralai

# poetry
poetry add mistralai
```
에이전트 관련 기능을 사용하려면 추가: pip install "mistralai[agents]" (Python 3.10+ 필요).

작은 스크립트 작성 (동기 예제):

from mistralai.client import Mistral
import os

with Mistral(api_key=os.getenv("MISTRAL_API_KEY")) as client:
    resp = client.chat.complete(
        model="mistral-large-latest",
        messages=[{"role": "user", "content": "가장 뛰어난 프랑스 화가는 누구인가요?"}],
        stream=False,
        response_format={"type": "text"},
    )
    print(resp)

동일한 패턴은 async with Mistral(...): 및 *_async 메서드에서도 사용 가능합니다.

언제 이 SDK를 사용해야 하나요?

신뢰성 있고 타입이 지정된 Python 인터페이스가 필요한 LLM 기반 애플리케이션(채팅봇, 어시스턴트, RAG 파이프라인)을 개발할 때.
원시 HTTP를 다루지 않고도 기존 Python 서비스에 Mistral 모델을 통합하고 싶을 때.
Mistral의 확장된 생태계 — 오디오 생성, 음성 인식, 배치 처리, 또는 최신 에이전트 및 커넥터 기능 — 을 활용하고 싶을 때.
Azure 또는 Google Cloud에 배포할 때 — SDK에는 제공업체별 인증 및 엔드포인트 구성 처리를 자동으로 수행하는 MistralAzure, MistralGCP와 같은 미리 준비된 래퍼가 포함되어 있습니다.

구조 설명

mistralai.client.Mistral — chat, embeddings, files, agents, audio 등 하위 객체를 노출하는 핵심 클라이언트.
제공업체별 모듈 (mistralai.azure.client, mistralai.gcp.client) — 핵심 클라이언트를 상속하여 사전 설정된 기본 URL과 인증 흐름을 제공합니다.
풍부한 문서 — 각 리소스에 대한 docs/ 폴더 내 문서와 examples/ 디렉터리가 있으며, uv run으로 실행 가능합니다.

TL;DR

Mistral Python Client 는 Mistral AI의 클라우드 API를 래핑한 완전 기능의 공식 지원 SDK입니다. pip (또는 uv/poetry)로 설치하고 API 키를 설정하면, Python에서 채팅, 임베딩, 오디오, 파일, 에이전트 호출을 동기 및 비동기로 직접 수행할 수 있습니다. 또한 Azure AI 및 Google Cloud용 미리 준비된 어댑터를 포함하여, 최신 LLM 서비스를 다루는 Python 개발자에게 편리한 진입점이 됩니다.