Referência da API do Seed Audio 1.0

Com uma única chave de API da PopNow você chama o Seed Audio 1.0 direto do seu código. Aqui estão os IDs de modelo a enviar, cada campo de entrada aceito, quantos créditos custa cada requisição e um exemplo que você cola no terminal e roda.

As descrições dos parâmetros vêm do schema de entrada do modelo e estão disponíveis só em inglês.

Resumo

Desenvolvedor: ByteDance
Resultado: Áudio
A partir de: 54 créditos por requisição ($0.54)
Tempo médio: cerca de 36 s
IDs de modelo: bytedance/seed-audio-1.0/text-to-audio

1 crédito = US$ 0,01. Ao ser aceita, a tarefa reserva o valor máximo possível e, no fim, cobra o uso real, arredondado para cima em créditos inteiros; o restante é liberado. Tarefas que falham não são cobradas. Para saber o valor exato antes de rodar, chame POST /api/v1/jobs/quote.

Efeitos sonoros

bytedance/seed-audio-1.0/text-to-audio

Preço

Opção	Créditos (por requisição)	Dólares
`Padrão`	54	$0.54

Parâmetros

Campo	Tipo	Padrão	Valores aceitos	Para que serve
`prompt`Obrigatório	`string`	—	até 2.000 caracteres	Describe the whole audio scene: who speaks, how, what they say (in quotes), and any music, ambience or sound effects.
`reference_audio_urls`Opcional	`array<string (uri)>`	—	até 3 itens	Up to three reference clips, called @Audio1 to @Audio3 in the prompt. Not with image_url.
`image_url`Opcional	`string (uri)`	—	—	Optional reference image to build the audio around. Not with reference_audio_urls.
`speed`Opcional	`number`	`1`	de 0.5 a 2	Speech rate multiplier; 1 is normal.
`pitch`Opcional	`integer`	`0`	de -12 a 12	Pitch shift in semitones; 0 keeps the original pitch.
`volume`Opcional	`number`	`1`	de 0.5 a 2	Loudness multiplier; 1 is the normal level.
`output_format`Opcional	`string`	`mp3`	mp3, wav, opus, pcm	File format of the result; pcm is headerless 16-bit little-endian stereo samples.
`sample_rate`Opcional	`integer`	—	8000, 16000, 24000, 32000, 44100, 48000	Sample rate in Hz. The model uses 24000 when omitted.

Exemplo de requisição

Esta requisição roda do jeito que está; os campos que você omitir usam o valor padrão. Antes, coloque sua chave em POPNOW_API_KEY.

POST /api/v1/jobs/createTask?wait=60

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "bytedance/seed-audio-1.0/text-to-audio",
  "input": {
    "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, hand claps and a catchy whistled hook"
  }
}'

A resposta já traz um taskId. Busque o resultado com GET /api/v1/jobs/recordInfo ou inclua callBackUrl para ser avisado.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"