AI-translated from English; not yet reviewed by a fluent editor.
# API de voz Eleven v4 da Runway: formato da solicitação e preços de outubro
> A API de voz Eleven v4 da Runway aceita roteiros de até 2.500 caracteres. Este guia baseado na documentação explica a solicitação, o resultado da tarefa, a configuração da conta e a mudança de preço em 12 de outubro.
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

AI-generated conceptual illustration by BIG CHANGE. A written script and headphones represent text-to-speech; no API test or audio assessment is depicted.
A Runway adicionou o Eleven v4 à sua API para desenvolvedores em 30 de setembro. A [nota de lançamento](https://docs.dev.runwayml.com/api-details/api_changelog/) identifica o modelo como `eleven_v4`, limita o roteiro a 2.500 caracteres e informa que a tarifa em créditos aumentará em 12 de outubro de 2026, no horário do Pacífico. Para desenvolvedores que adicionam geração de fala a um fluxo de produção, a pergunta prática é o que uma solicitação válida exige e quanto a tarifa documentada representa em dólares. Este guia se baseia na documentação da Runway consultada em 6 de outubro; a BIG CHANGE não fez uma chamada paga à API nem avaliou o áudio.
## A grande mudança
- **O que mudou:** A Runway agora lista o Eleven v4 como modelo de conversão de texto em fala por trás de sua API de tarefas existente. Um roteiro pode incluir tags de áudio documentadas, como `[laughs]`, `[whispers]` e `[pause]`, respeitando o limite de 2.500 caracteres.
- **Por que isso importa:** Uma equipe com um projeto de desenvolvedor da Runway pode solicitar fala usando uma voz predefinida e recuperar a URL do áudio da tarefa concluída. O planejamento da integração e do orçamento pode usar um formato de solicitação documentado e uma tabela de preços com datas definidas.
- **O que acompanhar:** A Runway diz que a tarifa muda de 2,2 para 5 créditos por 1.000 caracteres em 12 de outubro de 2026, no horário do Pacífico. Quem estima gerações repetidas precisa usar a tarifa vigente quando a solicitação for cobrada e conferir o preço atual antes de fechar um orçamento.
## Configure um projeto e uma chave
O [guia de configuração](https://docs.dev.runwayml.com/guides/setup/) da Runway recomenda criar uma conta e um projeto no portal para desenvolvedores e, em seguida, criar uma chave de API do projeto em API Keys. É necessário ter a função Admin ou Developer para criar ou desativar uma chave. A chave aparece em texto simples uma única vez, então guarde-a em segurança. Para usar o SDK, a Runway recomenda definir `RUNWAYML_API_SECRET`; o SDK lê essa variável automaticamente. Não coloque o segredo no código-fonte.
O projeto também precisa de créditos antes de usar a API. A Runway informa que o pagamento inicial mínimo é de **$10**, à tarifa de **$0.01 por crédito**, na aba de cobrança do projeto. É necessária a função Admin ou Billing admin para adicionar créditos. Essa é a compra mínima de créditos, não a cobrança por uma solicitação de fala. A página de configuração não descreve uma primeira chamada gratuita.
## Envie uma solicitação de conversão de texto em fala
O tipo atual de solicitação no [SDK Python da Runway](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) exige `model`, `prompt_text` e um objeto `voice` para o Eleven v4. No JSON enviado, os campos correspondentes são `model`, `promptText` e `voice`, com `voice.type` definido como `runway-preset` e um objeto `presetId`. `Bernard` é uma das vozes predefinidas listadas. O [serviço do SDK](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) envia essa solicitação para `/v1/text_to_speech` e retorna uma resposta de nova tarefa. O [guia da API](https://docs.dev.runwayml.com/guides/using-the-api/) da Runway documenta o host, a chave bearer e o cabeçalho `X-Runway-Version: 2024-11-06` usados em chamadas HTTP diretas.
Este é um corpo de solicitação derivado da documentação, não uma chamada que executamos:
```json
{
"model": "eleven_v4",
"promptText": "The recording begins now. [pause] Welcome.",
"voice": {
"type": "runway-preset",
"presetId": "Bernard"
}
}
```
A [entrada do changelog de 30 de setembro da Runway](https://docs.dev.runwayml.com/api-details/api_changelog/) cita `[laughs]`, `[whispers]` e `[pause]` como exemplos compatíveis e informa que o Eleven v4 usa as mesmas vozes predefinidas da Runway que o Eleven v3. As tags fazem parte do roteiro; reserve espaço para elas dentro do máximo declarado de 2.500 caracteres. O SDK também lista configurações opcionais de voz, idioma e campos de texto adjacentes. O esquema não comprova que alguma configuração garanta uma determinada interpretação, e este artigo não faz afirmações sobre qualidade da voz ou latência.
A resposta inicial é uma tarefa, não dados de áudio. O [guia de saída](https://docs.dev.runwayml.com/assets/outputs/) da Runway recomenda consultar `GET /v1/tasks/:id`; uma tarefa concluída com sucesso contém uma matriz de `output` com URLs de resultados. Essas URLs expiram entre 24 e 48 horas após o acesso à API, então baixe o resultado para seu próprio armazenamento em vez de usar a URL temporária em um produto. O exemplo geral de saída é uma tarefa de vídeo; ele estabelece o formato da resposta da tarefa, enquanto a [lista de modelos](https://docs.dev.runwayml.com/guides/models/) identifica a saída do Eleven v4 como áudio. Não observamos uma resposta do Eleven v4 nem verificamos o formato do arquivo de áudio.
## Calcule o preço com base na data
A [página de preços](https://docs.dev.runwayml.com/guides/pricing/) e a nota de lançamento da Runway listam **2,2 créditos por 1.000 caracteres até 12 de outubro de 2026, no horário do Pacífico**, depois **5 créditos por 1.000 caracteres**, com um mínimo de **um crédito**. Ao preço publicado de $0.01 por crédito, essas tarifas equivalem a **$0.022** e **$0.05 por 1.000 caracteres**, antes de qualquer imposto aplicável. A tarifa posterior listada é cerca de 2,27 vezes a anterior.
Um exemplo transparente para planejamento: dez roteiros separados, cada um com exatamente 1.000 caracteres faturáveis, totalizariam 10.000 caracteres. Multiplicar pelas tarifas publicadas resulta em **22 créditos, ou $0.22**, na tarifa anterior e **50 créditos, ou $0.50**, na tarifa posterior. Cada roteiro fica abaixo do limite de 2.500 caracteres, e cada solicitação calculada supera o mínimo de um crédito. Isto é uma conta baseada nas tarifas listadas pela Runway, não uma fatura observada. As páginas citadas não especificam como as tags contam como caracteres faturáveis nem se cobranças fracionárias por solicitação são arredondadas; por isso, uma estimativa de produção deve conferir os registros reais de uso e os termos atuais.
## Fontes e leituras adicionais
O [changelog da API de 30 de setembro](https://docs.dev.runwayml.com/api-details/api_changelog/) da Runway confirma a data de lançamento, o ID do modelo, os exemplos de tags, o limite do roteiro e a declaração de preços com data. O [guia de configuração](https://docs.dev.runwayml.com/guides/setup/) explica os pré-requisitos de projeto, chave e créditos, incluindo as permissões das funções e o pagamento inicial de $10. A [página de preços](https://docs.dev.runwayml.com/guides/pricing/) fornece a conversão de créditos para dólares e as tarifas listadas do Eleven v4.
A documentação do [esquema de solicitação do SDK Python](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) e da [implementação do serviço](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) confirma os nomes dos campos, o formato da voz predefinida, o caminho do endpoint e a resposta de criação de tarefa consultados para este guia. O [guia de primeiros passos](https://docs.dev.runwayml.com/guides/using-the-api/), a [lista de modelos](https://docs.dev.runwayml.com/guides/models/) e o [guia de saída](https://docs.dev.runwayml.com/assets/outputs/) da Runway fornecem o cabeçalho de versão HTTP, a classificação da saída de áudio e o comportamento de recuperação da tarefa. São documentos do fornecedor, não um teste de desempenho independente. Consultados em 6 de outubro de 2026.
## Sources
- [Runway Dev API changelog: Eleven v4](https://docs.dev.runwayml.com/api-details/api_changelog/) — A entrada da Runway de 30 de setembro anuncia eleven_v4, o limite de roteiro de 2.500 caracteres, três exemplos de tags de áudio, vozes predefinidas da Runway e a mudança em 12 de outubro, no horário do Pacífico, de 2,2 para 5 créditos por 1.000 caracteres, com mínimo de um crédito. Ela não comprova a qualidade do áudio nem uma chamada bem-sucedida da BIG CHANGE.
- [Configuração da Runway Dev API](https://docs.dev.runwayml.com/guides/setup/) — Documenta os pré-requisitos de conta, projeto, chave de API e função; a variável de ambiente secreta do SDK; e a compra inicial mínima de $10 em créditos, a $0.01 por crédito. São instruções do fornecedor, não etapas testadas neste artigo.
- [Preços da Runway Dev API](https://docs.dev.runwayml.com/guides/pricing/) — Lista as duas tarifas de créditos do Eleven v4 com datas e o preço de $0.01 por crédito. O exemplo de $0.22 e $0.50 do artigo é o cálculo de dez solicitações de 1.000 caracteres, não uma conta observada; pode haver imposto sobre vendas.
- [SDK Python da Runway: esquema de solicitação de conversão de texto em fala](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) — A versão atual da ramificação principal do SDK oficial define ElevenV4 como modelo obrigatório, promptText como alias e uma voz predefinida da Runway com presetId; Bernard está listado. A ramificação principal pode mudar e a solicitação não foi executada.
- [SDK Python da Runway: serviço de conversão de texto em fala](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) — O serviço atual do SDK oficial envia solicitações para /v1/text_to_speech e retorna uma resposta de nova tarefa. Isso não demonstra uma resposta observada do Eleven v4.
- [Runway Dev: usando a API](https://docs.dev.runwayml.com/guides/using-the-api/) — Documenta o host da API, a chave bearer, o cabeçalho X-Runway-Version 2024-11-06 e o padrão de ID de tarefa nos exemplos de geração. Os exemplos consultados não são chamadas do Eleven v4.
- [Runway Dev: formatos de saída](https://docs.dev.runwayml.com/assets/outputs/) — Descreve GET /v1/tasks/:id, matrizes de URLs de saída para tarefas concluídas e a expiração da URL em 24–48 horas. O exemplo exibido é uma tarefa de vídeo, portanto não se infere um formato de áudio do Eleven v4.
- [Runway Dev: modelos disponíveis](https://docs.dev.runwayml.com/guides/models/) — Lista eleven_v4 com entrada de texto e saída de áudio. Trata-se de uma classificação do modelo, não de uma inspeção independente do áudio.
Newsletter da BIG CHANGE
A visão ampla, no seu ritmo.
Matérias recentes sobre IA e robótica, mudanças que merecem atenção e ideias práticas para usar. Escolha um briefing diário, um resumo semanal ou uma perspectiva mensal.
Próximo envio programado (UTC): . Sua primeira edição chegará no próximo envio programado após a confirmação.
Sua privacidade, sua escolha.
O armazenamento necessário ajuda a proteger o site e a lembrar suas escolhas. O Google Analytics opcional permanece desativado até você autorizá-lo. Você pode ler todas as matérias usando apenas o armazenamento necessário. Detalhes de privacidade