Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
duration_seconds | Não | Quanto tempo dura o clipe. Cobrado por segundo. ≥ 1 · ≤ 30 · Padrão: 8 |
guidance_scale | Não | O quão à risca o modelo segue o prompt. ≥ 0 · ≤ 20 · Padrão: 4.5 |
ignore_visual_semantics | Não | Choose the sounds from the prompt alone instead of from what the picture shows; timing still follows the motion. Padrão: false |
negative_prompt | Não | Estilos ou sons que você não quer na faixa. |
prompt | Não | The sounds you want, as a short list. If omitted, a general request for sounds that match the on-screen action is used. |
steps | Não | Mais etapas trazem mais detalhe, mas demoram mais. ≥ 4 · ≤ 50 · Padrão: 25 |
video_url | Sim | O clipe a ser trabalhado. |
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 por segundo | ≈ USD |
|---|---|---|
| Padrão | 0,18 | US$ 0,0018 |
Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 1 crédito por um clipe de 5 segundos (US$ 0,01).
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 Video Sound Effects 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 popnow/foley-v1/video-to-audio 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": "popnow/foley-v1/video-to-audio",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"duration_seconds": 8
}
}'
# 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 Video Sound Effects
Quanto custa a API do Video Sound Effects?
O Video Sound Effects custa 1 crédito (US$ 0,01) por um clipe de 5 segundos. 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 Video Sound Effects na API?
Coloque popnow/foley-v1/video-to-audio para Vídeo para áudio no campo model de POST /jobs/createTask.
Preciso descrever o som?
Não. Sem descrição, é enviada uma solicitação geral de sons que combinem com a ação na tela. Algumas palavras específicas costumam dar um resultado melhor.
O que acontece com o som que já está no clipe?
O vídeo entregue traz a faixa gerada como áudio, então comece de um clipe mudo ou de um cujo som você quer substituir.
Quais são os limites da API do Video Sound Effects?
Duração do clipe: 1–30 s; Tamanho do prompt (caracteres): 1,000; Maior upload: 90 MB. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o Video Sound Effects sem escrever código?
Dá. O Playground roda o Video Sound Effects com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.