Runway는 9월 30일 개발자 API에 Eleven v4를 추가했습니다. 릴리스 노트 는 모델을 eleven_v4로 표시하고 스크립트를 2,500자로 제한하며, 크레딧 요금이 2026년 10월 12일 태평양 시간에 오른다고 합니다. 음성 생성을 프로덕션 워크플로에 추가하는 개발자에게 중요한 질문은 유효한 요청에 무엇이 필요하며 문서화된 요금이 달러로 얼마인지입니다. 이 가이드는 10월 6일 확인한 Runway 문서를 바탕으로 합니다. BIG CHANGE는 유료 API 호출을 하지 않았고 오디오를 평가하지 않았습니다.
큰 변화
- 무엇이 바뀌었나: Runway는 이제 기존 작업 API 뒤에서 사용할 수 있는 텍스트 음성 변환 모델로 Eleven v4를 제공합니다. 스크립트에는 문서에 나온 오디오 태그(예:
[laughs],[whispers],[pause])를 넣을 수 있으며 총 길이는 2,500자를 넘지 않아야 합니다. - 왜 중요한가: Runway 개발자 프로젝트가 있는 팀은 프리셋 음성으로 음성을 요청하고 완료된 작업의 오디오 URL을 가져올 수 있습니다. 통합과 예산 계획에는 문서화된 요청 형식과 날짜가 적힌 요금표를 쓸 수 있습니다.
- 주의할 점: Runway는 요금이 2026년 10월 12일 태평양 시간부터 1,000자당 2.2크레딧에서 5크레딧으로 바뀐다고 합니다. 반복 생성 비용을 추산할 때 요청이 청구될 때 적용되는 요금을 쓰고 예산 확정 전에 현재 가격을 확인하세요.
프로젝트와 키 설정
Runway의 설정 가이드 에 따르면 개발자 포털에서 계정과 프로젝트를 만든 다음 API Keys에서 프로젝트 API 키를 만듭니다. 키 생성 또는 비활성화에는 Admin이나 Developer 역할이 필요합니다. 키는 한 번만 평문으로 표시되므로 안전하게 보관하세요. SDK를 쓸 때 Runway는 RUNWAYML_API_SECRET을 설정하라고 합니다. SDK가 이 환경 변수를 자동으로 읽습니다. 비밀 값을 소스 코드에 넣지 마세요.
API를 쓰려면 프로젝트에 크레딧도 있어야 합니다. Runway에 따르면 최초 최소 결제액은 $10이고 크레딧당 $0.01입니다. 프로젝트 결제 탭에서 결제합니다. 크레딧 추가에는 Admin 또는 Billing admin 역할이 필요합니다. 이는 최소 크레딧 구매액이지 음성 요청 1회의 요금이 아닙니다. 설정 페이지는 첫 호출이 무료라고 설명하지 않습니다.
텍스트 음성 변환 요청 보내기
Runway의 현재 Python SDK 요청 유형 은 Eleven v4에 대해 model, prompt_text , voice 객체를 요구합니다. 실제 JSON 필드는 model, promptText , voice이며 voice.type 을 runway-preset 로 설정하고 presetId를 포함합니다. Bernard 은 나열된 프리셋 중 하나입니다. SDK 서비스 는 이 요청을 /v1/text_to_speech 에 보내 새 작업 응답을 반환합니다. Runway API 가이드 는 직접 HTTP 호출의 호스트, Bearer 키, X-Runway-Version: 2024-11-06 헤더를 설명합니다.
아래 요청 본문은 문서에서 구성한 것으로, 실제로 호출한 내용이 아닙니다:
{
"model": "eleven_v4",
"promptText": "The recording begins now. [pause] Welcome.",
"voice": {
"type": "runway-preset",
"presetId": "Bernard"
}
}Runway의 9월 30일 변경 기록 은 [laughs], [whispers] , [pause] 을 지원 예시로 들며 Eleven v4가 Eleven v3와 같은 Runway 프리셋 음성을 쓴다고 합니다. 태그도 스크립트 일부이므로 2,500자 제한에 포함해야 합니다. SDK에는 선택적 음성 설정, 언어, 인접 텍스트 필드도 있습니다. 스키마만으로 특정 설정이 특정 표현을 보장한다고 할 수 없으며 이 글은 음질이나 지연을 주장하지 않습니다.
첫 응답은 오디오 바이트가 아니라 작업입니다. Runway 출력 가이드 는 GET /v1/tasks/:id를 조회하라고 합니다. 성공한 작업에는 결과 URL output 배열이 있습니다. API에 접근한 시점부터 URL은 24~48시간 안에 만료되므로 제품에서 임시 URL을 쓰지 말고 결과를 자체 저장소에 내려받으세요. 일반 출력 예시는 비디오 작업으로 응답 형식을 보여 줍니다. 반면 모델 목록 은 Eleven v4 출력을 오디오로 분류합니다. Eleven v4 응답을 실제로 관찰하지 않았고 오디오 파일 형식도 확인하지 않았습니다.
날짜별 요금 계산
Runway 가격 페이지 와 릴리스 노트에는 태평양 시간 2026년 10월 12일까지 1,000자당 2.2크레딧, 이후 1,000자당 5크레딧, 그리고 최소 1크레딧이라고 나옵니다. 공개된 크레딧당 $0.01로 계산하면 각각 $0.022 와 1,000자당 $0.05 이며 적용 가능한 세금은 별도입니다. 이후 요금은 이전 요금의 약 2.27배입니다.
투명한 계획 예시로 과금 대상 문자가 정확히 1,000자인 스크립트 10개를 각각 요청하면 총 10,000자입니다. 공개 요금으로 계산하면 이전 요금에서는 22크레딧 또는 $0.22, 이후에는 50크레딧 또는 $0.50입니다. 각 스크립트는 2,500자 제한보다 짧고 계산된 요청마다 최소 1크레딧보다 많습니다. 이는 Runway 공개 요금으로 계산한 예이지 실제 청구서가 아닙니다. 인용 페이지는 태그를 과금 문자에 어떻게 포함하는지, 요청별 소수 크레딧을 반올림하는지 설명하지 않습니다. 프로덕션 추정 도구는 실제 사용 기록과 최신 약관을 확인해야 합니다.
출처 및 추가 자료
Runway의 9월 30일 API 변경 기록 은 출시일, 모델 ID, 태그 예시, 스크립트 제한, 날짜별 가격 안내를 확인해 줍니다. 설정 가이드 는 역할 권한과 최초 $10 결제를 포함해 프로젝트, 키, 크레딧 전제 조건을 설명합니다. 가격 페이지 는 크레딧의 달러 환산과 표시된 Eleven v4 요금을 제공합니다.
이 Python SDK 요청 스키마 와 서비스 구현 을 통해 확인한 필드 이름, 프리셋 음성 형식, 엔드포인트 경로, 작업 생성 응답을 파악했습니다. Runway 시작 가이드, 모델 목록 , 출력 가이드 에는 HTTP 버전 헤더, 오디오 출력 분류, 작업 조회 방식이 나옵니다. 이는 제공업체 문서이지 독립 성능 시험이 아닙니다. 2026년 10월 6일 확인.
