A Runway adicionou o Eleven v4 à sua API para desenvolvedores em 30 de setembro. A nota de lançamento 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 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 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 envia essa solicitação para /v1/text_to_speech e retorna uma resposta de nova tarefa. O guia da 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:
{
"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 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 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 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 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 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 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 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 e da implementação do serviço 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, a lista de modelos e o guia de saída 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.
