Source: https://ailoot.ai/models/ko/microsoft-mai-voice-2-1/ Canonical: https://ailoot.ai/models/ko/microsoft-mai-voice-2-1/ Language: ko # Microsoft AI: MAI-Voice-2.1 [Markdown](https://ailoot.ai/models/ko/microsoft-mai-voice-2-1/index.md) · [JSON](https://ailoot.ai/models/ko/microsoft-mai-voice-2-1/facts.json) ## [Microsoft AI: MAI-Voice-2.1](https://ailoot.ai/models/ko/microsoft-mai-voice-2-1/) Microsoft AI의 MAI-Voice-2.1은 내레이션, 오디오북, 교육 콘텐츠, 보이스오버를 위한 표현력 있는 다국어 음성을 생성합니다. 23개 언어를 제공하며 일관된 화자의 목소리, 여러 화자, 표현 제어를 지원합니다. - [**Ailoot Ultra · 음성 합성** `POST /v1/audio/speech` `microsoft/mai-voice-2.1`](https://ailoot.ai/models/ko/microsoft-mai-voice-2-1/#method-0) 모델 소개 이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다. MAI-Voice-2.1은 표현력과 오디오 충실도가 중요한 작업을 위한 Microsoft AI의 프롬프트 기반 텍스트 음성 변환 모델입니다. 모델 카드는 23개 언어와 26개 로캘을 다루며 자연스러운 억양, 리듬, 감정의 미묘한 차이를 설명합니다. 제조사는 오디오북, 미디어 내레이션, 콘텐츠 제작, 보이스오버를 핵심 용도로 제시합니다. 이 버전은 길고 표현력 있는 콘텐츠에 중점을 둡니다. 지연에 민감한 상호작용에는 별도로 설계된 MAI-Voice-2.1-Flash가 있습니다. #### 일관된 화자의 내레이션 모델 카드는 지원 언어 전반에서 하나의 목소리 정체성을 일관되게 구현한다고 설명합니다. 긴 콘텐츠 생성은 청크 분할과 맥락 전달을 사용해 문단 사이의 연속성을 높입니다. 내레이터의 특성을 유지해야 하는 수업, 오디오북의 한 장, 관련 보이스오버 구간의 연속 작업에 유용합니다. 경계가 분명하고 내용이 이어지는 문단을 준비하고 작품 전반에서 같은 화자를 유지하세요. 입력은 최종 발화문이며, 선택적으로 화자 참조 음성과 SSML 표현 제어를 추가할 수 있습니다. 내레이션 제작 요구사항에서는 청취자가 들을 내용과 제작 메모를 구분해야 합니다. 기술 설명이라면 명확한 도입, 실제 단계, 마무리 안내를 작성하세요. 제품 이름과 반복되는 용어는 같은 표기를 유지하세요. 현지화 내레이션에는 목표 언어 대본을 준비합니다. 선택한 언어와 목소리가 그 대본의 발화 표현을 결정합니다. #### 화자, 역할, 표현 제어 Microsoft는 선별된 목소리 라이브러리를 제공하며 대화용 다중 화자를 문서화합니다. Harper와 Grant는 여러 로캘에 항목이 있는 화자 정체성의 예입니다. 두 사람이 주고받는 교육 대화에서는 질문과 설명을 서로 다른 목소리에 배정하고 같은 역할이 다시 등장할 때도 배정을 유지할 수 있습니다. 원하는 대화가 합성 입력에 나타나도록 발화 문장에 명확한 라벨을 붙이세요. SSML로 대화 차례나 문장 수준에서 어조와 표현을 조절할 수 있습니다. 스타일은 화자별로 다릅니다. 관리형 목록에는 적합한 목소리의 작업 중심 내레이터·교육 스타일과 다른 목소리의 기쁨·안도 같은 감정 선택지가 나열됩니다. 미국 Harper 항목은 이 두 감정 스타일을 지원합니다. 다른 목소리의 스타일을 가져오지 말고 화자와 그 화자에 대해 문서화된 표현 스타일을 함께 선택하세요. 이야기나 프레젠테이션에서는 표현력으로 사실 설명, 성찰하는 문단, 생동감 있는 인용을 구분할 수 있습니다. 예를 들어 “첫 시도에서는 전체 모습을 제대로 볼 수 없었습니다. 전체 과정을 살펴보니 빠진 단계가 분명해졌습니다.”라는 문장을 사용할 수 있습니다. 의미가 바뀌는 지점을 정하고 그에 맞게 발화 단위를 준비하세요. 모든 문장을 똑같이 강조하기보다 내러티브를 따라 표현이 바뀌도록 전환 부분을 들어 보세요. #### 참조 목소리와 오디오 결과 선택적인 사용자 지정 목소리 모드는 미세 조정 없이 5~60초의 오디오 참조에서 동의받은 화자의 목소리를 재현합니다. 샘플이 생성 목소리에 영향을 주므로 Microsoft는 적당한 에너지의 자연스러운 대화체를 권장합니다. 사용자 지정 목소리 워크플로에는 제조사 승인과 녹음된 동의 진술이 필요합니다. 미리 만들어진 라이브러리는 별도의 목소리 선택 경로입니다. 제조사는 출력 형식을 선택할 수 있게 하며 공개 합성 예제에서는 24 kHz, 160 kbit/s의 모노 MP3로 저장합니다. 이 설정은 하나의 출력 워크플로를 설명합니다. 다음 편집이나 재생 단계에 맞는 오디오 표현 방식을 선택하고 대본, 화자, 구간 순서를 녹음과 연결해 보관하세요. 완성된 장이나 수업은 여러 생성 문단을 포함하면서도 일관된 하나의 청취 경험을 유지할 수 있습니다. #### 긴 결과 활용 MAI-Voice-2.1은 즉각적인 응답 시간보다 음성 연기가 중요한 상황에서 자연스러움과 표현력에 초점을 둡니다. 긴 작품에서는 반복되는 이름, 구간 경계, 대화에 배정된 목소리, 감정적 어조의 변화를 검토하세요. 문서는 긴 콘텐츠 생성 능력과 일관성 유지 장치를 확립하지만 무제한 대본이나 보장된 최대 녹음 시간을 지정하지는 않습니다. 실용적인 결과물은 내레이터, 문구, 전개가 준비한 자료와 일치하는 표현력 있는 오디오입니다. **Ailoot Ultra · 음성 합성** `POST /v1/audio/speech` `microsoft/mai-voice-2.1` [`microsoft/mai-voice-2.1`](https://ailoot.ai/models/ko/#m=microsoft%2Fmai-voice-2.1&route=Ultra&caller=microsoft%2Fmai-voice-2.1&fmt=speech) Microsoft AI /`microsoft/mai-voice-2.1` ### 시작하기 Microsoft AI의 MAI-Voice-2.1은 내레이션, 오디오북, 교육 콘텐츠, 보이스오버를 위한 표현력 있는 다국어 음성을 생성합니다. 23개 언어를 제공하며 일관된 화자의 목소리, 여러 화자, 표현 제어를 지원합니다. 허용 입력 텍스트 결과 오디오 ### Ailoot에서 사용 가능 · 입력 및 메서드 **Ailoot Ultra · 음성 합성** `POST /v1/audio/speech` 입력 `text` 출력 `audio` 출력 형식 mp3 | 필드 | 유형 | 요건 | 값과 한도 | 기본값 | | --- | --- | --- | --- | --- | | 필드`model` | 유형`string` | 요건필수 | 값과 한도 microsoft/mai-voice-2.1 | 기본값— | | 필드`input` | 유형`string` | 요건필수 | 값과 한도 최소 길이: 1 단위: Unicode 문자 | 기본값— | | 필드`voice` | 유형`string` | 요건필수 | 값과 한도 cs-CZ-Grant:MAI-Voice-2.1, cs-CZ-Harper:MAI-Voice-2.1, da-DK-Grant:MAI-Voice-2.1, da-DK-Harper:MAI-Voice-2.1, de-DE-Grant:MAI-Voice-2.1, de-DE-Harper:MAI-Voice-2.1, de-DE-Klaus:MAI-Voice-2.1, de-DE-Mia:MAI-Voice-2.1, en-AU-Isla:MAI-Voice-2.1, en-GB-Emily:MAI-Voice-2.1, en-GB-Harry:MAI-Voice-2.1, en-IN-Dhruv:MAI-Voice-2.1, en-IN-Priya:MAI-Voice-2.1, en-US-Ethan:MAI-Voice-2.1, en-US-Grant:MAI-Voice-2.1, en-US-Harper:MAI-Voice-2.1, en-US-Iris:MAI-Voice-2.1, en-US-Jasper:MAI-Voice-2.1, en-US-Olivia:MAI-Voice-2.1, en-US-Sage:MAI-Voice-2.1, es-ES-Marta:MAI-Voice-2.1, es-MX-Alejo:MAI-Voice-2.1, es-MX-Grant:MAI-Voice-2.1, es-MX-Harper:MAI-Voice-2.1, es-MX-Valeria:MAI-Voice-2.1, fi-FI-Grant:MAI-Voice-2.1, fi-FI-Harper:MAI-Voice-2.1, fr-FR-Grant:MAI-Voice-2.1, fr-FR-Harper:MAI-Voice-2.1, fr-FR-Marc:MAI-Voice-2.1, fr-FR-Soleil:MAI-Voice-2.1, hi-IN-Arjun:MAI-Voice-2.1, hi-IN-Dhruv:MAI-Voice-2.1, hi-IN-Grant:MAI-Voice-2.1, hi-IN-Harper:MAI-Voice-2.1, hi-IN-Kavya:MAI-Voice-2.1, hi-IN-Priya:MAI-Voice-2.1, hu-HU-Bence:MAI-Voice-2.1, hu-HU-Grant:MAI-Voice-2.1, hu-HU-Harper:MAI-Voice-2.1, hu-HU-Levente:MAI-Voice-2.1, hu-HU-Lilla:MAI-Voice-2.1, hu-HU-Reka:MAI-Voice-2.1, id-ID-Grant:MAI-Voice-2.1, id-ID-Harper:MAI-Voice-2.1, it-IT-Grant:MAI-Voice-2.1, it-IT-Harper:MAI-Voice-2.1, it-IT-Luca:MAI-Voice-2.1, it-IT-Rosa:MAI-Voice-2.1, ko-KR-Grant:MAI-Voice-2.1, ko-KR-Haena:MAI-Voice-2.1, ko-KR-Harper:MAI-Voice-2.1, ko-KR-Junho:MAI-Voice-2.1, nb-NO-Grant:MAI-Voice-2.1, nb-NO-Harper:MAI-Voice-2.1, nl-NL-Grant:MAI-Voice-2.1, nl-NL-Harper:MAI-Voice-2.1, nl-NL-Sander:MAI-Voice-2.1, pl-PL-Grant:MAI-Voice-2.1, pl-PL-Harper:MAI-Voice-2.1, pt-BR-Caio:MAI-Voice-2.1, pt-BR-Grant:MAI-Voice-2.1, pt-BR-Harper:MAI-Voice-2.1, pt-BR-Luana:MAI-Voice-2.1, pt-BR-Pedro:MAI-Voice-2.1, pt-BR-Rafael:MAI-Voice-2.1, pt-PT-Grant:MAI-Voice-2.1, pt-PT-Harper:MAI-Voice-2.1, pt-PT-Rui:MAI-Voice-2.1, ro-RO-Andrei:MAI-Voice-2.1, ro-RO-Elena:MAI-Voice-2.1, ro-RO-Grant:MAI-Voice-2.1, ro-RO-Harper:MAI-Voice-2.1, ro-RO-Ioana:MAI-Voice-2.1, ro-RO-Radu:MAI-Voice-2.1, ru-RU-Grant:MAI-Voice-2.1, ru-RU-Harper:MAI-Voice-2.1, ru-RU-Lev:MAI-Voice-2.1, ru-RU-Masha:MAI-Voice-2.1, sv-SE-Grant:MAI-Voice-2.1, sv-SE-Harper:MAI-Voice-2.1, th-TH-Grant:MAI-Voice-2.1, th-TH-Harper:MAI-Voice-2.1, th-TH-Krit:MAI-Voice-2.1, th-TH-Nattapong:MAI-Voice-2.1, tr-TR-Aydin:MAI-Voice-2.1, tr-TR-Elif:MAI-Voice-2.1, tr-TR-Grant:MAI-Voice-2.1, tr-TR-Harper:MAI-Voice-2.1, vi-VN-Grant:MAI-Voice-2.1, vi-VN-Harper:MAI-Voice-2.1, zh-CN-Bo:MAI-Voice-2.1, zh-CN-Grant:MAI-Voice-2.1, zh-CN-Harper:MAI-Voice-2.1, zh-CN-Lan:MAI-Voice-2.1, zh-CN-Mei:MAI-Voice-2.1, zh-CN-Wei:MAI-Voice-2.1 | 기본값— | | 필드`response_format` | 유형`string` | 요건필수 | 값과 한도 mp3 | 기본값— | 입력 자료 조합 **text\_to\_speech** · 필수: input 메서드 매개변수와 수명 주기 | 매개변수 | 명세 | | --- | --- | | 매개변수`content_type` | 명세application/json | | 매개변수`required` | 명세model, input, voice, response\_format | | 매개변수`voice_ids` | 명세cs-CZ-Grant:MAI-Voice-2.1, cs-CZ-Harper:MAI-Voice-2.1, da-DK-Grant:MAI-Voice-2.1, da-DK-Harper:MAI-Voice-2.1, de-DE-Grant:MAI-Voice-2.1, de-DE-Harper:MAI-Voice-2.1, de-DE-Klaus:MAI-Voice-2.1, de-DE-Mia:MAI-Voice-2.1, en-AU-Isla:MAI-Voice-2.1, en-GB-Emily:MAI-Voice-2.1, en-GB-Harry:MAI-Voice-2.1, en-IN-Dhruv:MAI-Voice-2.1, en-IN-Priya:MAI-Voice-2.1, en-US-Ethan:MAI-Voice-2.1, en-US-Grant:MAI-Voice-2.1, en-US-Harper:MAI-Voice-2.1, en-US-Iris:MAI-Voice-2.1, en-US-Jasper:MAI-Voice-2.1, en-US-Olivia:MAI-Voice-2.1, en-US-Sage:MAI-Voice-2.1, es-ES-Marta:MAI-Voice-2.1, es-MX-Alejo:MAI-Voice-2.1, es-MX-Grant:MAI-Voice-2.1, es-MX-Harper:MAI-Voice-2.1, es-MX-Valeria:MAI-Voice-2.1, fi-FI-Grant:MAI-Voice-2.1, fi-FI-Harper:MAI-Voice-2.1, fr-FR-Grant:MAI-Voice-2.1, fr-FR-Harper:MAI-Voice-2.1, fr-FR-Marc:MAI-Voice-2.1, fr-FR-Soleil:MAI-Voice-2.1, hi-IN-Arjun:MAI-Voice-2.1, hi-IN-Dhruv:MAI-Voice-2.1, hi-IN-Grant:MAI-Voice-2.1, hi-IN-Harper:MAI-Voice-2.1, hi-IN-Kavya:MAI-Voice-2.1, hi-IN-Priya:MAI-Voice-2.1, hu-HU-Bence:MAI-Voice-2.1, hu-HU-Grant:MAI-Voice-2.1, hu-HU-Harper:MAI-Voice-2.1, hu-HU-Levente:MAI-Voice-2.1, hu-HU-Lilla:MAI-Voice-2.1, hu-HU-Reka:MAI-Voice-2.1, id-ID-Grant:MAI-Voice-2.1, id-ID-Harper:MAI-Voice-2.1, it-IT-Grant:MAI-Voice-2.1, it-IT-Harper:MAI-Voice-2.1, it-IT-Luca:MAI-Voice-2.1, it-IT-Rosa:MAI-Voice-2.1, ko-KR-Grant:MAI-Voice-2.1, ko-KR-Haena:MAI-Voice-2.1, ko-KR-Harper:MAI-Voice-2.1, ko-KR-Junho:MAI-Voice-2.1, nb-NO-Grant:MAI-Voice-2.1, nb-NO-Harper:MAI-Voice-2.1, nl-NL-Grant:MAI-Voice-2.1, nl-NL-Harper:MAI-Voice-2.1, nl-NL-Sander:MAI-Voice-2.1, pl-PL-Grant:MAI-Voice-2.1, pl-PL-Harper:MAI-Voice-2.1, pt-BR-Caio:MAI-Voice-2.1, pt-BR-Grant:MAI-Voice-2.1, pt-BR-Harper:MAI-Voice-2.1, pt-BR-Luana:MAI-Voice-2.1, pt-BR-Pedro:MAI-Voice-2.1, pt-BR-Rafael:MAI-Voice-2.1, pt-PT-Grant:MAI-Voice-2.1, pt-PT-Harper:MAI-Voice-2.1, pt-PT-Rui:MAI-Voice-2.1, ro-RO-Andrei:MAI-Voice-2.1, ro-RO-Elena:MAI-Voice-2.1, ro-RO-Grant:MAI-Voice-2.1, ro-RO-Harper:MAI-Voice-2.1, ro-RO-Ioana:MAI-Voice-2.1, ro-RO-Radu:MAI-Voice-2.1, ru-RU-Grant:MAI-Voice-2.1, ru-RU-Harper:MAI-Voice-2.1, ru-RU-Lev:MAI-Voice-2.1, ru-RU-Masha:MAI-Voice-2.1, sv-SE-Grant:MAI-Voice-2.1, sv-SE-Harper:MAI-Voice-2.1, th-TH-Grant:MAI-Voice-2.1, th-TH-Harper:MAI-Voice-2.1, th-TH-Krit:MAI-Voice-2.1, th-TH-Nattapong:MAI-Voice-2.1, tr-TR-Aydin:MAI-Voice-2.1, tr-TR-Elif:MAI-Voice-2.1, tr-TR-Grant:MAI-Voice-2.1, tr-TR-Harper:MAI-Voice-2.1, vi-VN-Grant:MAI-Voice-2.1, vi-VN-Harper:MAI-Voice-2.1, zh-CN-Bo:MAI-Voice-2.1, zh-CN-Grant:MAI-Voice-2.1, zh-CN-Harper:MAI-Voice-2.1, zh-CN-Lan:MAI-Voice-2.1, zh-CN-Mei:MAI-Voice-2.1, zh-CN-Wei:MAI-Voice-2.1 | | 매개변수`response_format` | 명세mp3 | | 매개변수`max_input_characters` | 명세null | | 매개변수`other_options` | 명세false | | 매개변수`input` | 명세정확한 UTF-8 텍스트; 정규화 없이 계산한 유니코드 문자 수 | | 매개변수`material_types` | 명세text | 수명 주기: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · 실제로 반환된 task\_id 또는 미디어 라이브러리 기록 `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` 이 모델 프로필에 있는 정확한 음성을 선택하세요. 입력 문자 수와 오디오 초는 서로 다른 측정 단위입니다. ### 요금 요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다. 빠른 모드 미지정 빠른 모드를 선택한 경우 Flex 모드 미지정 flex 모드를 선택한 경우 최대 추론 수준 미지정 최대 추론 수준에 default 조정값을 적용하는 경우 #### Ailoot 요금 #### 설정별 가격 각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요. | 설정 | 요금표 | 과금 대상 수량 | 과금 단위 | 요금 | | --- | --- | --- | --- | --- | | 설정기본 토큰 요금 | 요금표기본 요금 | 과금 대상 수량— | 과금 단위— | 요금 입력 · 입력 토큰 **—** / 1K 토큰 출력 · 출력 토큰 **—** / 1K 토큰 입력 · 캐시 읽기 **—** / 1K 토큰 입력 · 캐시 쓰기 **—** / 1K 토큰 입력 · 캐시 쓰기, 1시간 **—** / 1K 토큰 | | 설정Ultra | 요금표— | 과금 대상 수량한자를 포함해 Unicode 코드 포인트 하나를 문자 하나로 계산합니다. | 과금 단위입력 문자 1K개당 | 요금 입력 · 입력 문자 **$0.044** 입력 문자 1K개당 | #### 참조 요금 상세 정보 모델 수준의 참조 요금표는 메서드 선택, 견적 또는 요금을 변경하지 않습니다. 실제 과금에는 선택한 Ailoot 메서드 요금이 적용됩니다. Microsoft AI: MAI-Voice-2.1 #### 설정별 가격 | 설정 | 과금 조건 | 요금 | | --- | --- | --- | | 설정Microsoft AI: MAI-Voice-2.1 · 기본 설정 | 과금 조건기본 설정 | 요금 입력 · 입력 문자 수 **US$0.000044** 입력 문자당 | Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. [금액 확보와 정산 방식 →](https://ailoot.ai/docs/ko/billing/reserve/) ### 요청 예제 #### Ailoot Ultra · 음성 합성 curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" : "${AILOOT_VOICE_ID:?Choose an accepted voice ID from this exact model profile}" export AILOOT_VOICE_ID python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "microsoft/mai-voice-2.1", "input": "Good afternoon! This is a short voice take."}') voice=os.environ["AILOOT_VOICE_ID"] allowed=json.loads('["cs-CZ-Grant:MAI-Voice-2.1", "cs-CZ-Harper:MAI-Voice-2.1", "da-DK-Grant:MAI-Voice-2.1", "da-DK-Harper:MAI-Voice-2.1", "de-DE-Grant:MAI-Voice-2.1", "de-DE-Harper:MAI-Voice-2.1", "de-DE-Klaus:MAI-Voice-2.1", "de-DE-Mia:MAI-Voice-2.1", "en-AU-Isla:MAI-Voice-2.1", "en-GB-Emily:MAI-Voice-2.1", "en-GB-Harry:MAI-Voice-2.1", "en-IN-Dhruv:MAI-Voice-2.1", "en-IN-Priya:MAI-Voice-2.1", "en-US-Ethan:MAI-Voice-2.1", "en-US-Grant:MAI-Voice-2.1", "en-US-Harper:MAI-Voice-2.1", "en-US-Iris:MAI-Voice-2.1", "en-US-Jasper:MAI-Voice-2.1", "en-US-Olivia:MAI-Voice-2.1", "en-US-Sage:MAI-Voice-2.1", "es-ES-Marta:MAI-Voice-2.1", "es-MX-Alejo:MAI-Voice-2.1", "es-MX-Grant:MAI-Voice-2.1", "es-MX-Harper:MAI-Voice-2.1", "es-MX-Valeria:MAI-Voice-2.1", "fi-FI-Grant:MAI-Voice-2.1", "fi-FI-Harper:MAI-Voice-2.1", "fr-FR-Grant:MAI-Voice-2.1", "fr-FR-Harper:MAI-Voice-2.1", "fr-FR-Marc:MAI-Voice-2.1", "fr-FR-Soleil:MAI-Voice-2.1", "hi-IN-Arjun:MAI-Voice-2.1", "hi-IN-Dhruv:MAI-Voice-2.1", "hi-IN-Grant:MAI-Voice-2.1", "hi-IN-Harper:MAI-Voice-2.1", "hi-IN-Kavya:MAI-Voice-2.1", "hi-IN-Priya:MAI-Voice-2.1", "hu-HU-Bence:MAI-Voice-2.1", "hu-HU-Grant:MAI-Voice-2.1", "hu-HU-Harper:MAI-Voice-2.1", "hu-HU-Levente:MAI-Voice-2.1", "hu-HU-Lilla:MAI-Voice-2.1", "hu-HU-Reka:MAI-Voice-2.1", "id-ID-Grant:MAI-Voice-2.1", "id-ID-Harper:MAI-Voice-2.1", "it-IT-Grant:MAI-Voice-2.1", "it-IT-Harper:MAI-Voice-2.1", "it-IT-Luca:MAI-Voice-2.1", "it-IT-Rosa:MAI-Voice-2.1", "ko-KR-Grant:MAI-Voice-2.1", "ko-KR-Haena:MAI-Voice-2.1", "ko-KR-Harper:MAI-Voice-2.1", "ko-KR-Junho:MAI-Voice-2.1", "nb-NO-Grant:MAI-Voice-2.1", "nb-NO-Harper:MAI-Voice-2.1", "nl-NL-Grant:MAI-Voice-2.1", "nl-NL-Harper:MAI-Voice-2.1", "nl-NL-Sander:MAI-Voice-2.1", "pl-PL-Grant:MAI-Voice-2.1", "pl-PL-Harper:MAI-Voice-2.1", "pt-BR-Caio:MAI-Voice-2.1", "pt-BR-Grant:MAI-Voice-2.1", "pt-BR-Harper:MAI-Voice-2.1", "pt-BR-Luana:MAI-Voice-2.1", "pt-BR-Pedro:MAI-Voice-2.1", "pt-BR-Rafael:MAI-Voice-2.1", "pt-PT-Grant:MAI-Voice-2.1", "pt-PT-Harper:MAI-Voice-2.1", "pt-PT-Rui:MAI-Voice-2.1", "ro-RO-Andrei:MAI-Voice-2.1", "ro-RO-Elena:MAI-Voice-2.1", "ro-RO-Grant:MAI-Voice-2.1", "ro-RO-Harper:MAI-Voice-2.1", "ro-RO-Ioana:MAI-Voice-2.1", "ro-RO-Radu:MAI-Voice-2.1", "ru-RU-Grant:MAI-Voice-2.1", "ru-RU-Harper:MAI-Voice-2.1", "ru-RU-Lev:MAI-Voice-2.1", "ru-RU-Masha:MAI-Voice-2.1", "sv-SE-Grant:MAI-Voice-2.1", "sv-SE-Harper:MAI-Voice-2.1", "th-TH-Grant:MAI-Voice-2.1", "th-TH-Harper:MAI-Voice-2.1", "th-TH-Krit:MAI-Voice-2.1", "th-TH-Nattapong:MAI-Voice-2.1", "tr-TR-Aydin:MAI-Voice-2.1", "tr-TR-Elif:MAI-Voice-2.1", "tr-TR-Grant:MAI-Voice-2.1", "tr-TR-Harper:MAI-Voice-2.1", "vi-VN-Grant:MAI-Voice-2.1", "vi-VN-Harper:MAI-Voice-2.1", "zh-CN-Bo:MAI-Voice-2.1", "zh-CN-Grant:MAI-Voice-2.1", "zh-CN-Harper:MAI-Voice-2.1", "zh-CN-Lan:MAI-Voice-2.1", "zh-CN-Mei:MAI-Voice-2.1", "zh-CN-Wei:MAI-Voice-2.1"]') if voice not in allowed: raise SystemExit("Choose an accepted voice ID from this exact model profile") p["voice"]=voice p["response_format"]="mp3" Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o speech.mp3 ``` ### 결과 수신 및 저장 #### Ailoot Ultra · 음성 합성 mp3 - `GET /v1/media/tasks/{task_id}` - `GET /v1/media/assets/{asset_id}/content` - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` 기타 콘텐츠 조회 미디어 라이브러리작업 상태자산 세부 정보 ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \ -H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" : "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}" export AILOOT_MEDIA_TASK_ID resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))') curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \ -H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json python3 - <<'PY_RESULT' import json from pathlib import Path print(json.dumps(json.loads(Path("media-task.json").read_text()))) PY_RESULT ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" : "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}" export AILOOT_ASSET_ID resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))') curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \ -H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json python3 - <<'PY_RESULT' import json from pathlib import Path print(json.dumps(json.loads(Path("media-asset.json").read_text()))) PY_RESULT ``` ##### 완료된 결과 모두 보관 반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요. 바이너리 결과 전체와 헤더를 보관하세요. JSON 또는 여러 출력이 반환되면 모든 데이터 항목을 보관하고 실제로 반환된 서명된 자산 URL을 각각 조회하세요. ##### 원래 응답을 확인해야 할 경우 다시 제출하지 말고 정산 대조를 위해 최초 operation\_id/X-Client-Request-ID를 보관하세요. 전용 오디오 폴링 라우트는 없습니다. 응답 필드 | 필드 | 유형 | | --- | --- | | 필드`binary audio` | 유형bytes | | 필드`response headers` | 유형headers | 오류와 다음 단계 | 응답 | 조건 | 다음 단계 | | --- | --- | --- | | 응답400 · `invalid_request_error` | 조건필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음 | 다음 단계새 생성 요청 전에 표시된 필드를 수정하세요. | | 응답`server_error` | 조건반환된 응답에 작업 또는 결과 확인이 필요하다고 표시되어 있습니다 | 다음 단계최초로 반환된 작업/태스크 ID, 요청 헤더와 응답을 보관하고, 지원되는 조회 방식으로 해당 최초 작업을 계속 조회하세요. 생성 요청을 다시 제출하지 마세요. | ### 별칭 #### 모델 별칭 **Ailoot Ultra** [`microsoft/mai-voice-2.1`](https://ailoot.ai/models/ko/#m=microsoft%2Fmai-voice-2.1&route=Ultra&caller=microsoft%2Fmai-voice-2.1&fmt=speech) #### 메서드 경로 별칭 위에 표시된 메서드 경로를 사용하세요. #### 관련 호출용 ID [`microsoft/mai-voice-2.1`](https://ailoot.ai/models/ko/#m=microsoft%2Fmai-voice-2.1&route=Ultra&caller=microsoft%2Fmai-voice-2.1&fmt=speech) FAQ · Microsoft AI: MAI-Voice-2.1 어떤 입력과 결과를 사용할 수 있나요? `POST /v1/audio/speech` · `microsoft/mai-voice-2.1`: `text` → `audio` 요청은 어떤 필드를 사용하나요? `POST /v1/audio/speech` · `microsoft/mai-voice-2.1`: `model`, `input`, `voice`, `response_format` Claude Code, OpenCode, Hermes, 자체 앱에 Ailoot를 연결하세요. ## 회사와 그 프로젝트 포트폴리오 회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출. ## 할인받아 토큰을 구매하세요. 정기 작업에는 구독 할인, 토큰 구매에는 최대 50% 프로모션 코드. 구독 정기 요청에 맞는 할인 요금제를 선택하세요. 최대 50% 프로모션 코드 구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다. 이력의 지출 요청마다 모델, 토큰, 금액을 저장합니다. [구독 선택](https://ailoot.ai/docs/ko/billing/subscriptions/) · [모델 가격 보기](https://ailoot.ai/models/ko/) ## 판매하는 제품에 API를 연결하세요. Ailoot 공식 이용 조건과 라이선스 계약으로 SaaS, 앱, 봇에 사용하세요. 재판매에는 리셀러 라이선스를 요청하세요. 상업용 앱 서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요. 리셀러 라이선스 프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요. 사이트의 문서 연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다. [리셀러 라이선스 요청](mailto:support@ailoot.ai) · [공식 이용 조건과 라이선스 계약](https://ailoot.ai/legal/offer?lang=ko) ## Ailoot · 회사와 그 프로젝트 포트폴리오 Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다. 회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출. Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.