PopNowAPI 文档
正文

Seed Audio 1.0 API 调用参考

多人声的音频场景,配乐和音效一起出

用一个 PopNow API 密钥,就能在自己的代码里调用 Seed Audio 1.0。下面列出要填的调用名、这个型号接受的每个输入字段、每次请求花多少积分,以及一段可以直接粘进终端运行的请求。

参数说明直接取自型号的输入 schema,暂时只有英文。

一览

出品方
ByteDance
产出
音频
起价
54 积分 每次请求 ($0.54)
一般耗时
约 36 秒

1 积分 = 0.01 美元。任务受理时先冻结可能的最高费用,完成后按实际用量结算、向上取整到整积分,多冻的退回;失败的任务不扣积分。想在运行前知道确切数字,先调 POST /api/v1/jobs/quote。

音效

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

价格

选项积分 (每次请求)美元
默认54$0.54

参数

字段类型默认值取值范围作用
prompt必填string—最多 2000 个字符Describe the whole audio scene: who speaks, how, what they say (in quotes), and any music, ambience or sound effects.
reference_audio_urls可选array<string (uri)>—最多 3 项Up to three reference clips, called @Audio1 to @Audio3 in the prompt. Not with image_url.
image_url可选string (uri)——Optional reference image to build the audio around. Not with reference_audio_urls.
speed可选number10.5 到 2Speech rate multiplier; 1 is normal.
pitch可选integer0-12 到 12Pitch shift in semitones; 0 keeps the original pitch.
volume可选number10.5 到 2Loudness multiplier; 1 is the normal level.
output_format可选stringmp3mp3, wav, opus, pcmFile format of the result; pcm is headerless 16-bit little-endian stereo samples.
sample_rate可选integer—8000, 16000, 24000, 32000, 44100, 48000Sample rate in Hz. The model uses 24000 when omitted.

请求示例

这段请求原样就能运行,没写的字段都用默认值。运行前先把密钥放进环境变量 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"
  }
}'

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果,或者在请求里加上 callBackUrl 等通知。

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"

接下来

本页内容