mistralai/client-python

Mistral Python Client – 빠른 개요

설명: Mistral AI의 클라우드 서비스(채팅 완성, 임베딩, 오디오, 파일 처리, 에이전트 및 다양한 관리 API)를 호출하기 위한 공식 Python SDK입니다. 자체 Python 코드에서 Mistral 모델과 대화할 수 있으며, 동기 방식과 asyncio를 사용한 비동기 방식을 모두 지원합니다.

주요 기능

채팅 및 에이전트 – mistral.chat.complete(...) 및 mistral.agents.complete(...)를 통한 간단한 호출(스트리밍 옵션 지원).
임베딩 – mistral.embeddings.create(...)를 통한 텍스트 벡터화.
파일 업로드 – mistral.files.upload(...)를 통한 워크스페이스 파일 업로드.
오디오 – 음성 합성 및 전사 엔드포인트.
배치 작업, 라이브러리, 커넥터, 대화 – Mistral 리소스(예: RAG용 문서 라이브러리)에 대한 전체 관리 기능.
비동기 지원 – 모든 작업에 *_async 대응 버전 제공.
서버 전송 이벤트 (SSE) – SSE를 통한 스트리밍 응답.
내장된 페이지네이션, 재시도 및 오류 처리.
클라우드 제공업체 래퍼 – Azure AI 및 Google Cloud (Vertex AI)용 클라이언트가 내장되어 있어 인증 및 엔드포인트 구성을 자동으로 처리합니다.

시작하기

설치 – pip install mistralai (또는 uv add mistralai).
API 키 설정 – MISTRAL_API_KEY를 내보내거나 MISTRAL_SA_TOKEN_PATH를 서비스 계정 토큰 파일로 지정합니다.

코드 작성 – Mistral을 가져와 원하는 메서드를 호출합니다. 예:

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": "Hello!"}],
        stream=False,
    )
    print(resp)

예제 실행 – 저장소의 examples/ 폴더에 있는 예제를 uv run으로 실행할 수 있습니다.

중요성: 이 SDK는 HTTP 세부 정보, 토큰 교체, 페이지네이션 및 스트리밍을 추상화하여 개발자가 Mistral의 대규모 언어 모델을 활용하는 애플리케이션(챗봇, RAG 파이프라인, 음성 비서 등) 구축에 집중할 수 있도록 합니다.

mistralai/client-python

Mistral Python Client – 빠른 개요

관련