오디오
텍스트로 Runway 음성 생성
Runway API를 사용하여 프리셋 음성 또는 참조 오디오로 텍스트를 음성으로 변환합니다.
POST
/
runwayml
/
v1
/
text_to_speech
curl https://api.cometapi.com/runwayml/v1/text_to_speech \
--request POST \
--header "Authorization: Bearer $COMETAPI_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "eleven_multilingual_v2",
"promptText": "Welcome to our audio guide. Let us begin the tour.",
"voice": {
"type": "runway-preset",
"presetId": "Maya"
}
}'{
"id": "123e4567-e89b-42d3-a456-426614174000"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}POST /runwayml/v1/text_to_speech을 사용하여 텍스트에서 음성 작업을 생성합니다.
Bearer 인증과 JSON 요청 본문으로 CometAPI API 키를 전송합니다.
모델 및 음성 선택
모든 요청에는model 및 promptText가 필요합니다. voice 필드는
eleven_multilingual_v2, eleven_v3, eleven_v4에는 필수이며 seed_audio에는 선택 사항입니다.
| 모델 ID | 텍스트 제한 | 음성 구성 |
|---|---|---|
eleven_multilingual_v2 | UTF-16 코드 단위 1000개 | type: runway-preset 및 presetId(예: Maya |
eleven_v3 | 문자 5000개 | type: runway-preset 및 presetId(예: Maya |
eleven_v4 | 비어 있지 않은 텍스트 | type: runway-preset 및 presetId(예: Maya |
seed_audio | 문자 2048개 | 기본 음성을 사용하려면 voice을 생략하거나 type: reference-audio 및 audioUri |
presetId을 선택합니다. seed_audio의 경우
예시 audioUri을 음성 참조에 접근할 수 있는 HTTPS URL로 바꿉니다.
음성 표현 조정
eleven_v3에서 promptText는 [whispers] 같은 표현 태그를 포함할 수 있으며
[laughs]도 사용할 수 있습니다. 모델은 다음 제어도 지원합니다:
| 필드 | 값 | 의미 |
|---|---|---|
stability | 0~1의 숫자 | 0이 아닌 낮은 값은 더 많은 표현을 허용하고, 높은 값은 더 안정적입니다. |
similarityBoost | 0~1의 숫자 | 값이 높을수록 선택한 음성을 더 충실하게 따릅니다. |
style | 0~1의 숫자 | 값이 높을수록 음성 스타일을 더 강조합니다. |
speed | 0.7~1.2의 숫자 | 1 일반 속도를 사용합니다. |
useSpeakerBoost | true | 선택한 음성과의 유사도를 더 높게 요청합니다. |
languageCode | ISO 639-1 언어 코드 | 발음과 텍스트 정규화를 안내합니다. |
applyTextNormalization | auto, on, off | 숫자와 같은 텍스트가 음성 단어로 변환되는 방식을 제어합니다. |
seed | 1~4294967295의 정수 | 샘플링 시드를 설정합니다. |
stability, similarityBoost, style의 경우 0 값은 모델
기본값을 사용하며, 필드를 생략해도 마찬가지입니다. useSpeakerBoost: false도 모델
기본값을 사용합니다. 샘플링 시드를 설정하려면 양의 정수를 사용하세요. seed: 0은 시드를
자동으로 선택합니다.
Eleven v4 음성 조정
eleven_v4에서 promptText가 지원하는 표현 태그에는 [laughs],
[whispers], 그리고 [pause]가 포함됩니다. 다음 선택적 제어를 사용하세요:
| 필드 | 값 | 의미 |
|---|---|---|
stability | 0~1의 숫자 | 낮은 값은 더 넓은 감정 범위를 허용하고, 높은 값은 더 안정적입니다. |
similarityBoost | 0~1의 숫자 | 출력이 선택한 음성을 얼마나 충실하게 따를지 설정합니다. |
style | 0~1의 숫자 | 값이 높을수록 화자 스타일을 강화합니다. |
speed | 0.7~1.2의 숫자 | 1 미만 값은 음성을 느리게 하고, 1 초과 값은 빠르게 합니다. |
useSpeakerBoost | true 또는 false | 선택한 음성과의 유사도를 높입니다. |
languageCode | 2~16자 | 예를 들어 en 또는 pt-BR처럼 발음을 강제합니다. |
previousText | 문자열 | 이 요청 전에 생성된 텍스트에서 음성을 이어갑니다. |
nextText | 문자열 | 이 요청 후에 생성될 텍스트로 음성을 연결합니다. |
seed | 0~4294967295의 정수 | 더 일관된 출력을 위해 시드를 선택합니다. |
eleven_v4는 applyTextNormalization을 사용하지 않습니다. previousText 및
nextText 필드는 인접 세그먼트를 생성하면서
모델이 전환을 일관되게 유지하게 하려는 경우 유용합니다.
음성 속도 및 형식 조정
seed_audio에서는 speechRate 및 loudnessRate에 -50pitchRate 에는 -120로 설정하면 기본값이 유지됩니다.
sampleRate 값은 8000, 16000, 24000, 32000, 44100 또는 48000 Hz로 설정합니다.
outputFormat에는 wav, mp3 또는 ogg_opus 중 하나를 설정합니다. 이 엔드포인트에서는 duration,
referenceAudios또는 seed_audio를 사용한 Eleven v3 컨트롤을 포함하지 마세요.
결과 가져오기
반환된id를 저장한 다음 Runway 작업 가져오기
을 사용하여 작업 상태를 가져옵니다. status 값이 SUCCEEDED이면 오디오 URL은 다음 위치에서 확인:
output. 작업이 실패하면 failure 및 failureCode 값을 확인하세요.인증
Use your CometAPI API key.
본문
application/json
- eleven_multilingual_v2
- eleven_v3
- eleven_v4
- seed_audio
Request settings for eleven_multilingual_v2.
Model ID for this request.
사용 가능한 옵션:
eleven_multilingual_v2 Allowed value:
"eleven_multilingual_v2"Text to speak, from 1 to 1000 UTF-16 code units.
Required string length:
1 - 1000The voice to use for the generated speech.
Show child attributes
Show child attributes
응답
Task created. Save the returned id to retrieve task status.
Task ID for GET /runwayml/v1/tasks/{id}.
Task state, when returned.
Task submission timestamp, when returned.
Result URLs, when returned.
Failure explanation, when returned.
Machine-readable failure code, when returned.
Task estimate metadata, when returned.
Show child attributes
Show child attributes
Task cost metadata, when returned.
Show child attributes
Show child attributes
마지막 수정일 2026년 10월 11일
⌘I
curl https://api.cometapi.com/runwayml/v1/text_to_speech \
--request POST \
--header "Authorization: Bearer $COMETAPI_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "eleven_multilingual_v2",
"promptText": "Welcome to our audio guide. Let us begin the tour.",
"voice": {
"type": "runway-preset",
"presetId": "Maya"
}
}'{
"id": "123e4567-e89b-42d3-a456-426614174000"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}