PopNowAPI-Doku
Hauptinhalt

Wan 3.0 Pro API-Referenz

Wan 3.0 in 1080p, 2K oder 4K, bis 30 Sekunden

Mit einem einzigen PopNow-API-Schlüssel rufst du Wan 3.0 Pro aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.

Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.

Auf einen Blick

Hersteller
Alibaba
Ergebnis
Video
Ab
21.6 Credits pro Sekunde Ergebnis ($0.216)
Typische Dauer
etwa 178 s

1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.

Video erstellen

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

Preis

OptionCredits (pro Sekunde Ergebnis)US-Dollar
1080p21.6$0.216
2k24$0.24
4k27.6$0.276

Parameter

FeldTypStandardwertErlaubtBedeutung
promptPflichtstring—bis zu 20.000 ZeichenDescribe the subject, motion and camera.
resolutionOptionalstring1080p1080p, 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_ratioOptionalstringadaptive16:9, 4:3, 1:1, 3:4, 9:16, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
duration_secondsOptionalinteger5-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_audioOptionalbooleantrue—Include an audio track in the output.
enable_prompt_expansionOptionalbooleantrue—Expand the prompt before generation.
seedOptionalinteger—0 bis 2147483647Random seed. Omit for a generated seed.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

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

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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"

Bild zu Video

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

Preis

OptionCredits (pro Sekunde Ergebnis)US-Dollar
1080p21.6$0.216
2k24$0.24
4k27.6$0.276

Parameter

FeldTypStandardwertErlaubtBedeutung
image_urlPflichtstring (uri)——Opening frame image.
promptOptionalstring—bis zu 20.000 ZeichenDescribe the subject, motion and camera.
last_image_urlOptionalstring (uri)——Optional last frame: the clip ends exactly on this image. Requires image_url.
resolutionOptionalstring1080p1080p, 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_ratioOptionalstringadaptive16:9, 4:3, 1:1, 3:4, 9:16, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
duration_secondsOptionalinteger5-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_audioOptionalbooleantrue—Include an audio track in the output.
enable_prompt_expansionOptionalbooleantrue—Expand the prompt before generation.
seedOptionalinteger—0 bis 2147483647Random seed. Omit for a generated seed.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in image_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

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

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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"

Referenz zu Video

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

Preis

OptionCredits (pro Sekunde Ergebnis)US-Dollar
1080p21.6$0.216
2k24$0.24
4k27.6$0.276

Parameter

FeldTypStandardwertErlaubtBedeutung
promptOptionalstring—bis zu 20.000 ZeichenDescribe the subject, motion and camera.
reference_image_urlsOptionalarray<string (uri)>—bis zu 10 EinträgeOrdered reference images used to guide the scene.
reference_video_urlsOptionalarray<string (uri)>—bis zu 5 EinträgeReference videos, up to 5 clips of 1 to 15 seconds each and 15 seconds in total.
reference_audio_urlsOptionalarray<string (uri)>—bis zu 5 EinträgeReference audio, up to 5 clips of 1 to 15 seconds each and 15 seconds in total.
reference_file_urlOptionalstring (uri)——One reference document (PDF, DOCX, TXT, MD and similar) that the model reads for characters, wardrobe, setting and action.
reference_link_urlOptionalstring (uri)——One public web page the model reads for reference. It must open without a login.
resolutionOptionalstring1080p1080p, 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_ratioOptionalstringadaptive16:9, 4:3, 1:1, 3:4, 9:16, adaptiveOutput aspect ratio; adaptive follows the input media and the intent.
duration_secondsOptionalinteger5-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_audioOptionalbooleantrue—Include an audio track in the output.
enable_prompt_expansionOptionalbooleantrue—Expand the prompt before generation.
seedOptionalinteger—0 bis 2147483647Random seed. Omit for a generated seed.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in reference_image_urls Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

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

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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"

Video verlängern

alibaba/wan-3.0-pro/video-extend

Preis

OptionCredits (pro Sekunde Ergebnis)US-Dollar
1080p21.6$0.216
2k24$0.24
4k27.6$0.276

Parameter

FeldTypStandardwertErlaubtBedeutung
video_urlPflichtstring (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.
promptOptionalstring—bis zu 20.000 ZeichenDescribe what happens next: the action that follows and the camera move.
last_image_urlOptionalstring (uri)——Optional target end frame: the new segment closes on this image. The opening frame comes from your clip.
resolutionOptionalstring1080p1080p, 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_secondsOptionalinteger5-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_audioOptionalbooleantrue—Generate sound for the new segment. The source keeps its own sound either way.
enable_prompt_expansionOptionalbooleantrue—Expand the prompt before generation.
seedOptionalinteger—0 bis 2147483647Random seed. Omit for a generated seed.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in video_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

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

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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"

Weiter geht’s

Auf dieser Seite