PopNowДокументация API
Основное содержимое

Wan 3.0: справочник по API

Клипы до 30 секунд с синхронным звуком

С одним ключом PopNow API вы вызываете Wan 3.0 прямо из своего кода. Здесь собраны ID модели, которые нужно передать, все поля, которые она принимает, стоимость запроса в кредитах и готовый запрос — его можно вставить в терминал и запустить.

Описания параметров взяты из входной схемы модели и пока доступны только на английском.

Кратко

Разработчик
Alibaba
Результат
Видео
От
6.75 кр. за секунду результата ($0.0675)
Обычное время
около 147 с

1 кредит = 0,01 $. При приёме задачи резервируется максимально возможная сумма, а после завершения списывается фактический расход с округлением вверх до целого кредита; остаток возвращается. За задачи, завершившиеся ошибкой, плата не взимается. Точную сумму до запуска покажет POST /api/v1/jobs/quote.

Создать видео

alibaba/wan-3.0/text-to-video

Цена

ВариантКредиты (за секунду результата)Доллары США
480p6.75$0.0675
720p13.5$0.135
1080p27$0.27

Параметры

ПолеТипПо умолчаниюДопустимые значенияНазначение
promptОбязательноstring——Describe the subject, action, camera, light, pacing, and boundaries for the shot.
aspect_ratioНеобязательноstring16:916:9, 9:16, 1:1, 4:3, 3:4, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
enable_thinkingНеобязательноbooleanfalse—Let the model reason about the brief and the reference material before generating. Helps with complex references; slower. Switches on by itself when a reference file or link is given.
resolutionНеобязательноstring720p480p, 720p, 1080pOutput resolution.
duration_secondsНеобязательноinteger5-1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, … (+16)Requested output length in seconds. Pass -1 for smart duration: the model picks the length from the prompt and any input media instead of a fixed number.
generate_audioНеобязательноbooleantrue—Request generated audio with the video.
enable_prompt_expansionНеобязательноbooleanfalse—Allow the service to expand the submitted creative brief before generation.
seedНеобязательноinteger—от 0 до 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Пример запроса

Запрос работает как есть; поля, которые вы не указали, берут значения по умолчанию. Сначала положите ключ в переменную POPNOW_API_KEY.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "alibaba/wan-3.0/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

В ответе сразу приходит taskId. Результат забирайте через GET /api/v1/jobs/recordInfo или передайте callBackUrl, чтобы получить уведомление.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Видео из картинки

alibaba/wan-3.0/image-to-video

Цена

ВариантКредиты (за секунду результата)Доллары США
480p6.75$0.0675
720p13.5$0.135
1080p27$0.27

Параметры

ПолеТипПо умолчаниюДопустимые значенияНазначение
image_urlОбязательноstring——Opening-frame image.
promptНеобязательноstring——Describe the subject, action, camera, light, pacing, and boundaries for the shot.
last_image_urlНеобязательноstring——Optional last frame: the clip ends exactly on this image. Requires image_url.
aspect_ratioНеобязательноstring—16:9, 9:16, 1:1, 4:3, 3:4, adaptiveOutput aspect ratio. Omit it to let the task adapt to the opening image; adaptive follows the input media and the intent.
enable_thinkingНеобязательноbooleanfalse—Let the model reason about the brief and the reference material before generating. Helps with complex references; slower. Switches on by itself when a reference file or link is given.
resolutionНеобязательноstring720p480p, 720p, 1080pOutput resolution.
duration_secondsНеобязательноinteger5-1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, … (+16)Requested output length in seconds. Pass -1 for smart duration: the model picks the length from the prompt and any input media instead of a fixed number.
generate_audioНеобязательноbooleantrue—Request generated audio with the video.
enable_prompt_expansionНеобязательноbooleanfalse—Allow the service to expand the submitted creative brief before generation.
seedНеобязательноinteger—от 0 до 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Пример запроса

Запрос работает как есть; поля, которые вы не указали, берут значения по умолчанию. Сначала положите ключ в переменную POPNOW_API_KEY.

В примере в image_url стоят демонстрационные файлы PopNow. Замените их своими публичными HTTPS-ссылками, загруженными файлами или сохранёнными ассетами.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "alibaba/wan-3.0/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

В ответе сразу приходит taskId. Результат забирайте через GET /api/v1/jobs/recordInfo или передайте callBackUrl, чтобы получить уведомление.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Видео по референсам

alibaba/wan-3.0/reference-to-video

Цена

ВариантКредиты (за секунду результата)Доллары США
480p6.75$0.0675
720p13.5$0.135
1080p27$0.27

Параметры

ПолеТипПо умолчаниюДопустимые значенияНазначение
promptНеобязательноstring——Describe the subject, action, camera, light, pacing, and boundaries for the shot.
reference_image_urlsНеобязательноarray<string>—до 10 элементовReference images, up to 10 items.
reference_video_urlsНеобязательноarray<string>—до 5 элементовReference videos, up to 5 items and 15 seconds in total.
reference_audio_urlsНеобязательноarray<string>—до 5 элементовReference audio, up to 5 items and 15 seconds in total.
reference_file_urlНеобязательноstring (uri)——One reference document (PDF, DOCX, TXT, MD and similar) that the model reads for characters, wardrobe, setting and action.
reference_link_urlНеобязательноstring (uri)——One public web page the model reads for reference. It must open without a login.
aspect_ratioНеобязательноstring16:916:9, 9:16, 1:1, 4:3, 3:4, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
enable_thinkingНеобязательноbooleanfalse—Let the model reason about the brief and the reference material before generating. Helps with complex references; slower. Switches on by itself when a reference file or link is given.
resolutionНеобязательноstring720p480p, 720p, 1080pOutput resolution.
duration_secondsНеобязательноinteger5-1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, … (+16)Requested output length in seconds. Pass -1 for smart duration: the model picks the length from the prompt and any input media instead of a fixed number. With reference videos, their total length plus the output length must not exceed 30 seconds, and the reference video seconds are billed together with the output seconds.
generate_audioНеобязательноbooleantrue—Request generated audio with the video.
enable_prompt_expansionНеобязательноboolean——Allow the service to expand the submitted creative brief before generation.
seedНеобязательноinteger—от 0 до 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Пример запроса

Запрос работает как есть; поля, которые вы не указали, берут значения по умолчанию. Сначала положите ключ в переменную POPNOW_API_KEY.

В примере в reference_image_urls стоят демонстрационные файлы PopNow. Замените их своими публичными HTTPS-ссылками, загруженными файлами или сохранёнными ассетами.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "alibaba/wan-3.0/reference-to-video",
  "input": {
    "prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

В ответе сразу приходит taskId. Результат забирайте через GET /api/v1/jobs/recordInfo или передайте callBackUrl, чтобы получить уведомление.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Продлить видео

alibaba/wan-3.0/video-extend

Цена

ВариантКредиты (за секунду результата)Доллары США
480p6.75$0.0675
720p13.5$0.135
1080p27$0.27

Параметры

ПолеТипПо умолчаниюДопустимые значенияНазначение
video_urlОбязательноstring (uri)——The clip to continue: MP4, MOV or WebM, up to 60 seconds. Its last frame opens the new segment, and the result is your clip with the new segment joined on.
promptНеобязательноstring——Optional. Describe what happens next: the action that follows, the camera move and the sound.
last_image_urlНеобязательноstring——Optional target end frame: the new segment finishes on exactly this image.
enable_thinkingНеобязательноbooleanfalse—Let the model reason about the brief and the reference material before generating. Helps with complex references; slower. Switches on by itself when a reference file or link is given.
resolutionНеобязательноstring720p480p, 720p, 1080pResolution the new segment is generated at. Match your source to avoid a visible step in sharpness at the seam.
duration_secondsНеобязательноinteger5-1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, … (+16)Length of the new segment in seconds. Pass -1 to let the model pick the length. The source clip is added on top and is not billed.
generate_audioНеобязательноbooleantrue—Generate sound for the new segment. The source keeps its own sound either way.
enable_prompt_expansionНеобязательноbooleanfalse—Allow the service to expand the submitted creative brief before generation.
seedНеобязательноinteger—от 0 до 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Пример запроса

Запрос работает как есть; поля, которые вы не указали, берут значения по умолчанию. Сначала положите ключ в переменную POPNOW_API_KEY.

В примере в video_url стоят демонстрационные файлы PopNow. Замените их своими публичными HTTPS-ссылками, загруженными файлами или сохранёнными ассетами.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "alibaba/wan-3.0/video-extend",
  "input": {
    "prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

В ответе сразу приходит taskId. Результат забирайте через GET /api/v1/jobs/recordInfo или передайте callBackUrl, чтобы получить уведомление.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Что дальше

На этой странице