Seedance 2.5 Image To Video API

Text to video Image to video Reference to video Video edit Video extend

Endpoint: POST https://api.higgsfield.ai/bytedance/seedance-2.5/image-to-video Endpoint ID: bytedance/seedance-2.5/image-to-video ▶Try Seedance 2.5 Image To VideoOpen this endpoint in the Higgsfield API Playground.↗

Quick Start

import higgsfield_client

result = higgsfield_client.subscribe(
    "bytedance/seedance-2.5/image-to-video",
    arguments={'prompt': 'A cinematic tracking shot along a sunlit coastal road',
 'resolution': '720p',
 'generate_audio': True,
 'duration': 5,
 'image_url': 'https://cdn.example.com/first-frame.jpg',
 'output_format': 'mp4'},
)

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

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

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

const result = await higgsfield.subscribe(
  "bytedance/seedance-2.5/image-to-video",
  {
    input: {
  "prompt": "A cinematic tracking shot along a sunlit coastal road",
  "resolution": "720p",
  "generate_audio": true,
  "duration": 5,
  "image_url": "https://cdn.example.com/first-frame.jpg",
  "output_format": "mp4"
},
    withPolling: true,
  },
);

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

curl --request POST \
  --url https://api.higgsfield.ai/bytedance/seedance-2.5/image-to-video \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "A cinematic tracking shot along a sunlit coastal road",
  "resolution": "720p",
  "generate_audio": true,
  "duration": 5,
  "image_url": "https://cdn.example.com/first-frame.jpg",
  "output_format": "mp4"
}'

Input Schema

string

Text instructions describing the desired output. Must not be empty when provided.

string

default:"720p"

Output video resolution. Supported values: 480p, 720p.

boolean

default:"true"

Generate synchronized audio for the output video.

integer

default:"5"

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

string

default:"mp4"

Container format of the output video. Supported values: mp4, mov.

string

required

Public URL of the first frame.

string

Optional public URL of the last frame.

Use public media URLs; asset:// references are not supported. Framing follows the input image. Do not send reference arrays or video_url. Automatic duration (-1) is not supported.

Output Schema

string

required

Request state. A newly accepted request returns queued.

string

required

Identifier used for polling and cancellation.

string

required

URL to poll for request status.

string

required

URL used to cancel the request before processing starts.

object

Completed video output containing its download url.

Input Example

{
  "prompt": "A cinematic tracking shot along a sunlit coastal road",
  "resolution": "720p",
  "generate_audio": true,
  "duration": 5,
  "image_url": "https://cdn.example.com/first-frame.jpg",
  "output_format": "mp4"
}

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/seedance-2-5-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