Wan 3.0

Model ID

wan-3.0

Use this public model ID in every request. Do not send an internal model name or provider prefix.

Capabilities

adaptive lets the model select an aspect ratio from the prompt and reference assets. For production integrations, set resolution, aspect_ratio, and seconds explicitly so future default changes do not affect output.

Configurable fields

Only send the public extension fields listed above. Reference assets must be URLs that the service can access, not local paths, authenticated page URLs, or expired signed URLs.

Media types and limits

Reference images, videos, audio, files, and links cannot be combined with first_frame or last_frame in the same request. Images may use HTTP/HTTPS URLs, temporary Alibaba Cloud OSS URLs, or data:{MIME_type};base64,{base64_data}. Other media must use a service-accessible URL.

Prompt enhancement

Use extra_body.prompt_extend to control the officially documented prompt enhancement behavior. Do not send prompt_enhance, enhance_prompt, prompt_optimization, enable_thinking, think_level, thinking_level, or reasoning_effort; these fields are not part of the stable Wan 3.0 API contract.

Generation modes

First-frame images and reference images have different semantics. A first-frame field constrains the opening frame; reference_image_urls provides content guidance only. Do not pass an image array to input_reference for multi-image reference generation.

Text-to-video example

curl -X POST 'https://silkdock.ai/v1/videos/generations' \
  -H 'Authorization: Bearer $SILKDOCK_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "wan-3.0",
    "prompt": "A vintage convertible follows a coastal road at dawn as the camera descends slowly, with ocean waves and wind",
    "seconds": 10,
    "extra_body": {
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "audio": true,
      "prompt_extend": true
    }
  }'

First-frame example

{
  "model": "wan-3.0",
  "prompt": "The subject turns and runs forward as the camera pulls back smoothly; preserve the subject's appearance",
  "input_reference": "https://example.com/start.png",
  "seconds": 8,
  "extra_body": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "audio": true
  }
}

Start/end-frame example

{
  "model": "wan-3.0",
  "prompt": "Transition naturally from daylight to a city at night while the camera slowly moves forward",
  "seconds": 10,
  "extra_body": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "first_frame_url": "https://example.com/day.png",
    "last_frame_url": "https://example.com/night.png",
    "audio": true
  }
}

Multimodal reference example

{
  "model": "wan-3.0",
  "prompt": "Use the reference subject and setting, follow the reference video's camera rhythm, and create a cinematic short with ambient sound",
  "seconds": 15,
  "extra_body": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "reference_image_urls": [
      "https://example.com/character.png",
      "https://example.com/location.png"
    ],
    "reference_video_urls": [
      "https://example.com/camera-motion.mp4"
    ],
    "audio_url": "https://example.com/ambient.wav",
    "audio": true
  }
}

Pricing

Wan 3.0 is billed by the actual generated duration: resolution price/second * generated seconds. The rates below use the Alibaba Cloud international Singapore-region standard price, not a converted mainland-China RMB price.

The rate is the same for audio: true and audio: false. When seconds is -1, billing uses the video's actual generated duration.

Check and download a task

Creating a video returns a task ID. Poll the status endpoint until the task is completed or failed:

curl 'https://silkdock.ai/v1/videos/<VIDEO_ID>' \
  -H 'Authorization: Bearer $SILKDOCK_API_KEY'

Download content only after completion:

curl -L 'https://silkdock.ai/v1/videos/<VIDEO_ID>/content' \
  -H 'Authorization: Bearer $SILKDOCK_API_KEY' \
  -o result.mp4

Poll every 3-5 seconds in production and set an application-level timeout. Stop polling on failed and record the task ID and error details.

Integration constraints

• Use the documented lowercase values, such as 1080p and adaptive.
• Do not send last_frame_url without a first-frame field.
• Do not send audio_url when audio is false.
• Undocumented extension fields, reference-asset count limits, formats, and file sizes are not part of the stable public contract.
• A 403 usually means the account does not have access, 400 indicates invalid parameters or assets, and 429 indicates a rate or quota limit.

See the official Wan 3.0 API reference and international model and pricing page. Parameter names and defaults follow the API reference; prices follow the international page.