메인 콘텐츠로 건너뛰기
POST
POST /runwayml/v1/speech_to_speech를 사용하여 녹음된 대화를 사전 설정 음성으로 변환합니다. 모델 ID는 eleven_multilingual_sts_v2입니다. Bearer 인증과 JSON 요청 본문으로 CometAPI API 키를 전송합니다.

대화와 음성 제공

예시 미디어 URL을 소스 파일 URL로 바꿉니다. 비디오를 사용하는 경우 media.type를 video로 변경하고 해당 비디오 URL을 media.uri에 제공합니다. removeBackgroundNoise: true을 설정하여 생성된 음성에서 배경 소음을 제거합니다. 모델 기본값을 사용하려면 이 필드를 생략합니다.

결과 가져오기

반환된 id을 저장한 다음 Runway 작업 가져오기 를 사용하여 작업 상태를 조회합니다. status이 SUCCEEDED인 경우, 결과 미디어를 output의 URL에서 다운로드합니다. 작업이 실패하면 failure을 확인하고 failureCode.

인증

Authorization
string
header
필수

Use your CometAPI API key.

본문

application/json

Request settings for eleven_multilingual_sts_v2.

model
enum<string>
필수

Model ID for this request.

사용 가능한 옵션:
eleven_multilingual_sts_v2
Allowed value: "eleven_multilingual_sts_v2"
media
SpeechToSpeechAudio · object
필수

Audio or video file containing the dialogue to convert.

voice
RunwayPresetVoice · object
필수

The voice to use for the generated speech.

removeBackgroundNoise
boolean

Set true to remove background noise from the generated speech. Omit or use false for the model default.

응답

Task created. Save the returned id to retrieve task status.

id
string
필수

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

마지막 수정일 2026년 9월 21일