О модели PixVerse V6 Effects
PixVerse V6 Effects превращает одно фото (для некоторых шаблонов — два) в короткий тематический клип из 50 готовых шаблонов эффектов: спортивные празднования, презентации товаров, танцы, поздравления и трансформации. Шаблон задаёт движение и длину, а вы выбираете 360p–1080p и наличие звука.
Вызывайте его по имени модели pixverse/v6-effects/image-to-video через POST /jobs/createTask, от 0,0222 $.
Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
generate_audio | Нет | Добавляет звук под картинку: голоса, атмосферу и эффекты. По умолчанию: false |
image_urls | Да | Фото для правки или объединения. В промпте укажите, что берётся из каждого. |
preset | Да | PixVerse effect template. It sets the clip length and the motion. 412736208886848 · 411563216524736 · 411316927927040 · 411174903569216 · 410999246341952 · 408891141511104 · 410317363057408 · 410285445698304 · 410133101388544 · 409899296377728 · 408897485909952 · 408869061406656 · 408661207662528 · 409767750265728 · 409766559675264 · 409589071559552 · 407804339389760 · 407658863287616 · 407474361215744 · 407473438360320 · 407467702283008 · 385844572217469 · 406428904874432 · 406423682060736 · 406411724685760 · 406372274350528 · 406218913317312 · 406218479198656 · 406064763308480 · 406413607395776 · 405662117814720 · 406014934000064 · 405658369331648 · 405321470423488 · 405175211454656 · 404955806201792 · 404820147974080 · 398980393937856 · 403916646846400 · 403739217192896 · 403560060358144 · 403556618212098 · 398965022284579 · 402201060373270 · 403085292466285 · 402061828030966 · 402888569901524 · 402155676592228 · 402047865383360 · 402046136040202 · По умолчанию: 398965022284579 |
prompt | Нет | Optional nudge for the template. The template already defines the motion. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 360p · 540p · 720p · 1080p · По умолчанию: 720p |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
Цены
Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
| Вариант | USD за секунду |
|---|---|
| generate_audio false · resolution 360p | 0,0222 $ |
| generate_audio false · resolution 540p | 0,0311 $ |
| generate_audio true · resolution 360p | 0,0311 $ |
| generate_audio false · resolution 720p | 0,04 $ |
| generate_audio true · resolution 540p | 0,04 $ |
| generate_audio true · resolution 720p | 0,0533 $ |
| generate_audio false · resolution 1080p | 0,08 $ |
| generate_audio true · resolution 1080p | 0,1022 $ |
До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.
Быстрый старт API
Вызов API PixVerse V6 Effects в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
- Отправьте запрос. Отправьте POST /jobs/createTask с model pixverse/v6-effects/image-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": "pixverse/v6-effects/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"preset": "398965022284579",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"resolution": "720p"
}
}'
# 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 PixVerse V6 Effects
Сколько стоит API PixVerse V6 Effects?
PixVerse V6 Effects стоит 0,0222 $ за секунду. Цены по вариантам: false · 360p 0,0222 $ за секунду, false · 540p 0,0311 $ за секунду, true · 360p 0,0311 $ за секунду, false · 720p 0,04 $ за секунду. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
Какое имя модели у PixVerse V6 Effects в API?
Укажите pixverse/v6-effects/image-to-video — Видео из картинки в поле model запроса POST /jobs/createTask.
Чем PixVerse V6 Effects отличается от PixVerse V6 image to video?
Effects начинается с шаблона: вы выбираете один из 50, загружаете фото, а шаблон задаёт длину и движение. PixVerse V6 image to video начинается с вашего промпта, позволяет выбрать длительность и добавить конечный кадр. Используйте /models/pixverse-v6, если хотите ставить клип сами.
Какой длины клип и сколько он занимает по времени?
Длину задаёт шаблон: наш клип Knee Slide длился 5,04 секунды. Поскольку у каждого шаблона своя длина, котировка держит максимум 30 секунд и освобождает разницу при доставке. Этот клип занял 36 секунд работы модели в 540p, не считая очереди и передачи; других шаблонов и разрешений мы не замеряли.
Какие фото нужны?
Одно фото для 47 шаблонов и два фото, по одному на каждого человека, для «Dive into the deep blue of love», «Top of the World» и «The Last Hug». JPG, JPEG, PNG или WebP, до 20 МБ каждое. В нашем тесте сработал чёткий студийный портрет.
Нужно ли писать промпт?
Нет. Шаблон уже задаёт движение, а если промпт не указан, мы отправим нейтральное значение. Короткая фраза, которая называет момент, — подсказка, а не управление; запуск с промптом и без него мы не сравнивали.
Какие ограничения у API PixVerse V6 Effects?
Разрешения: 360p · 540p · 720p · 1080p; Референсные изображения: 2; Длина промпта (символов): 5,000; Максимальный размер загрузки: 20 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать PixVerse V6 Effects без кода?
Запускайте PixVerse V6 Effects в Playground с баланса API в USD без API-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.
Все модели PixVerse
PixVerse V6 — открытая версия: вы пишете собственный промпт и сами задаёте длину.
- PixVerse V6 Max APIТоповый уровень PixVerse: клипы 1080p с необязательным звукомОт 0,133 $ за клип длиной 5 с
- PixVerse V6 Effects API50 готовых шаблонов эффектов, превращающих фото в тематический клипОт 0,0222 $ за секунду
- PixVerse V6 APIКлипы 1–15 секунд до 1080p, с референсами и переходамиОт 0,111 $ за клип длиной 5 с