Markdown 버전

AI-translated from English; not yet reviewed by a fluent editor.

# Runway Eleven v4 음성 API: 요청 형식과 10월 요금

> Runway의 Eleven v4 음성 API는 최대 2,500자 스크립트를 받습니다. 문서에 기반한 이 가이드는 요청, 작업 결과, 계정 설정, 10월 12일 가격 변경을 설명합니다.

By BIG CHANGE Editorial

Published: 2026-10-06T06:30:01.909Z
Updated: 2026-10-06T06:30:01.909Z
Canonical: https://bigchange.ai/blog/runway-eleven-v4-text-to-speech-api-price-change

![Conceptual charcoal illustration of unbranded headphones resting beside a loose script sheet with abstract text strokes.](https://bigchange.ai/api/media/file/runway-eleven-script-audio-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE. A written script and headphones represent text-to-speech; no API test or audio assessment is depicted.

Runway는 9월 30일 개발자 API에 Eleven v4를 추가했습니다. [릴리스 노트](https://docs.dev.runwayml.com/api-details/api_changelog/) 는 모델을 `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의 [설정 가이드](https://docs.dev.runwayml.com/guides/setup/) 에 따르면 개발자 포털에서 계정과 프로젝트를 만든 다음 API Keys에서 프로젝트 API 키를 만듭니다. 키 생성 또는 비활성화에는 Admin이나 Developer 역할이 필요합니다. 키는 한 번만 평문으로 표시되므로 안전하게 보관하세요. SDK를 쓸 때 Runway는 `RUNWAYML_API_SECRET`을 설정하라고 합니다. SDK가 이 환경 변수를 자동으로 읽습니다. 비밀 값을 소스 코드에 넣지 마세요.

API를 쓰려면 프로젝트에 크레딧도 있어야 합니다. Runway에 따르면 최초 최소 결제액은 **$10**이고 **크레딧당 $0.01**입니다. 프로젝트 결제 탭에서 결제합니다. 크레딧 추가에는 Admin 또는 Billing admin 역할이 필요합니다. 이는 최소 크레딧 구매액이지 음성 요청 1회의 요금이 아닙니다. 설정 페이지는 첫 호출이 무료라고 설명하지 않습니다.

## 텍스트 음성 변환 요청 보내기

Runway의 [현재 Python SDK 요청 유형](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) 은 Eleven v4에 대해 `model`, `prompt_text` , `voice` 객체를 요구합니다. 실제 JSON 필드는 `model`, `promptText` , `voice`이며 `voice.type` 을 `runway-preset` 로 설정하고 `presetId`를 포함합니다. `Bernard` 은 나열된 프리셋 중 하나입니다. [SDK 서비스](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) 는 이 요청을 `/v1/text_to_speech` 에 보내 새 작업 응답을 반환합니다. Runway [API 가이드](https://docs.dev.runwayml.com/guides/using-the-api/) 는 직접 HTTP 호출의 호스트, Bearer 키, `X-Runway-Version: 2024-11-06` 헤더를 설명합니다.

아래 요청 본문은 문서에서 구성한 것으로, 실제로 호출한 내용이 아닙니다:

```json
{
  "model": "eleven_v4",
  "promptText": "The recording begins now. [pause] Welcome.",
  "voice": {
    "type": "runway-preset",
    "presetId": "Bernard"
  }
}
```

Runway의 9월 30일 [변경 기록](https://docs.dev.runwayml.com/api-details/api_changelog/) 은 `[laughs]`, `[whispers]` , `[pause]` 을 지원 예시로 들며 Eleven v4가 Eleven v3와 같은 Runway 프리셋 음성을 쓴다고 합니다. 태그도 스크립트 일부이므로 2,500자 제한에 포함해야 합니다. SDK에는 선택적 음성 설정, 언어, 인접 텍스트 필드도 있습니다. 스키마만으로 특정 설정이 특정 표현을 보장한다고 할 수 없으며 이 글은 음질이나 지연을 주장하지 않습니다.

첫 응답은 오디오 바이트가 아니라 작업입니다. Runway [출력 가이드](https://docs.dev.runwayml.com/assets/outputs/) 는 `GET /v1/tasks/:id`를 조회하라고 합니다. 성공한 작업에는 결과 URL `output` 배열이 있습니다. API에 접근한 시점부터 URL은 24\~48시간 안에 만료되므로 제품에서 임시 URL을 쓰지 말고 결과를 자체 저장소에 내려받으세요. 일반 출력 예시는 비디오 작업으로 응답 형식을 보여 줍니다. 반면 [모델 목록](https://docs.dev.runwayml.com/guides/models/) 은 Eleven v4 출력을 오디오로 분류합니다. Eleven v4 응답을 실제로 관찰하지 않았고 오디오 파일 형식도 확인하지 않았습니다.

## 날짜별 요금 계산

Runway [가격 페이지](https://docs.dev.runwayml.com/guides/pricing/) 와 릴리스 노트에는 태평양 시간 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 변경 기록](https://docs.dev.runwayml.com/api-details/api_changelog/) 은 출시일, 모델 ID, 태그 예시, 스크립트 제한, 날짜별 가격 안내를 확인해 줍니다. [설정 가이드](https://docs.dev.runwayml.com/guides/setup/) 는 역할 권한과 최초 $10 결제를 포함해 프로젝트, 키, 크레딧 전제 조건을 설명합니다. [가격 페이지](https://docs.dev.runwayml.com/guides/pricing/) 는 크레딧의 달러 환산과 표시된 Eleven v4 요금을 제공합니다.

이 [Python SDK 요청 스키마](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) 와 [서비스 구현](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) 을 통해 확인한 필드 이름, 프리셋 음성 형식, 엔드포인트 경로, 작업 생성 응답을 파악했습니다. Runway [시작 가이드](https://docs.dev.runwayml.com/guides/using-the-api/), [모델 목록](https://docs.dev.runwayml.com/guides/models/) , [출력 가이드](https://docs.dev.runwayml.com/assets/outputs/) 에는 HTTP 버전 헤더, 오디오 출력 분류, 작업 조회 방식이 나옵니다. 이는 제공업체 문서이지 독립 성능 시험이 아닙니다. 2026년 10월 6일 확인.

## Sources

- [Runway Dev API 변경 기록: Eleven v4](https://docs.dev.runwayml.com/api-details/api_changelog/) — Runway의 9월 30일 항목은 eleven_v4, 2,500자 제한, 세 가지 오디오 태그 예시, Runway 프리셋 음성, 10월 12일 태평양 시간부터 1,000자당 2.2에서 5크레딧으로 인상(최소 1크레딧)을 알립니다. 음질이나 BIG CHANGE의 성공적인 API 호출을 입증하지 않습니다.
- [Runway Dev API 설정](https://docs.dev.runwayml.com/guides/setup/) — 계정, 프로젝트, API 키, 역할 전제 조건, SDK 비밀 환경 변수, 크레딧당 $0.01 기준 최초 최소 $10 구매를 설명합니다. 제공업체 안내이지 이 글에서 시험한 단계는 아닙니다.
- [Runway Dev API 가격](https://docs.dev.runwayml.com/guides/pricing/) — Eleven v4의 날짜별 두 크레딧 요금과 크레딧당 $0.01을 나열합니다. 글의 $0.22와 $0.50 예시는 1,000자 요청 10회의 계산이지 실제 청구액이 아닙니다. 판매세가 붙을 수 있습니다.
- [Runway Python SDK: 텍스트 음성 변환 요청 스키마](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) — 현재 공식 SDK main 브랜치는 필수 ElevenV4 모델, promptText 별칭, presetId가 있는 runway-preset 음성을 정의하며 Bernard도 나열합니다. main은 바뀔 수 있고 요청은 실행하지 않았습니다.
- [Runway Python SDK: 텍스트 음성 변환 서비스](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) — 현재 공식 SDK 서비스는 /v1/text_to_speech에 요청을 보내 새 작업 응답을 반환합니다. 이는 관찰된 Eleven v4 응답이 아닙니다.
- [Runway Dev: API 사용](https://docs.dev.runwayml.com/guides/using-the-api/) — API 호스트, Bearer 키, X-Runway-Version 2024-11-06 헤더, 생성 예시의 작업 ID 형식을 설명합니다. 확인한 예시는 Eleven v4 호출이 아닙니다.
- [Runway Dev: 출력 형식](https://docs.dev.runwayml.com/assets/outputs/) — GET /v1/tasks/:id, 성공 작업의 출력 URL 배열, 24~48시간 후 URL 만료를 설명합니다. 예시는 비디오 작업이므로 Eleven v4 오디오 형식을 추론하지 않습니다.
- [Runway Dev: 사용 가능한 모델](https://docs.dev.runwayml.com/guides/models/) — eleven_v4를 텍스트 입력 및 오디오 출력으로 표시합니다. 이는 모델 분류이지 오디오를 독립적으로 살펴본 결과가 아닙니다.