Vertex AI 기반 Mistral AI 모델은 완전 관리형 서버리스 모델을 API로 제공합니다. Vertex AI에서 Mistral AI 모델을 사용하려면 요청을 Vertex AI API 엔드포인트로 직접 보냅니다. Mistral AI 모델은 관리형 API를 사용하므로 인프라를 프로비저닝하거나 관리할 필요가 없습니다.
대답을 스트리밍하여 최종 사용자의 지연 시간 인식을 줄일 수 있습니다. 스트리밍된 응답은 서버 전송 이벤트(SSE)를 사용하여 대답을 점진적으로 스트리밍합니다.
Mistral AI 모델은 사용한 만큼만 비용을 지불합니다(사용한 만큼만 지불). 사용한 만큼만 지불 가격 책정은 Vertex AI 가격 책정 페이지의 Mistral AI 모델 가격 책정을 참고하세요.
사용 가능한 Mistral AI 모델
Mistral AI에서 Vertex AI에 사용할 수 있는 다음 모델을 사용할 수 있습니다. Mistral AI 모델에 액세스하려면 Model Garden 모델 카드로 이동합니다.
Mistral Large (2407)
Mistral Large (2407)는 텍스트 생성을 위한 Mistral AI의 대표적인 모델입니다. 최고 수준의 추론 기능을 제공하며 텍스트 이해, 변환, 코드 생성을 비롯한 복잡한 다국어 작업에 사용할 수 있습니다. 자세한 내용은 Mistral Large (2407)에 관한 Mistral AI의 게시물을 참고하세요.
Mistral Large (2407)는 다음 측정기준에서 두드러집니다.
- 다국어 지원 설계 한국어, 네덜란드어, 독일어, 스페인어, 영어, 이탈리아어, 중국어, 일본어, 포르투갈어, 프랑스어, 폴란드어 등 수십 개의 언어가 지원됩니다.
- 코딩에 능숙 Python, Java, C, C++, JavaScript, Bash 등 80개 이상의 코딩 언어로 학습되었습니다. Swift 및 Fortran과 같은 더 구체적인 언어로도 학습됩니다.
- 에이전트 중심 네이티브 함수 호출 및 JSON 출력을 갖춘 최고의 에이전트 기능을 갖췄습니다.
- 고급 추론 최첨단 수학 및 추론 기능이 있습니다.
Mistral Nemo
Mistral Nemo는 Mistral AI의 가장 비용 효율적인 독점 모델입니다. 지연 시간이 짧은 워크로드와 분류, 고객 지원, 텍스트 생성 등 일괄적으로 실행할 수 있는 간단한 작업에 적합합니다. 자세한 내용은 Mistral AI의 문서를 참고하세요.
Mistral Nemo는 다음과 같은 사용 사례에 최적화되어 있습니다.
- 텍스트 생성 및 분류
- 고객 지원 시나리오를 위한 상담사 빌드
- 코드 생성, 완성, 검토, 주석 모든 메인스트림 코딩 언어를 지원합니다.
Codestral
Codestral은 fill-in-the-middle 및 코드 완성을 비롯한 코드 생성 태스크에 맞게 특별히 설계되고 최적화된 생성 모델입니다. Codestral은 80개가 넘는 프로그래밍 언어로 학습되어 흔한 언어와 흔하지 않은 언어 모두에서 우수한 성능을 발휘합니다. 자세한 내용은 Mistral AI의 코드 생성 문서를 참고하세요.
Codestral은 다음과 같은 사용 사례에 최적화되어 있습니다.
- 코드 생성, 코드 완성, 제안, 번역 제공
- 코드를 이해하여 코드의 요약과 설명을 제공
- 코드 리팩터링, 버그 수정, 테스트 사례 생성을 지원하여 코드 품질 검토
Mistral AI 모델 사용
Mistral AI의 모델을 사용하기 위한 요청을 보낼 때는 다음 모델 이름을 사용하세요.
- Mistral Large (2407)의 경우
mistral-large@2407
을 사용합니다. - Mistral Nemo의 경우
mistral-nemo@2407
을 사용합니다. - Codestral의 경우
codestral@2405
을 사용합니다.
모델 버전 간의 차이로 인해 @
기호로 시작하는 서픽스가 포함된 모델 버전을 사용하는 것이 좋습니다. 모델 버전을 지정하지 않으면 항상 최신 버전이 사용되어 모델 버전이 변경될 때 실수로 워크플로에 의도치 않은 영향을 미칠 수 있습니다.
Mistral AI SDK 사용에 관한 자세한 내용은 Mistral AI Vertex AI 문서를 참고하세요.
시작하기 전에
Vertex AI에서 Mistral AI 모델을 사용하려면 다음 단계를 실행해야 합니다. Vertex AI를 사용하려면 Vertex AI API(aiplatform.googleapis.com
)를 사용 설정해야 합니다. Vertex AI API가 사용 설정된 기존 프로젝트가 이미 있는 경우 새 프로젝트를 만드는 대신 해당 프로젝트를 사용할 수 있습니다.
파트너 모델을 사용 설정하고 사용하는 데 필요한 권한이 있는지 확인합니다. 자세한 내용은 필수 권한 부여를 참고하세요.
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
- 다음 Model Garden 모델 카드 중 하나로 이동한 다음 사용 설정을 클릭합니다.
Mistral AI 모델에 스트리밍 호출 수행
다음 샘플은 Mistral AI 모델을 스트리밍 호출합니다.
REST
환경을 설정하면 REST를 사용하여 텍스트 프롬프트를 테스트할 수 있습니다. 다음 샘플은 요청을 게시자 모델 엔드포인트에 전송합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION: Mistral AI 모델을 지원하는 리전입니다.
- MODEL: 사용할 모델 이름. 요청 본문에서
@
모델 버전 번호를 제외합니다. - ROLE: 메시지와 연결된 역할.
user
또는assistant
를 지정할 수 있습니다. 첫 번째 메시지는user
역할을 사용해야 합니다. 모델이user
와assistant
의 턴을 번갈아가며 작동합니다. 최종 메시지에서assistant
역할을 사용하는 경우 이 메시지의 콘텐츠에서 곧바로 대답 콘텐츠가 계속됩니다. 이를 사용하여 모델 대답의 일부를 제한할 수 있습니다. - STREAM: 대답 스트리밍 여부를 지정하는 불리언. 대답을 스트리밍하여 최종 사용자 지연 시간 인식을 줄입니다. 대답을 스트리밍하려면
true
로 설정하고 대답을 한 번에 반환하려면false
로 설정합니다. - CONTENT:
user
또는assistant
메시지의 콘텐츠(예: 텍스트). - MAX_OUTPUT_TOKENS:
대답에서 생성될 수 있는 토큰의 최대 개수. 토큰은 약 3.5자(영문 기준)입니다. 토큰 100개는 단어 약 60~80개에 해당합니다.
응답이 짧을수록 낮은 값을 지정하고 잠재적으로 응답이 길면 높은 값을 지정합니다.
HTTP 메서드 및 URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/mistralai/models/MODEL:streamRawPredict
JSON 요청 본문:
{ "model": MODEL, "messages": [ { "role": "ROLE", "content": "CONTENT" }], "max_tokens": MAX_TOKENS, "stream": true }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/mistralai/models/MODEL:streamRawPredict"
PowerShell
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/mistralai/models/MODEL:streamRawPredict" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 수신됩니다.
Mistral AI 모델에 단항 호출 수행
다음 샘플은 Mistral AI 모델을 단항 호출합니다.
REST
환경을 설정하면 REST를 사용하여 텍스트 프롬프트를 테스트할 수 있습니다. 다음 샘플은 요청을 게시자 모델 엔드포인트에 전송합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION: Mistral AI 모델을 지원하는 리전입니다.
- MODEL: 사용할 모델 이름. 요청 본문에서
@
모델 버전 번호를 제외합니다. - ROLE: 메시지와 연결된 역할.
user
또는assistant
를 지정할 수 있습니다. 첫 번째 메시지는user
역할을 사용해야 합니다. 모델이user
와assistant
의 턴을 번갈아가며 작동합니다. 최종 메시지에서assistant
역할을 사용하는 경우 이 메시지의 콘텐츠에서 곧바로 대답 콘텐츠가 계속됩니다. 이를 사용하여 모델 대답의 일부를 제한할 수 있습니다. - STREAM: 대답 스트리밍 여부를 지정하는 불리언. 대답을 스트리밍하여 최종 사용자 지연 시간 인식을 줄입니다. 대답을 스트리밍하려면
true
로 설정하고 대답을 한 번에 반환하려면false
로 설정합니다. - CONTENT:
user
또는assistant
메시지의 콘텐츠(예: 텍스트). - MAX_OUTPUT_TOKENS:
대답에서 생성될 수 있는 토큰의 최대 개수. 토큰은 약 3.5자(영문 기준)입니다. 토큰 100개는 단어 약 60~80개에 해당합니다.
응답이 짧을수록 낮은 값을 지정하고 잠재적으로 응답이 길면 높은 값을 지정합니다.
HTTP 메서드 및 URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/mistralai/models/MODEL:rawPredict
JSON 요청 본문:
{ "model": MODEL, "messages": [ { "role": "ROLE", "content": "CONTENT" }], "max_tokens": MAX_TOKENS, "stream": false }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/mistralai/models/MODEL:rawPredict"
PowerShell
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/mistralai/models/MODEL:rawPredict" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 수신됩니다.
Mistral AI 모델 리전 가용성 및 할당량
Mistral AI 모델의 경우 모델을 사용할 수 있는 각 리전에 할당량이 적용됩니다. 할당량은 분당 쿼리 수(QPM) 및 분당 토큰 수(TPM)로 지정됩니다. TPM에는 입력 및 출력 토큰이 모두 포함됩니다.
각 Mistral AI 모델에 지원되는 리전, 기본 할당량, 최대 컨텍스트 길이는 다음 표에 나와 있습니다.
Mistral Large (2407)
지역 | 할당량 시스템 | 지원되는 컨텍스트 길이 |
---|---|---|
us-central1 |
60QPM, 200,000TPM | 토큰 128,000개 |
europe-west4 |
60QPM, 200,000TPM | 토큰 128,000개 |
Mistral Nemo
지역 | 할당량 시스템 | 지원되는 컨텍스트 길이 |
---|---|---|
us-central1 |
60QPM, 200,000TPM | 토큰 128,000개 |
europe-west4 |
60QPM, 200,000TPM | 토큰 128,000개 |
Codestral
지역 | 할당량 시스템 | 지원되는 컨텍스트 길이 |
---|---|---|
us-central1 |
60QPM, 200,000TPM | 토큰 32,000개 |
europe-west4 |
60QPM, 200,000TPM | 토큰 32,000개 |
Vertex AI의 생성형 AI 할당량을 상향 조정하려면 Google Cloud 콘솔을 사용해 할당량 상향을 요청하면 됩니다. 할당량에 대한 자세한 내용은 할당량 작업을 참조하세요.