Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
image_url | Нет | Картинка, с которой всё начинается. |
output_format | Нет | Формат файла результата. mp3 · wav · opus · pcm · По умолчанию: mp3 |
pitch | Нет | Pitch shift in semitones; 0 keeps the original pitch. ≥ -12 · ≤ 12 · По умолчанию: 0 |
prompt | Да | Describe the whole audio scene: who speaks, how, what they say (in quotes), and any music, ambience or sound effects. |
reference_audio_urls | Нет | Звук-образец: голос, музыка или ритм. |
sample_rate | Нет | Sample rate in Hz. The model uses 24000 when omitted. 8000 · 16000 · 24000 · 32000 · 44100 · 48000 |
speed | Нет | Темп речи. ≥ 0.5 · ≤ 2 · По умолчанию: 1 |
volume | Нет | Loudness multiplier; 1 is the normal level. ≥ 0.5 · ≤ 2 · По умолчанию: 1 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за генерацию | ≈ USD |
|---|---|---|
| Стандарт | 54 | 0,54 $ |
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Seed Audio 1.0 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model bytedance/seed-audio-1.0/text-to-audio и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 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-audio-1.0/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif",
"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"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Seed Audio 1.0
Сколько стоит API Seed Audio 1.0?
Seed Audio 1.0 стоит 54 кредита (0,54 $) за генерацию. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Seed Audio 1.0 в API?
Укажите bytedance/seed-audio-1.0/text-to-audio — Звуковые эффекты в поле model запроса POST /jobs/createTask.
Можно ли выбрать голос или клонировать его?
Списка голосов нет, но можно загрузить до трёх референсных фрагментов (reference_audio_urls) и сослаться на них в промпте как @Audio1, @Audio2 и @Audio3, например «Голосом из @Audio1 …», либо вместо этого дать референсное изображение (image_url). В остальном каждый голос определяется тем, как вы его описали в промпте. Используйте только голоса, на которые у вас есть права.
Может ли в одном клипе быть больше одного говорящего?
Да. Эта модель создана для диалогов с несколькими персонажами: опишите каждого говорящего и заключите его реплики в кавычки, и она даст каждому отдельный голос в одном клипе.
Можно ли управлять скоростью, высотой тона или громкостью?
Да. У speed (0,5–2), pitch (от -12 до 12 полутонов) и volume (0,5–2) есть собственные ползунки, а темп и тон по-прежнему можно описать в промпте, например медленный приглушённый голос или выкрикнутую реплику.
Какие ограничения у API Seed Audio 1.0?
Референсное аудио: 3; Длина промпта (символов): 2,000; Максимальный размер загрузки: 10 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Seed Audio 1.0 без кода?
Да. Playground запускает Seed Audio 1.0 на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.