О модели daVinci-MagiHuman
daVinci-MagiHuman — открытая модель от Sand.ai и SII-GAIR, которая создаёт картинку и голос одновременно: заключите произносимую реплику в кавычки, и человек в кадре её произнесёт. Модель делает клипы 5–10 секунд из промпта или стартового фото, в 256p, 720p или 1080p, в 16:9 или 9:16.
Вызывайте его по имени модели sand-ai/davinci-magihuman/text-to-video через POST /jobs/createTask, от 0,12 $.
Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. 16:9 · 9:16 · По умолчанию: 16:9 |
duration_seconds | Нет | Длина ролика. Оплата посекундная. ≥ 5 · ≤ 10 · По умолчанию: 5 |
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 256p | 0,024 $ |
| resolution 720p | 0,048 $ |
| resolution 1080p | 0,072 $ |
До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.
Быстрый старт API
Вызов API daVinci-MagiHuman в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
- Отправьте запрос. Отправьте POST /jobs/createTask с model sand-ai/davinci-magihuman/text-to-video и объектом 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": "sand-ai/davinci-magihuman/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
Какое имя модели у daVinci-MagiHuman в API?
Укажите sand-ai/davinci-magihuman/text-to-video — Создать видео; sand-ai/davinci-magihuman/image-to-video — Видео из картинки в поле model запроса POST /jobs/createTask.
Что такое daVinci-MagiHuman?
Модель на 15 млрд параметров от Sand.ai совместно с SII-GAIR, выпущенная с открытыми весами по лицензии Apache 2.0; статья опубликована 23.03.2026. Она создаёт видео и аудио за один проход, поэтому один запрос возвращает и картинку, и звуковую дорожку. Модель рассчитана на людей, которые говорят или поют в кадре, а также справляется с общими сценами.
На каких языках может говорить человек?
Издатель перечисляет китайский (путунхуа и кантонский), английский, японский, корейский, немецкий и французский. Мы тестировали английский, поэтому проверьте первый запуск на любом другом языке.
Как заставить человека что-то сказать?
Поставьте реплику в кавычки в промпте. Модель произносит реплики в кавычках сама. В наших трёх запусках с репликой в кавычках расшифровка звуковой дорожки совпала с промптом слово в слово.
Насколько длинными и большими бывают клипы?
От 5 до 10 секунд (по умолчанию 5), в 256p, 720p (по умолчанию) или 1080p, в 16:9 или 9:16. Модель рендерит в низком базовом разрешении, а собственный этап сверхразрешения даёт старшие уровни. В наших запусках 720p в 16:9 пришло около 1358 x 678, 720p в 9:16 — около 726 x 1270, а 1080p в 16:9 — около 1904 x 1088, все при 25 fps.
Даст ли тот же seed тот же клип?
Фиксированный seed при тех же входных данных даёт похожие, но не гарантированно идентичные результаты. Используйте его, чтобы сравнивать запуски, меняя по одной вещи за раз.
Какие ограничения у API daVinci-MagiHuman?
Длина клипа: 5–10 s; Разрешения: 256p · 720p · 1080p; Соотношения сторон: 16:9 · 9:16; Длина промпта (символов): 5,000. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать daVinci-MagiHuman без кода?
Запускайте daVinci-MagiHuman в Playground с баланса API в USD без API-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.