Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
audio_url | Да | Голос или музыка, которые будут использованы. |
image_url | Да | Картинка, с которой всё начинается. |
mask_url | Нет | Закрасьте область, которую нужно изменить. |
prompt | Нет | Optional note on expression or mood, such as calm or cheerful. Identity and setting come from the portrait. |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за секунду | ≈ USD |
|---|---|---|
| Стандарт | 2,7 | 0,027 $ |
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Talking Avatar в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/talking-avatar-v1/talking-avatar и объектом 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": "popnow/talking-avatar-v1/talking-avatar",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.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 Talking Avatar
Сколько стоит API Talking Avatar?
Talking Avatar стоит 2,7 кредита (0,027 $) за секунду. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Talking Avatar в API?
Укажите popnow/talking-avatar-v1/talking-avatar — Говорящий аватар в поле model запроса POST /jobs/createTask.
Какой длины может быть видео?
Такой же, как аудио: от 3 до 60 секунд. Длинные сценарии разбейте на несколько записей и склейте ролики потом.
Нужен ли промпт?
Нет. Рот и голову ведёт звук. Короткий промпт может немного направить мимику, например спокойную или весёлую, но человек и сцена берутся из портрета.
А если на фото несколько человек?
Передайте mask_url: чёрно-белое изображение того же размера, что и портрет, белое на том, кто должен говорить. Без маски инструмент выберет лицо сам, и это может оказаться не тот человек.
Какие ограничения у API Talking Avatar?
Длина промпта (символов): 1,000; Максимальный размер загрузки: 90 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Talking Avatar без кода?
Да. Playground запускает Talking Avatar на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
