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

# API de voz Eleven v4 da Runway: formato do pedido e preços de outubro

> A API de voz Eleven v4 da Runway aceita guiões de até 2.500 caracteres. Este guia baseado na documentação explica o pedido, 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

![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.

A Runway adicionou o Eleven v4 à sua API para programadores 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 guião 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 programadores que adicionam geração de fala a um fluxo de produção, a pergunta prática é o que um pedido válido 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 guião pode incluir tags de áudio documentadas, como `[laughs]`, `[whispers]` e `[pause]`, respeitando o limite de 2.500 caracteres.
- **Por que isso importa:** Uma equipa com um projeto de programador da Runway pode solicitar fala usando uma voz predefinida e recuperar a URL do áudio da tarefa concluída. O planeamento da integração e do orçamento pode usar um formato de pedido 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 o pedido for cobrado e verificar 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 programadores 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**, no separador de faturação 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 um pedido de fala. A página de configuração não descreve uma primeira chamada gratuita.

## Envie um pedido de conversão de texto em fala

O tipo atual de pedido 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 esse pedido para `/v1/text_to_speech` e devolve 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 pedido 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 guião; 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 transfira 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 ficheiro 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 planeamento: dez guiões 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 guião fica abaixo do limite de 2.500 caracteres, e cada pedido calculado 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 pedido são arredondadas; por isso, uma estimativa de produção deve verificar os registos 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 guião 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 pedido 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 guião 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 pedidos de 1.000 caracteres, não uma conta observada; pode haver imposto sobre vendas.
- [SDK Python da Runway: esquema de pedido 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 o pedido não foi executado.
- [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 pedidos para /v1/text_to_speech e devolve 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.