Criar podcast
Crie e converta automaticamente um projeto de podcast. Atualmente, nós cobrimos o custo da LLM, mas você ainda paga pela geração de áudio. No futuro, serão cobrados os custos da LLM e da geração de áudio.
Cabeçalhos
xi-api-key
safety-identifier
Usado para moderação. Seu espaço de trabalho precisa estar na lista de permissões para usar este recurso.
Solicitação
This endpoint expects an object.
model_id
O ID do modelo a ser usado neste projeto do Estúdio. Você pode consultar GET /v1/models para listar todos os modelos disponíveis.
mode
O tipo de podcast a gerar. Pode ser 'conversation', uma interação entre duas vozes, ou 'bulletin', um monólogo.
source
O conteúdo de origem do podcast.
quality_preset
Output quality of the generated audio. Must be one of:
'standard' - standard output format, 128kbps with 44.1kHz sample rate.
'high' - high quality output format, 192kbps with 44.1kHz sample rate and major improvements on our side.
'ultra' - ultra quality output format, 192kbps with 44.1kHz sample rate and highest improvements on our side.
'ultra_lossless' - ultra quality output format, 705.6kbps with 44.1kHz sample rate and highest improvements on our side in a fully lossless format.
If not provided, defaults to the highest quality preset available on your subscription tier.
Valores permitidos:
duration_scale
Duração do podcast gerado. Deve ser uma destas opções:
short - produz podcasts com menos de 3 minutos.
default - produz podcasts de aproximadamente 3 a 7 minutos.
long - produz podcasts com mais de 7 minutos.
Valores permitidos:
language
Um idioma opcional do projeto do Estúdio. Código de idioma de duas letras (ISO 639-1).
intro
O texto de introdução que sempre será adicionado ao início do podcast.
outro
O texto de encerramento que sempre será adicionado ao fim do podcast.
instructions_prompt
Prompt de instruções adicionais para a geração do podcast, usado para ajustar o estilo e o tom do podcast.
highlights
Um breve resumo ou os destaques do conteúdo do projeto do Estúdio, com pontos ou temas principais. Deve ter entre 10 e 70 caracteres.
callback_url
Uma URL que será chamada pelo nosso serviço quando o projeto do Estúdio for convertido. A solicitação conterá um objeto JSON com o status da conversão.
Mensagens:
1. Quando o projeto for convertido com sucesso:
{
type: "project_conversion_status",
event_timestamp: 1234567890,
data: {
request_id: "1234567890",
project_id: "21m00Tcm4TlvDq8ikWAM",
conversion_status: "success",
project_snapshot_id: "22m00Tcm4TlvDq8ikMAT",
error_details: None,
}
}
2. Quando a conversão do projeto falhar:
{
type: "project_conversion_status",
event_timestamp: 1234567890,
data: {
request_id: "1234567890",
project_id: "21m00Tcm4TlvDq8ikWAM",
conversion_status: "error",
project_snapshot_id: None,
error_details: "Detalhes do erro se a conversão falhar"
}
}
3. Quando o capítulo for convertido com sucesso:
{
type: "chapter_conversion_status",
event_timestamp: 1234567890,
data: {
request_id: "1234567890",
project_id: "21m00Tcm4TlvDq8ikWAM",
chapter_id: "22m00Tcm4TlvDq8ikMAT",
conversion_status: "success",
chapter_snapshot_id: "23m00Tcm4TlvDq8ikMAV",
error_details: None,
}
}
4. Quando a conversão do capítulo falhar:
{
type: "chapter_conversion_status",
event_timestamp: 1234567890,
data: {
request_id: "1234567890",
project_id: "21m00Tcm4TlvDq8ikWAM",
chapter_id: "22m00Tcm4TlvDq8ikMAT",
conversion_status: "error",
chapter_snapshot_id: None,
error_details: "Detalhes do erro se a conversão falhar"
}
}
apply_text_normalization
Este parâmetro controla a normalização de texto com quatro modos: 'auto', 'on', 'apply_english' e 'off'.
Quando definido como 'auto', o sistema decidirá automaticamente se deve aplicar a normalização de texto
(por exemplo, escrever os números por extenso). Com 'on', a normalização de texto sempre será aplicada, enquanto
com 'off', ela será ignorada. 'apply_english' é igual a 'on', mas pressupõe que o texto está em inglês.
Valores permitidos:
Resposta
Resposta bem-sucedida
project
O projeto associado ao podcast criado.
Erros
422
Unprocessable Entity Error