Seedance 2.5 Reference 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/reference-to-video Endpoint ID: bytedance/seedance-2.5/reference-to-video ▶Try Seedance 2.5 Reference To VideoOpen this endpoint in the Higgsfield API Playground.↗

Quick Start

import higgsfield_client

result = higgsfield_client.subscribe(
    "bytedance/seedance-2.5/reference-to-video",
    arguments={'prompt': 'A cinematic tracking shot along a sunlit coastal road',
 'resolution': '720p',
 'generate_audio': True,
 'duration': 5,
 'aspect_ratio': '16:9',
 'image_urls': ['https://cdn.example.com/character.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/reference-to-video",
  {
    input: {
  "prompt": "A cinematic tracking shot along a sunlit coastal road",
  "resolution": "720p",
  "generate_audio": true,
  "duration": 5,
  "aspect_ratio": "16:9",
  "image_urls": [
    "https://cdn.example.com/character.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/reference-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,
  "aspect_ratio": "16:9",
  "image_urls": [
    "https://cdn.example.com/character.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:"16:9"

Output aspect ratio. Use an explicit ratio for reference-to-video requests. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9.

string

default:"mp4"

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

array

Public reference image URLs. Accepts 1–30 URLs when provided.

array

Public reference video URLs. Accepts 1–10 URLs when provided.

array

Public reference audio URLs. Accepts 1–10 URLs when provided.

Use public media URLs; asset:// references are not supported. Provide at least one reference image, video, or audio file. Set an explicit aspect_ratio. 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,
  "aspect_ratio": "16:9",
  "image_urls": [
    "https://cdn.example.com/character.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-reference-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

Seedance 2.5 Reference To Video API

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