Runway 사운드 효과 생성
Runway API로 텍스트 프롬프트에서 사운드 효과 또는 오디오 장면을 생성합니다.
curl https://api.cometapi.com/runwayml/v1/sound_effect \
--request POST \
--header "Authorization: Bearer $COMETAPI_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "eleven_text_to_sound_v2",
"promptText": "Gentle rain falling on a wooden roof with distant thunder.",
"duration": 5.5,
"loop": true
}'{
"id": "123e4567-e89b-42d3-a456-426614174000"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}POST /runwayml/v1/sound_effect을 사용하여 텍스트 프롬프트에서 오디오 작업을 생성합니다.
Bearer 인증과 JSON 요청 본문으로 CometAPI API 키를 전송합니다.
모델 선택
| 모델 ID | 필수 입력 | 선택적 제어 항목 |
|---|---|---|
eleven_text_to_sound_v2 | promptText 1~3000자 | duration 소수 초를 포함해 0.5~30초 loop |
seed_audio | promptText 1~2048자 | 최대 세 개의 referenceAudios, 음성, 음량 및 피치 제어, 출력 형식 |
eleven_text_to_sound_v2의 경우, 길이를 선택하려면 duration를 생략하고
프롬프트에서 길이를 지정합니다. 반복 사운드 효과를 요청하려면 loop: true을 설정합니다.
seed_audio의 경우, 프롬프트에서 referenceAudios을 @Audio1, @Audio2,
그리고 @Audio3으로 배열 순서대로 참조하세요. 참조가 필요하지 않으면 referenceAudios을 생략하세요.
각 예제 오디오 URL을 오디오 파일에 접근할 수 있는 HTTPS URL로 교체하세요.
이 엔드포인트에서 이 모델과 함께 duration, loop 또는 voice을 포함하지 마세요.
오디오 제어 구성
| 필드 | 값 | 의미 |
|---|---|---|
speechRate | -50~100의 정수 | 음수는 음성을 느리게 하고 양수는 빠르게 합니다. |
loudnessRate | -50~100의 정수 | 음수는 볼륨을 낮추고 양수는 높입니다. |
pitchRate | -12~12의 정수 | 반음 단위의 피치 이동입니다. |
sampleRate | 8000, 16000, 24000, 32000, 44100, 48000 | Hz 단위의 오디오 샘플 레이트입니다. |
outputFormat | wav, mp3, ogg_opus | 출력 오디오 형식입니다. |
0을 사용하여 기본값을 유지하세요.
결과 조회
반환된id을 저장한 다음 Runway 작업 가져오기
를 사용하여 작업 상태를 조회하세요. status가 SUCCEEDED이면 오디오 URL은
output에서 읽으세요. 작업이 실패하면 failure 및 failureCode을 확인하세요.인증
Use your CometAPI API key.
본문
- eleven_text_to_sound_v2
- seed_audio
Request settings for eleven_text_to_sound_v2.
Model ID for this request.
eleven_text_to_sound_v2 "eleven_text_to_sound_v2"A text description of the sound effect to generate.
1 - 3000Sound effect duration in seconds, from 0.5 to 30. Fractional seconds are accepted. Omit this field to choose duration from the prompt.
0.5 <= x <= 30Set true to request a sound effect that loops seamlessly. Defaults to false.
응답
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
curl https://api.cometapi.com/runwayml/v1/sound_effect \
--request POST \
--header "Authorization: Bearer $COMETAPI_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "eleven_text_to_sound_v2",
"promptText": "Gentle rain falling on a wooden roof with distant thunder.",
"duration": 5.5,
"loop": true
}'{
"id": "123e4567-e89b-42d3-a456-426614174000"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}