Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
text | Sim | The words to be spoken, exactly as written. Billed per 1,000 characters. |
pitch | Não | Pitch shift in semitones; 0 keeps the voice's own pitch. ≥ -12 · ≤ 12 · Padrão: 0 |
speed | Não | Ritmo da fala. ≥ 0.5 · ≤ 2 · Padrão: 1 |
volume | Não | Loudness multiplier; 1 is the normal level. ≥ 0.5 · ≤ 2 · Padrão: 1 |
language | Não | O idioma da fala. zh · en · ja · es-mx · id · pt-br · ko · it · de · fr |
voice_id | Não | Escolha entre as vozes disponíveis. vivi_mixed_en_zh_ja_es_id · mindy_en_es_id_pt_zh · stokie_en · dacey_en · tim_en · kian_en_zh · cedric_en_zh · sophie_en_zh · jean_en_zh · magnus_en_zh · mabel_en_zh · nadia_en_zh · opal_en_zh · pearl_en_zh · quentin_en_zh · vienna_mixed_en_zh · alina_mixed_en_zh · corinne_mixed_en_zh · esther_mixed_en_zh · freya_mixed_en_zh · gigi_mixed_en_zh · holly_mixed_en_zh · lyla_mixed_en_zh · daisy_mixed_en_zh · tracy_es_zh · jess_ja_es_id_pt_en_zh · pinky_es_ko_mixed_en_zh · sweety_ja_es · sandy_es_mixed_en_zh · sven_de · minimi_ja · usseau_fr · felipe_es · han_id · martins_pt · enzo_it · shane_ko · bonnie_zh · felix_zh · celeste_zh · monkey_king_zh · Padrão: stokie_en |
sample_rate | Não | Sample rate in Hz. The model uses 24000 when omitted. 8000–48000 |
instructions | Não | How to read the text: tone, emotion, pace or volume. Not spoken and not billed. |
output_format | Não | Tipo de arquivo do resultado. mp3 · opus · Padrão: mp3 |
Preços
Os preços são em créditos, os mesmos que você usa no site (1 crédito = US$ 0,01). O valor é reservado quando a tarefa é aceita e acertado pelo custo real quando ela termina; tarefas com falha são reembolsadas.
| Opção | Créditos a cada 1.000 caracteres | ≈ USD |
|---|---|---|
| Padrão | 10,8 | US$ 0,11 |
Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 11 créditos a cada 1.000 caracteres (US$ 0,11).
Para saber o valor exato antes de rodar, envie o mesmo corpo para POST /jobs/quote.
Início rápido da API
Chame a API do Seed Speech 2.0 em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow- e usam os mesmos créditos do site.
- Envie a requisição. Faça POST /jobs/createTask com model bytedance/seed-speech-2.0/text-to-speech e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seed-speech-2.0/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "stokie_en",
"output_format": "mp3"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do Seed Speech 2.0
Quanto custa a API do Seed Speech 2.0?
O Seed Speech 2.0 custa 11 créditos (US$ 0,11) a cada 1.000 caracteres. Os créditos são os mesmos do site (1 crédito = US$ 0,01), contas novas ganham 30 créditos grátis e tarefas que falham são reembolsadas.
Qual é o nome de modelo do Seed Speech 2.0 na API?
Coloque bytedance/seed-speech-2.0/text-to-speech para Texto para fala no campo model de POST /jobs/createTask.
Como eu controlo a interpretação?
Escolha uma das 41 vozes prontas com voice_id e descreva a interpretação em instructions — tom, emoção, ritmo ou volume, em uma ou duas frases. As instruções moldam a leitura e não são faladas em voz alta.
Quais idiomas ele lê?
Ele detecta o idioma do roteiro automaticamente. Você também pode forçar chinês, inglês, japonês, espanhol mexicano, indonésio, português do Brasil, coreano, italiano, alemão ou francês com language. Várias vozes são feitas para mais de um idioma.
Ele consegue copiar a voz de uma pessoa real?
Não. Nesse endpoint só estão disponíveis as 41 vozes prontas; não há clonagem nem upload de uma voz de referência.
Quais são os limites da API do Seed Speech 2.0?
Tamanho do texto (caracteres): 5,000; Vozes: 41; Idiomas: 10. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o Seed Speech 2.0 sem escrever código?
Dá. O Playground roda o Seed Speech 2.0 com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.

