ElevenLabs: Eleven v4 Turbo
Eleven v4 Turbo transforma texto em fala expressiva para conversas em direto, assistentes de voz e personagens interativas. Conserva a amplitude emocional e as instruções de áudio da família v4, usando um perfil de streaming assente numa voz registada por ligaçã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 Turbo é a edição de síntese de fala expressiva da ElevenLabs concebida para conversas em tempo real e respostas de agentes de voz. Recebe texto e devolve áudio falado, levando a amplitude emocional da família v4 para um fluxo interativo. O produtor distingue a sua finalidade da do v4 normal, ajustado para conteúdo de produção e narração. Respostas de apoio, explicações de assistentes e falas de personagens interativas são as aplicações indicadas para Turbo.
O fluxo de streaming bidirecional do produtor pode receber texto à medida que é gerado e devolver áudio antes de chegar a enunciação completa. Isto reduz a necessidade de esperar por um parágrafo terminado antes de começar a fala. É uma etapa de conversão de texto em áudio: as palavras da resposta são fornecidas ao modelo de síntese. Ouvir quem telefona, decidir que ação executar e detetar interrupções são funções separadas da aplicação de agente de voz envolvente.
O perfil documentado Text to Dialogue WebSocket regista exatamente uma voz para v4 Turbo. Isto difere do perfil do v4, que suporta até dez vozes registadas. Uma ligação pode transportar turnos sucessivos na voz selecionada, com um sinal de novo turno que repõe a prosódia no limite entre turnos. Prepare uma identidade de locutor clara para um assistente e mantenha-a consistente enquanto o conteúdo e o tom mudam ao longo da conversa.
O streaming continua a precisar de texto suficiente para formar um segmento de fala útil. O guia descreve um buffer do produtor de aproximadamente 40 caracteres e oito palavras antes de começar o áudio parcial; buffers mais curtos podem ser esvaziados deliberadamente sem terminar a ligação. O áudio chega em blocos codificados em Base64, que uma aplicação pode descodificar para reprodução ou reunir num ficheiro. Os blocos podem incluir informação de alinhamento quando esta é pedida e está disponível. Estes são detalhes do fluxo do produtor, e não uma garantia de latência fixa ou de duração exata para um enunciado individual.
As etiquetas de áudio e o contexto da conversa orientam a elocução. Uma confirmação pode soar satisfeita, uma explicação atenta e uma correção calma, mantendo a mesma voz. Coloque a instrução audível perto das palavras relevantes. Uma frase ilustrativa pode ser: «[warm] Esse passo está concluído. [pause] Vamos verificar o próximo item.» As palavras já devem comunicar o resultado correto; as etiquetas moldam a forma como o resultado é ouvido, em vez de fornecerem conteúdo factual em falta.
A família de modelos v4 suporta mais de 90 idiomas, com inglês, francês, alemão, japonês, espanhol, português e russo entre os exemplos documentados. A ElevenLabs descreve uma identidade de locutor estável entre turnos e idiomas e suporta Professional Voice Clones tanto no v4 como no v4 Turbo. A preparação ou clonagem de voz é uma etapa separada da síntese de uma resposta. Selecione explicitamente a voz e o idioma de destino e mantenha nomes, terminologia e formas faladas preferidas consistentes ao longo do diálogo.
As opções de formato documentadas da ElevenLabs incluem MP3 para audição geral, PCM não comprimido ou WAV para áudio de produção e μ-law para telefonia. O formato de saída selecionado determina a frequência de amostragem e a codificação usadas pelo fluxo do produtor. Para um assistente, escolha o formato de acordo com o destino de reprodução, em vez de pedir ao guião que especifique uma codificação. Reveja nomes e abreviaturas importantes com a voz escolhida e escreva claramente no texto as palavras que devem ser pronunciadas. O produtor descreve Stability e Similarity como as definições de voz de ambas as variantes v4; os controlos deslizantes Style e Speed não estão disponíveis neste perfil. Use o texto falado e as instruções de áudio para moldar a elocução.
As instruções práticas para uma conversa começam por uma resposta compacta que contém um resultado e um próximo passo claro. Por exemplo: «Confirme que o documento foi recebido e depois explique o único detalhe ainda necessário. Use uma elocução calma e simpática e preserve exatamente o nome do documento.» Divida uma resposta longa em limites com sentido e mantenha o contexto conversacional envolvente. Avalie a clareza, o início e o fim de cada turno e se a emoção se adequa à mensagem. A entrega é fala em streaming ou reunida numa gravação para o texto fornecido e a voz selecionada, distinta das etapas de raciocínio e escuta da aplicação.
Ailoot Ultra · Síntese de voz POST /v1/audio/speech elevenlabs/eleven-v4-turbo
elevenlabs/eleven-v4-turboIntrodução
Eleven v4 Turbo transforma texto em fala expressiva para conversas em direto, assistentes de voz e personagens interativas. Conserva a amplitude emocional e as instruções de áudio da família v4, usando um perfil de streaming assente numa voz registada por ligaçã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-turbo | 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.00008 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 Turbo
Preços por configuração
| Configuração | Condições de faturação | Custo |
|---|---|---|
| ConfiguraçãoElevenLabs: Eleven v4 Turbo · Configuração predefinida | Condições de faturaçãoConfiguração predefinida | Custo Entrada · Caracteres de entrada 0,00004 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-turbo", "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-turbo
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · ElevenLabs: Eleven v4 Turbo
- Que entradas e resultados estão disponíveis?
POST /v1/audio/speech·elevenlabs/eleven-v4-turbo:text→audio- Que campos utiliza o pedido?
POST /v1/audio/speech·elevenlabs/eleven-v4-turbo:model,input,voice,response_format- Que limites se aplicam?
POST /v1/audio/speech·elevenlabs/eleven-v4-turbo:input.maximum_length:10000