PopNowAPI
Получить API-ключ

daVinci-MagiHuman API

от Sand.ai

Заключите реплику в кавычки, и человек в кадре её произнесёт

sand-ai/davinci-magihuman/image-to-video
  • До 1080p
  • Ролики 5–10 с
  • Создать видео
  • Видео из картинки

О модели daVinci-MagiHuman

daVinci-MagiHuman — открытая модель от Sand.ai и SII-GAIR, которая создаёт картинку и голос одновременно: заключите произносимую реплику в кавычки, и человек в кадре её произнесёт. Модель делает клипы 5–10 секунд из промпта или стартового фото, в 256p, 720p или 1080p, в 16:9 или 9:16.

Вызывайте его по имени модели sand-ai/davinci-magihuman/image-to-video через POST /jobs/createTask, от 0,12 $.

Пока это руководство есть только на английском. →

Параметры запроса

ПараметрОбязательныйОписание
aspect_ratioНетФорма кадра: широкая, квадратная или вертикальная. 16:9 · 9:16 · По умолчанию: 16:9
duration_secondsНетДлина ролика. Оплата посекундная. ≥ 5 · ≤ 10 · По умолчанию: 5
image_urlДаКартинка, с которой всё начинается.
promptДаWhat happens, and in quotes what the person says. The model speaks quoted lines itself.
resolutionНетРазмер результата. Больше — чётче и дороже. 256p · 720p · 1080p · По умолчанию: 720p
seedНетОдно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647

Цены

Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.

ВариантUSD за секунду
resolution 256p0,024 $
resolution 720p0,048 $
resolution 1080p0,072 $

До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.

Быстрый старт API

Вызов API daVinci-MagiHuman в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model sand-ai/davinci-magihuman/image-to-video и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
  3. Получите результат. Опрашивайте 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": "sand-ai/davinci-magihuman/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 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 daVinci-MagiHuman

Сколько стоит API daVinci-MagiHuman?

daVinci-MagiHuman стоит от 0,12 $ за клип длиной 5 с — на самой дешёвой задаче «Видео из картинки». Цены по вариантам: 256p 0,024 $ за секунду, 720p 0,048 $ за секунду, 1080p 0,072 $ за секунду. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.

Какие ограничения у API daVinci-MagiHuman · Видео из картинки?

Длина клипа: 5–10 s; Разрешения: 256p · 720p · 1080p; Соотношения сторон: 16:9 · 9:16; Длина промпта (символов): 5,000. Запросы за пределами этих ограничений отклоняются до любого списания.

Ещё о daVinci-MagiHuman