PopNowDocs API
Contenuto principale

Riferimento API di Wan 3.0 Pro

Wan 3.0 in 1080p, 2K o 4K, fino a 30 secondi

Con una sola chiave API di PopNow chiami Wan 3.0 Pro 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
21.6 crediti per secondo generato ($0.216)
Tempo tipico
circa 178 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-pro/text-to-video

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
1080p21.6$0.216
2k24$0.24
4k27.6$0.276

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 20.000 caratteriDescribe the subject, motion and camera.
resolutionFacoltativostring1080p1080p, 2k, 4kOutput resolution tier. A native Wan 3.0 render tops out at 1080p, so the 2k and 4k tiers are delivered by enlarging that render instead of rendering natively at those sizes.
aspect_ratioFacoltativostringadaptive16:9, 4:3, 1:1, 3:4, 9:16, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
duration_secondsFacoltativointeger5-1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, … (+16)Output duration 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—Include an audio track in the output.
enable_prompt_expansionFacoltativobooleantrue—Expand the prompt before generation.
seedFacoltativointeger—da 0 a 2147483647Random seed. Omit for a generated seed.

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-pro/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": "1080p"
  }
}'

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-pro/image-to-video

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
1080p21.6$0.216
2k24$0.24
4k27.6$0.276

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
image_urlObbligatoriostring (uri)——Opening frame image.
promptFacoltativostring—fino a 20.000 caratteriDescribe the subject, motion and camera.
last_image_urlFacoltativostring (uri)——Optional last frame: the clip ends exactly on this image. Requires image_url.
resolutionFacoltativostring1080p1080p, 2k, 4kOutput resolution tier. A native Wan 3.0 render tops out at 1080p, so the 2k and 4k tiers are delivered by enlarging that render instead of rendering natively at those sizes.
aspect_ratioFacoltativostringadaptive16:9, 4:3, 1:1, 3:4, 9:16, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
duration_secondsFacoltativointeger5-1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, … (+16)Output duration 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—Include an audio track in the output.
enable_prompt_expansionFacoltativobooleantrue—Expand the prompt before generation.
seedFacoltativointeger—da 0 a 2147483647Random seed. Omit for a generated seed.

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-pro/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": "1080p"
  }
}'

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-pro/reference-to-video

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
1080p21.6$0.216
2k24$0.24
4k27.6$0.276

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptFacoltativostring—fino a 20.000 caratteriDescribe the subject, motion and camera.
reference_image_urlsFacoltativoarray<string (uri)>—fino a 10 elementiOrdered reference images used to guide the scene.
reference_video_urlsFacoltativoarray<string (uri)>—fino a 5 elementiReference videos, up to 5 clips of 1 to 15 seconds each and 15 seconds in total.
reference_audio_urlsFacoltativoarray<string (uri)>—fino a 5 elementiReference audio, up to 5 clips of 1 to 15 seconds each 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.
resolutionFacoltativostring1080p1080p, 2k, 4kOutput resolution tier. A native Wan 3.0 render tops out at 1080p, so the 2k and 4k tiers are delivered by enlarging that render instead of rendering natively at those sizes.
aspect_ratioFacoltativostringadaptive16:9, 4:3, 1:1, 3:4, 9:16, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
duration_secondsFacoltativointeger5-1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, … (+16)Output duration 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—Include an audio track in the output.
enable_prompt_expansionFacoltativobooleantrue—Expand the prompt before generation.
seedFacoltativointeger—da 0 a 2147483647Random seed. Omit for a generated seed.

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-pro/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": "1080p"
  }
}'

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-pro/video-extend

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
1080p21.6$0.216
2k24$0.24
4k27.6$0.276

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—fino a 20.000 caratteriDescribe what happens next: the action that follows and the camera move.
last_image_urlFacoltativostring (uri)——Optional target end frame: the new segment closes on this image. The opening frame comes from your clip.
resolutionFacoltativostring1080p1080p, 2k, 4kResolution tier of the new segment. A native render tops out at 1080p, so the 2k and 4k tiers are enlarged from it.
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_expansionFacoltativobooleantrue—Expand the prompt before generation.
seedFacoltativointeger—da 0 a 2147483647Random seed. Omit for a generated seed.

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-pro/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": "1080p"
  }
}'

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