ElevenLabs: Eleven v4
Eleven v4 transforma guiões em fala expressiva com elocução contextual, instruções de áudio no texto e eventos sonoros. A ElevenLabs concebe-o para narração de produção, diálogo de personagens e áudio multilingue, com um limite de 10 000 caracteres por geração.
Sobre o modelo
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
Eleven v4 é o modelo de conversão de texto em fala expressiva da ElevenLabs para conteúdo de produção, narração e interpretação de personagens. A sua nova arquitetura usa o contexto do guião para moldar quem fala, o que aconteceu e como deve soar a fala seguinte. A entrada é um guião escrito associado a uma voz selecionada; a saída é áudio. O fabricante destaca o diálogo emocional, a produção de audiolivros, a animação e os jogos, e os projetos multilingues como aplicações características.
As instruções podem ser escritas no guião através de etiquetas de áudio inseridas no texto. Etiquetas como [laughs], [whispers] e [door slams] podem descrever a elocução vocal, um evento não verbal ou um som dentro da cena. A atualização documentada do v4 melhora o cumprimento de uma sequência dessas instruções em comparação com o v3. Para um momento dramático curto, escreva as palavras efetivas que serão pronunciadas e coloque uma indicação de elocução no ponto relevante, em vez de acrescentar no fim uma lista de emoções sem relação.
As pausas e a ênfase usam instruções de áudio em linguagem natural. A ElevenLabs documenta [pause] e [long pause] para pausas e indicações como [excited] ou [sighs] para a elocução. As etiquetas SSML <break> estão desativadas no v4, pelo que um guião anterior que as use precisa de ser adaptado ao formato de instruções do v4. Uma etiqueta identifica a interpretação pretendida; por si só, não define um número exato de milissegundos nem garante uma duração final fixa.
O fluxo de diálogo do produtor suporta vários locutores, permitindo que uma cena contenha vozes separadas e eventos sonoros. O seu perfil WebSocket de diálogo v4 suporta até dez vozes registadas, enquanto o perfil do v4 Turbo usa uma. Prepare uma ordem clara dos turnos dos locutores e mantenha cada fala associada à voz pretendida. Uma troca ilustrativa pode passar de uma pergunta hesitante em voz baixa para uma resposta confiante e depois uma reação de alívio. O conteúdo e a transição emocional devem ser compreensíveis a partir do próprio guião. Para um único narrador, use a mesma clareza para distinguir a narração de uma citação ou de uma mudança de estado de espírito.
Eleven v4 suporta mais de 90 idiomas, incluindo inglês, francês, alemão, japonês, espanhol, português e russo. O fabricante descreve uma qualidade de voz consistente nas mudanças de idioma. Escolha uma voz e uma pronúncia adequadas ao idioma e à região da gravação pretendida; tanto o idioma do guião como as características da voz são importantes. Para uma lição localizada, traduza primeiro as palavras faladas e preserve o significado, a terminologia e as indicações de elocução no novo guião.
Uma geração suporta até 10 000 caracteres. Um trabalho mais longo é preparado em várias gerações ligadas, com união de contextos destinada a manter o ritmo e a elocução consistentes entre segmentos. Divida um capítulo num limite natural de frase ou cena e conserve o contexto envolvente. O fabricante descreve também uma identidade de locutor estável quando uma fala é gerada novamente. Isto é útil para rever um trecho mantendo o mesmo elenco e estilo de interpretação no material circundante.
O v4 suporta Instant e Professional Voice Clones no fluxo do produtor ElevenLabs. A ElevenLabs destaca o seu regresso no v4; o seu guia de prompts do v3 indica que os Professional Voice Clones não estão totalmente otimizados para o v3. Os Instant ou Professional Voice Clones criados antes do lançamento do v4 precisam de ser treinados novamente para v4, para funcionarem eficazmente com o modelo. A clonagem de voz cria ou prepara a voz usada na síntese; é distinta do ato de converter o guião fornecido em fala. A identidade do modelo não exige uma única voz predefinida, pelo que deve selecionar a voz para o narrador ou a personagem, em vez de presumir que o nome do modelo determina um locutor.
O fabricante documenta MP3 para audição geral e distribuição de conteúdos multimédia, WAV ou PCM para áudio de produção não comprimido e μ-law para telefonia. A sua API controla a frequência de amostragem e a taxa de bits do formato selecionado. Os dicionários de pronúncia podem definir como são pronunciados nomes, siglas e termos técnicos. O v4 também reconhece transcrições IPA padrão delimitadas por barras, como /IPA_transcription/, incluindo marcadores de acento para termos com várias sílabas; a pronúncia pode ainda variar consoante a voz e a frase. Prepare os termos necessários antes da produção e mantenha as formas faladas preferidas consistentes entre revisões. O perfil do produtor v4 usa as definições de voz Stability e Similarity; os controlos deslizantes Style e Speed não estão disponíveis. O ritmo e a elocução emocional são orientados pelo guião e pelas etiquetas de áudio.
Para instruções práticas de narração, forneça uma cena terminada, a voz pretendida, o idioma, o arco emocional e o destino do áudio. Por exemplo: «Leia a abertura com calma, faça uma pausa antes da descoberta e dê à fala final um tom de alívio; mantenha o tom do narrador consistente.» Reveja a pronúncia, as mudanças de locutor, as etiquetas ou os eventos audíveis e as transições entre trechos. A entrega útil é uma gravação de fala produzida e ligada ao guião, com uma tomada selecionada e as instruções necessárias para rever uma fala específica.
Ailoot Ultra · Síntese de voz POST /v1/audio/speech elevenlabs/eleven-v4
elevenlabs/eleven-v4Introdução
Eleven v4 transforma guiões em fala expressiva com elocução contextual, instruções de áudio no texto e eventos sonoros. A ElevenLabs concebe-o para narração de produção, diálogo de personagens e áudio multilingue, com um limite de 10 000 caracteres por geração.
- Entradas aceites
- Texto
- Resultados
- Áudio
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · Síntese de voz POST /v1/audio/speech
- Entrada
text- Saída
audio- Formato de saída
- mp3
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites elevenlabs/eleven-v4 | Predefinição— |
Campoinput | Tipostring | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 Comprimento máximo: 10 000 Unidade: carateres Unicode | Predefinição— |
Campovoice | Tipostring | RequisitoObrigatório | Valores e limites george, sarah, adam, alice, bella, bill, brian, callum, charlie, chris, daniel, eric, harry, jessica, laura, liam, lily, matilda, river, roger, will | Predefinição— |
Camporesponse_format | Tipostring | RequisitoObrigatório | Valores e limites mp3 | Predefinição— |
Combinações de materiais de entrada
text_to_speech · Obrigatório: input
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, input, voice, response_format |
Parâmetrovoice_ids | Contratogeorge, sarah, adam, alice, bella, bill, brian, callum, charlie, chris, daniel, eric, harry, jessica, laura, liam, lily, matilda, river, roger, will |
Parâmetroresponse_format | Contratomp3 |
Parâmetromax_input_characters | Contrato10000 |
Parâmetroother_options | Contratofalse |
Parâmetroinput | Contratotexto UTF-8 exato; contagem de carateres Unicode sem normalização |
Parâmetromaterial_types | Contratotext |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id efetivamente devolvido ou registo na biblioteca de multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Selecione a voz exata deste perfil de modelo.
Os carateres de entrada e os segundos de áudio são medidas de utilização diferentes.
Tarifários
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
- Modo rápido
- Não especificado Quando o modo rápido está selecionado
- Modo flex
- Não especificado Quando o modo flex está selecionado
- Esforço máximo de raciocínio
- Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Tarifas Ailoot
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Tabela de tarifas | Unidade de faturação | Custo |
|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Unidade de faturação— | Custo Entrada · Tokens de entrada — / 1K tokens Saída · Tokens de saída — / 1K tokens Entrada · Leitura da cache — / 1K tokens Entrada · Escrita na cache — / 1K tokens Entrada · Escrita na cache, 1 hora — / 1K tokens |
| Configuraçãocarácter de entrada | Tabela de tarifas— | Unidade de faturaçãopor carácter de entrada | Custo Entrada · carácter de entrada $0.00016 por carácter de entrada |
Detalhes da tarifa de referência
As tabelas de referência do modelo não alteram a seleção do método, as cotações ou os custos. Os custos ativos usam as tarifas do método Ailoot selecionado.
ElevenLabs: Eleven v4
Preços por configuração
| Configuração | Condições de faturação | Custo |
|---|---|---|
| ConfiguraçãoElevenLabs: Eleven v4 · Configuração predefinida | Condições de faturaçãoConfiguração predefinida | Custo Entrada · Caracteres de entrada 0,00008 US$ por carácter de entrada |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
Exemplos de pedidos
Ailoot Ultra · Síntese de voz
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VOICE_ID:?Choose an accepted voice ID from this exact model profile}"
export AILOOT_VOICE_ID
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "elevenlabs/eleven-v4", "input": "Good afternoon! This is a short voice take."}')
voice=os.environ["AILOOT_VOICE_ID"]
allowed=json.loads('["george", "sarah", "adam", "alice", "bella", "bill", "brian", "callum", "charlie", "chris", "daniel", "eric", "harry", "jessica", "laura", "liam", "lily", "matilda", "river", "roger", "will"]')
if voice not in allowed: raise SystemExit("Choose an accepted voice ID from this exact model profile")
p["voice"]=voice
p["response_format"]="mp3"
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o speech.mp3
Receber e guardar os resultados
Ailoot Ultra · Síntese de voz
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Outras leituras de conteúdo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_MEDIA_TASK_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-task.json").read_text())))
PY_RESULT
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_ASSET_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-asset.json").read_text())))
PY_RESULT
Guardar todos os resultados concluídos
Guarde cada resposta, ficheiro e parte de conteúdo devolvidos na íntegra.
Guarde o resultado binário completo e os cabeçalhos. Se forem devolvidos JSON/vários resultados, conserve todos os itens de dados e obtenha cada recurso através do seu URL assinado efetivo.
Se for necessário verificar a resposta original
Conserve o operation_id/X-Client-Request-ID original para reconciliação sem voltar a enviar o pedido; não existe uma rota dedicada à consulta periódica do estado do áudio.
Campos da resposta
| Campo | Tipo |
|---|---|
Campobinary audio | Tipobytes |
Camporesponse headers | Tipoheaders |
Erros e passos seguintes
| Resposta | Condição | Passo seguinte |
|---|---|---|
Resposta400 · invalid_request_error | CondiçãoCampos obrigatórios, representação do material ou valor do parâmetro inválidos | Passo seguinteCorrija os campos indicados antes de um novo pedido de criação. |
Respostaserver_error | CondiçãoA resposta devolvida indica que a operação ou o resultado requer verificação | Passo seguinteGuarde o ID original da operação/tarefa devolvido, os cabeçalhos do pedido e a resposta; continue a consultar essa operação original através das consultas suportadas. Não volte a enviar o pedido de criação. |
Aliases
Aliases do modelo
Ailoot Ultra elevenlabs/eleven-v4
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · ElevenLabs: Eleven v4
- Que entradas e resultados estão disponíveis?
POST /v1/audio/speech·elevenlabs/eleven-v4:text→audio- Que campos utiliza o pedido?
POST /v1/audio/speech·elevenlabs/eleven-v4:model,input,voice,response_format- Que limites se aplicam?
POST /v1/audio/speech·elevenlabs/eleven-v4:input.maximum_length:10000