Wan 3.0 Image to Video API

Text to video Image to video References

Endpoint: POST https://api.higgsfield.ai/alibaba/wan-3.0/image-to-video Endpoint ID: alibaba/wan-3.0/image-to-video ▶Try Wan 3.0 Image to VideoOpen this endpoint in the Higgsfield API Playground.↗

Quick Start

import higgsfield_client

result = higgsfield_client.subscribe(
    "alibaba/wan-3.0/image-to-video",
    arguments={
        "prompt": "The camera slowly pushes in as the neon reflections begin to move",
        "image_url": "https://cdn.example.com/first-frame.jpg",
        "end_image_url": "https://cdn.example.com/last-frame.jpg",
        "resolution": "1080p",
        "aspect_ratio": "adaptive",
        "duration": 8,
        "generate_audio": True,
    },
)

print(result["video"]["url"])

import { config, higgsfield } from "@higgsfield/client/v2";

config({ credentials: process.env.HF_CREDENTIALS });

const result = await higgsfield.subscribe(
  "alibaba/wan-3.0/image-to-video",
  {
    input: {
      prompt: "The camera slowly pushes in as the neon reflections begin to move",
      image_url: "https://cdn.example.com/first-frame.jpg",
      end_image_url: "https://cdn.example.com/last-frame.jpg",
      resolution: "1080p",
      aspect_ratio: "adaptive",
      duration: 8,
      generate_audio: true,
    },
    withPolling: true,
  },
);

if (result.isCompleted) console.log(result.jobs[0].results?.raw.url);

curl --request POST \
  --url https://api.higgsfield.ai/alibaba/wan-3.0/image-to-video \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "The camera slowly pushes in as the neon reflections begin to move",
    "image_url": "https://cdn.example.com/first-frame.jpg",
    "end_image_url": "https://cdn.example.com/last-frame.jpg",
    "resolution": "1080p",
    "aspect_ratio": "adaptive",
    "duration": 8,
    "generate_audio": true
  }'

Input Schema

string

required

Text instructions for motion, camera behavior, action, and audio.

string

required

Public URL of the first frame image.

string

Optional public URL of the last frame image.

string

default:"1080p"

Supported values: 480p, 720p, 1080p.

string

default:"adaptive"

Supported values: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16. adaptive follows the source frame.

integer

default:"5"

Output duration in seconds. Supported range: 2–30.

boolean

default:"true"

Generate synchronized dialogue, ambience, sound effects, and music.

boolean

default:"false"

Enable additional reasoning for complex instructions.

integer

Optional integer seed from 0 to 2147483647 for reproducibility.

Output Schema

string

required

Request state. A newly accepted request returns queued.

string

required

Stable identifier used for polling, cancellation, and support.

string

required

URL to poll until the request reaches a terminal state.

string

required

URL used to cancel a request before processing starts.

object

Completed video output containing its download url.

Input Example

{
  "prompt": "The camera slowly pushes in as the neon reflections begin to move",
  "image_url": "https://cdn.example.com/first-frame.jpg",
  "end_image_url": "https://cdn.example.com/last-frame.jpg",
  "resolution": "1080p",
  "aspect_ratio": "adaptive",
  "duration": 8,
  "generate_audio": true
}

Output Example

{
  "status": "queued",
  "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
  "status_url": "https://api.higgsfield.ai/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/status",
  "cancel_url": "https://api.higgsfield.ai/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/cancel"
}

{
  "status": "completed",
  "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
  "video": { "url": "https://cdn.example.com/wan-3-image-to-video.mp4" }
}

Use an SDK for automatic polling, or poll the returned status URL.

Get started

Model API reference

Core concepts

SDKs

Organizations

API reference

Resources

Quick Start

Input Schema

Output Schema

Input Example

Output Example

​Quick Start

​Input Schema

​Output Schema

​Input Example

​Output Example

Quick Start

Input Schema

Output Schema

Input Example

Output Example