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

A Runway adicionou o Eleven v4 à sua API para programadores em 30 de setembro. A nota de lançamento 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 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 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 esse pedido para /v1/text_to_speech e devolve 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 pedido 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 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 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 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 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 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 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 pedido 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.