PopNowDocs de la API
Contenido principal

Referencia de la API de Wan 3.0 Prime

Wan 3.0 más rápido, hasta 30 segundos con audio

Con una sola clave de API de PopNow puedes llamar a Wan 3.0 Prime desde tu propio código. Aquí tienes los ID de modelo que debes enviar, cada campo de entrada que acepta, cuántos créditos cuesta cada solicitud y una petición que puedes pegar tal cual en la terminal.

Las descripciones de los parámetros vienen del esquema de entrada del modelo y solo están en inglés.

De un vistazo

Creado por
Alibaba
Resultado
Video
Desde
9.18 créditos por segundo generado ($0.0918)
Tiempo habitual
unos 88 s

1 crédito = 0,01 US$. Al aceptarse, la tarea retiene el cargo máximo posible y al terminar cobra el uso real, redondeado al crédito superior; el resto se libera. Las tareas fallidas no se cobran. Para saber la cifra exacta antes de ejecutar, llama a POST /api/v1/jobs/quote.

Crear video

alibaba/wan-3.0-prime/text-to-video

Precio

OpciónCréditos (por segundo generado)Dólares
480p9.18$0.0918
720p18.9$0.189
1080p37.8$0.378

Parámetros

CampoTipoValor predeterminadoValores admitidosPara qué sirve
promptObligatoriostring——Describe the subject, action, camera, light, pacing, and boundaries for the shot.
aspect_ratioOpcionalstring16:916:9, 9:16, 1:1, 4:3, 3:4, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
enable_thinkingOpcionalbooleanfalse—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.
resolutionOpcionalstring720p480p, 720p, 1080pOutput resolution.
duration_secondsOpcionalinteger5-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_audioOpcionalbooleantrue—Request generated audio with the video.
enable_prompt_expansionOpcionalbooleanfalse—Allow the service to expand the submitted creative brief before generation.
seedOpcionalinteger—de 0 a 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Solicitud de ejemplo

Esta solicitud funciona tal cual; los campos que no envíes usan su valor predeterminado. Antes, guarda tu clave en 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-prime/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 respuesta trae un taskId al instante. Consulta el resultado con GET /api/v1/jobs/recordInfo o añade callBackUrl para recibir un aviso.

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"

Imagen a video

alibaba/wan-3.0-prime/image-to-video

Precio

OpciónCréditos (por segundo generado)Dólares
480p9.18$0.0918
720p18.9$0.189
1080p37.8$0.378

Parámetros

CampoTipoValor predeterminadoValores admitidosPara qué sirve
image_urlObligatoriostring——Opening-frame image.
promptOpcionalstring——Describe the subject, action, camera, light, pacing, and boundaries for the shot.
last_image_urlOpcionalstring——Optional last frame: the clip ends exactly on this image. Requires image_url.
aspect_ratioOpcionalstring—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_thinkingOpcionalbooleanfalse—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.
resolutionOpcionalstring720p480p, 720p, 1080pOutput resolution.
duration_secondsOpcionalinteger5-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_audioOpcionalbooleantrue—Request generated audio with the video.
enable_prompt_expansionOpcionalbooleanfalse—Allow the service to expand the submitted creative brief before generation.
seedOpcionalinteger—de 0 a 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Solicitud de ejemplo

Esta solicitud funciona tal cual; los campos que no envíes usan su valor predeterminado. Antes, guarda tu clave en POPNOW_API_KEY.

El ejemplo usa archivos de muestra de PopNow en image_url. Cámbialos por tus propios enlaces HTTPS públicos, archivos subidos o recursos guardados.

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-prime/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 respuesta trae un taskId al instante. Consulta el resultado con GET /api/v1/jobs/recordInfo o añade callBackUrl para recibir un aviso.

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"

Referencias a video

alibaba/wan-3.0-prime/reference-to-video

Precio

OpciónCréditos (por segundo generado)Dólares
480p9.18$0.0918
720p18.9$0.189
1080p37.8$0.378

Parámetros

CampoTipoValor predeterminadoValores admitidosPara qué sirve
promptOpcionalstring——Describe the subject, action, camera, light, pacing, and boundaries for the shot.
reference_image_urlsOpcionalarray<string>—hasta 10 elementosReference images, up to 10 items.
reference_video_urlsOpcionalarray<string>—hasta 5 elementosReference videos, up to 5 items and 15 seconds in total.
reference_audio_urlsOpcionalarray<string>—hasta 5 elementosReference audio, up to 5 items and 15 seconds in total.
reference_file_urlOpcionalstring (uri)——One reference document (PDF, DOCX, TXT, MD and similar) that the model reads for characters, wardrobe, setting and action.
reference_link_urlOpcionalstring (uri)——One public web page the model reads for reference. It must open without a login.
aspect_ratioOpcionalstring16:916:9, 9:16, 1:1, 4:3, 3:4, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
enable_thinkingOpcionalbooleanfalse—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.
resolutionOpcionalstring720p480p, 720p, 1080pOutput resolution.
duration_secondsOpcionalinteger5-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_audioOpcionalbooleantrue—Request generated audio with the video.
enable_prompt_expansionOpcionalboolean——Allow the service to expand the submitted creative brief before generation.
seedOpcionalinteger—de 0 a 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Solicitud de ejemplo

Esta solicitud funciona tal cual; los campos que no envíes usan su valor predeterminado. Antes, guarda tu clave en POPNOW_API_KEY.

El ejemplo usa archivos de muestra de PopNow en reference_image_urls. Cámbialos por tus propios enlaces HTTPS públicos, archivos subidos o recursos guardados.

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-prime/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 respuesta trae un taskId al instante. Consulta el resultado con GET /api/v1/jobs/recordInfo o añade callBackUrl para recibir un aviso.

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"

Extender video

alibaba/wan-3.0-prime/video-extend

Precio

OpciónCréditos (por segundo generado)Dólares
480p9.18$0.0918
720p18.9$0.189
1080p37.8$0.378

Parámetros

CampoTipoValor predeterminadoValores admitidosPara qué sirve
video_urlObligatoriostring (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.
promptOpcionalstring——Optional. Describe what happens next: the action that follows, the camera move and the sound.
last_image_urlOpcionalstring——Optional target end frame: the new segment finishes on exactly this image.
enable_thinkingOpcionalbooleanfalse—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.
resolutionOpcionalstring720p480p, 720p, 1080pResolution the new segment is generated at. Match your source to avoid a visible step in sharpness at the seam.
duration_secondsOpcionalinteger5-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_audioOpcionalbooleantrue—Generate sound for the new segment. The source keeps its own sound either way.
enable_prompt_expansionOpcionalbooleanfalse—Allow the service to expand the submitted creative brief before generation.
seedOpcionalinteger—de 0 a 2147483647Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Solicitud de ejemplo

Esta solicitud funciona tal cual; los campos que no envíes usan su valor predeterminado. Antes, guarda tu clave en POPNOW_API_KEY.

El ejemplo usa archivos de muestra de PopNow en video_url. Cámbialos por tus propios enlaces HTTPS públicos, archivos subidos o recursos guardados.

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-prime/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 respuesta trae un taskId al instante. Consulta el resultado con GET /api/v1/jobs/recordInfo o añade callBackUrl para recibir un aviso.

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"

Siguientes pasos

En esta página