PopNowDocs API
Contenuto principale

Riferimento API di Wan 3.0

Clip fino a 30 secondi con audio sincronizzato

Con una sola chiave API di PopNow chiami Wan 3.0 dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.

Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.

In sintesi

Sviluppato da
Alibaba
Risultato
Video
Da
6.75 crediti per secondo generato ($0.0675)
Tempo tipico
circa 147 s
ID del modello

1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.

Crea video

alibaba/wan-3.0/text-to-video

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
480p6.75$0.0675
720p13.5$0.135
1080p27$0.27

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring——Describe the subject, action, camera, light, pacing, and boundaries for the shot.
aspect_ratioFacoltativostring16:916:9, 9:16, 1:1, 4:3, 3:4, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
enable_thinkingFacoltativobooleanfalse—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.
resolutionFacoltativostring720p480p, 720p, 1080pOutput resolution.
duration_secondsFacoltativointeger5-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_audioFacoltativobooleantrue—Request generated audio with the video.
enable_prompt_expansionFacoltativobooleanfalse—Allow the service to expand the submitted creative brief before generation.
seedFacoltativointeger—da 0 a 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in 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"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

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"

Da immagine a video

alibaba/wan-3.0/image-to-video

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
480p6.75$0.0675
720p13.5$0.135
1080p27$0.27

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
image_urlObbligatoriostring——Opening-frame image.
promptFacoltativostring——Describe the subject, action, camera, light, pacing, and boundaries for the shot.
last_image_urlFacoltativostring——Optional last frame: the clip ends exactly on this image. Requires image_url.
aspect_ratioFacoltativostring—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_thinkingFacoltativobooleanfalse—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.
resolutionFacoltativostring720p480p, 720p, 1080pOutput resolution.
duration_secondsFacoltativointeger5-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_audioFacoltativobooleantrue—Request generated audio with the video.
enable_prompt_expansionFacoltativobooleanfalse—Allow the service to expand the submitted creative brief before generation.
seedFacoltativointeger—da 0 a 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in image_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

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"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

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"

Da riferimenti a video

alibaba/wan-3.0/reference-to-video

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
480p6.75$0.0675
720p13.5$0.135
1080p27$0.27

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptFacoltativostring——Describe the subject, action, camera, light, pacing, and boundaries for the shot.
reference_image_urlsFacoltativoarray<string>—fino a 10 elementiReference images, up to 10 items.
reference_video_urlsFacoltativoarray<string>—fino a 5 elementiReference videos, up to 5 items and 15 seconds in total.
reference_audio_urlsFacoltativoarray<string>—fino a 5 elementiReference audio, up to 5 items and 15 seconds in total.
reference_file_urlFacoltativostring (uri)——One reference document (PDF, DOCX, TXT, MD and similar) that the model reads for characters, wardrobe, setting and action.
reference_link_urlFacoltativostring (uri)——One public web page the model reads for reference. It must open without a login.
aspect_ratioFacoltativostring16:916:9, 9:16, 1:1, 4:3, 3:4, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
enable_thinkingFacoltativobooleanfalse—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.
resolutionFacoltativostring720p480p, 720p, 1080pOutput resolution.
duration_secondsFacoltativointeger5-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_audioFacoltativobooleantrue—Request generated audio with the video.
enable_prompt_expansionFacoltativoboolean——Allow the service to expand the submitted creative brief before generation.
seedFacoltativointeger—da 0 a 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in reference_image_urls. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

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"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

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"

Allunga video

alibaba/wan-3.0/video-extend

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
480p6.75$0.0675
720p13.5$0.135
1080p27$0.27

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
video_urlObbligatoriostring (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.
promptFacoltativostring——Optional. Describe what happens next: the action that follows, the camera move and the sound.
last_image_urlFacoltativostring——Optional target end frame: the new segment finishes on exactly this image.
enable_thinkingFacoltativobooleanfalse—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.
resolutionFacoltativostring720p480p, 720p, 1080pResolution the new segment is generated at. Match your source to avoid a visible step in sharpness at the seam.
duration_secondsFacoltativointeger5-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_audioFacoltativobooleantrue—Generate sound for the new segment. The source keeps its own sound either way.
enable_prompt_expansionFacoltativobooleanfalse—Allow the service to expand the submitted creative brief before generation.
seedFacoltativointeger—da 0 a 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in video_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

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"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

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"

Passi successivi

In questa pagina

In sintesiCrea videoDa immagine a videoDa riferimenti a videoAllunga videoPassi successivi