Seedance 2.5 — Reference To Video

Create Seedance 2.5 — Reference To Video

curl --request POST \
  --url https://api.apisale.ai/v1/run/bytedance/seedance-2.5/reference-to-video \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": {
    "prompt": "The person in @Image1 walks through a rain-soaked Tokyo side street, neon reflections on asphalt, smooth tracking, keep wardrobe and face consistent",
    "duration": "5",
    "resolution": "720p",
    "aspect_ratio": "auto",
    "bitrate_mode": "standard",
    "generate_audio": true,
    "image_urls": [
      "https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png"
    ]
  }
}
'

import requests

url = "https://api.apisale.ai/v1/run/bytedance/seedance-2.5/reference-to-video"

payload = { "input": {
        "prompt": "The person in @Image1 walks through a rain-soaked Tokyo side street, neon reflections on asphalt, smooth tracking, keep wardrobe and face consistent",
        "duration": "5",
        "resolution": "720p",
        "aspect_ratio": "auto",
        "bitrate_mode": "standard",
        "generate_audio": True,
        "image_urls": ["https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png"]
    } }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    input: {
      prompt: 'The person in @Image1 walks through a rain-soaked Tokyo side street, neon reflections on asphalt, smooth tracking, keep wardrobe and face consistent',
      duration: '5',
      resolution: '720p',
      aspect_ratio: 'auto',
      bitrate_mode: 'standard',
      generate_audio: true,
      image_urls: [
        'https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png'
      ]
    }
  })
};

fetch('https://api.apisale.ai/v1/run/bytedance/seedance-2.5/reference-to-video', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "run_id": "<string>",
  "endpoint": "<string>",
  "model": "<string>",
  "capability": "<string>",
  "mode": "<string>",
  "status": "queued",
  "created_at": "2023-11-07T05:31:56Z",
  "output": {},
  "error": {
    "type": "<string>",
    "code": 123,
    "message": "<string>"
  },
  "billing": {
    "amount": "<string>",
    "currency": "usd"
  },
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "elapsed_ms": 123
}

POST

run

bytedance

seedance-2.5

reference-to-video

Create Seedance 2.5 — Reference To Video

curl --request POST \
  --url https://api.apisale.ai/v1/run/bytedance/seedance-2.5/reference-to-video \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": {
    "prompt": "The person in @Image1 walks through a rain-soaked Tokyo side street, neon reflections on asphalt, smooth tracking, keep wardrobe and face consistent",
    "duration": "5",
    "resolution": "720p",
    "aspect_ratio": "auto",
    "bitrate_mode": "standard",
    "generate_audio": true,
    "image_urls": [
      "https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png"
    ]
  }
}
'

import requests

url = "https://api.apisale.ai/v1/run/bytedance/seedance-2.5/reference-to-video"

payload = { "input": {
        "prompt": "The person in @Image1 walks through a rain-soaked Tokyo side street, neon reflections on asphalt, smooth tracking, keep wardrobe and face consistent",
        "duration": "5",
        "resolution": "720p",
        "aspect_ratio": "auto",
        "bitrate_mode": "standard",
        "generate_audio": True,
        "image_urls": ["https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png"]
    } }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    input: {
      prompt: 'The person in @Image1 walks through a rain-soaked Tokyo side street, neon reflections on asphalt, smooth tracking, keep wardrobe and face consistent',
      duration: '5',
      resolution: '720p',
      aspect_ratio: 'auto',
      bitrate_mode: 'standard',
      generate_audio: true,
      image_urls: [
        'https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png'
      ]
    }
  })
};

fetch('https://api.apisale.ai/v1/run/bytedance/seedance-2.5/reference-to-video', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "run_id": "<string>",
  "endpoint": "<string>",
  "model": "<string>",
  "capability": "<string>",
  "mode": "<string>",
  "status": "queued",
  "created_at": "2023-11-07T05:31:56Z",
  "output": {},
  "error": {
    "type": "<string>",
    "code": 123,
    "message": "<string>"
  },
  "billing": {
    "amount": "<string>",
    "currency": "usd"
  },
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "elapsed_ms": 123
}

Overview

ByteDance Seedance 2.5 — unified multimodal reference-to-video; up to 30s, 480p–1080p, native audio. Optimized for reference to video via apisale.

Docs = API contract + Try it (snapshot). Explore = browser playground. Model page = product examples.

Endpoint

POST https://api.apisale.ai/v1/run/bytedance/seedance-2.5/reference-to-video


Model slug	`bytedance/seedance-2.5/reference-to-video`
Category	Reference to Video (`reference-to-video`)
Lab	Bytedance
Mode	async

Pricing

From $0.043/sec apisale price is 30% below the vendor’s official list price.

Tier	Unit	Official price	apisale price
480p without video input	second	$0.103	$0.072
720p without video input	second	$0.231	$0.162
1080p without video input	second	$0.569	$0.398
480p with video input, 0.6x	second	$0.061	$0.043
720p with video input, 0.6x	second	$0.138	$0.097
1080p with video input, 0.6x	second	$0.341	$0.239

Official price = vendor list price. apisale price = what you pay through apisale.

Request

{‌
  "input": {‌
    "prompt": "The person in @Image1 walks through a rain-soaked Tokyo side street, neon reflections on asphalt, smooth tracking, keep wardrobe and face consistent",
    "duration": "5",
    "resolution": "720p",
    "aspect_ratio": "auto",
    "bitrate_mode": "standard",
    "generate_audio": true,
    "image_urls": [
      "https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png"
    ]
  }
}

Parameters

Fields marked * are required. Use Authorization: Key YOUR_API_KEY for REST.

string

required

Text prompt; cite reference assets as @Image1, @Video1, @Audio1.

string

Duration in seconds (4-30), or auto to let the model decide. Default: auto Values: auto, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30

array

Reference audio (up to 10 tracks, each 1.8-30.2s, combined <= 30.2s, MP3/WAV; audio cannot be the only reference input).

array

Reference images (up to 30; total reference files across all modalities <= 50). JPG/PNG/WebP/BMP/TIFF/GIF/HEIC/HEIF, max 30MB each.

string

Default: 720p Values: 480p, 720p, 1080p

array

Reference videos (up to 10 clips, each 1.8-30.2s, combined <= 30.2s, MP4/MOV, max 200MB each).

string

Optional end-user identifier for abuse tracking.

string

Default: auto Values: auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16

string

high produces a higher-quality, larger-file encode. Default: standard Values: standard, high

boolean

Generate synchronized audio; cost is the same either way. Default: true

string

Optional HTTPS webhook when the run reaches a terminal state.

boolean

Block until completion (same Run response shape).

Input schema

{‌
  "params": {‌
    "prompt": {‌
      "type": "string",
      "required": true,
      "max_length": 2000,
      "description": "Text prompt; cite reference assets as @Image1, @Video1, @Audio1."
    },
    "duration": {‌
      "type": "enum",
      "values": [
        "auto",
        "4",
        "5",
        "6",
        "7",
        "8",
        "9",
        "10",
        "11",
        "12",
        "13",
        "14",
        "15",
        "16",
        "17",
        "18",
        "19",
        "20",
        "21",
        "22",
        "23",
        "24",
        "25",
        "26",
        "27",
        "28",
        "29",
        "30"
      ],
      "default": "auto",
      "description": "Duration in seconds (4-30), or auto to let the model decide."
    },
    "audio_urls": {‌
      "type": "array<media>",
      "max_items": 10,
      "description": "Reference audio (up to 10 tracks, each 1.8-30.2s, combined <= 30.2s, MP3/WAV; audio cannot be the only reference input)."
    },
    "image_urls": {‌
      "type": "array<media>",
      "max_items": 30,
      "description": "Reference images (up to 30; total reference files across all modalities <= 50). JPG/PNG/WebP/BMP/TIFF/GIF/HEIC/HEIF, max 30MB each."
    },
    "resolution": {‌
      "type": "enum",
      "values": [
        "480p",
        "720p",
        "1080p"
      ],
      "default": "720p"
    },
    "video_urls": {‌
      "type": "array<media>",
      "max_items": 10,
      "description": "Reference videos (up to 10 clips, each 1.8-30.2s, combined <= 30.2s, MP4/MOV, max 200MB each)."
    },
    "end_user_id": {‌
      "type": "string",
      "description": "Optional end-user identifier for abuse tracking."
    },
    "aspect_ratio": {‌
      "type": "enum",
      "values": [
        "auto",
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "default": "auto"
    },
    "bitrate_mode": {‌
      "type": "enum",
      "values": [
        "standard",
        "high"
      ],
      "default": "standard",
      "description": "high produces a higher-quality, larger-file encode."
    },
    "generate_audio": {‌
      "type": "bool",
      "default": true,
      "description": "Generate synchronized audio; cost is the same either way."
    }
  }
}

Submit response

Returns a Run with run_id. Poll with GET /v1/runs/{run_id} or use Try it above.

string

required

Unique run ID — save for polling and webhooks.

string

required

queued (async) or terminal state for sync runs.

object

Result when status is succeeded — see Output schema below.

Example (async submit)

{
  "run_id": "run_550e8400-e29b-41d4-a716-446655440000",
  "endpoint": "bytedance/seedance-2.5/reference-to-video",
  "model": "reference-to-video",
  "capability": "video",
  "mode": "reference-to-video",
  "status": "queued",
  "output": null,
  "error": null,
  "billing": null,
  "created_at": "2026-06-27T12:00:00.000Z",
  "started_at": null,
  "completed_at": null,
  "elapsed_ms": null
}

Full lifecycle: Runs lifecycle.

Output

When status is succeeded, output follows this schema:

Output schema

{‌
  "type": "object",
  "example": {‌
    "videos": [
      {‌
        "url": "https://example.com/out.mp4",
        "content_type": "video/mp4"
      }
    ]
  },
  "required": [
    "videos"
  ],
  "properties": {‌
    "videos": {‌
      "type": "array",
      "items": {‌
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {‌
          "url": {‌
            "type": "string"
          },
          "file_name": {‌
            "type": "string"
          },
          "content_type": {‌
            "type": "string"
          }
        }
      }
    }
  },
  "description": "Succeeded task output: single video URL."
}

Example

curl -X POST "https://api.apisale.ai/v1/run/bytedance/seedance-2.5/reference-to-video" \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "The person in @Image1 walks through a rain-soaked Tokyo side street, neon reflections on asphalt, smooth tracking, keep wardrobe and face consistent",
    "duration": "5",
    "resolution": "720p",
    "aspect_ratio": "auto",
    "bitrate_mode": "standard",
    "generate_audio": true,
    "image_urls": [
      "https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png"
    ]
  }
}'

Authorizations

Authorization

string

header

required

Key sk-... (native REST) or Bearer sk-... (vendor SDKs)

Body

application/json

input

object

required

Show child attributes

Example:

{
  "prompt": "The person in @Image1 walks through a rain-soaked Tokyo side street, neon reflections on asphalt, smooth tracking, keep wardrobe and face consistent",
  "duration": "5",
  "resolution": "720p",
  "aspect_ratio": "auto",
  "bitrate_mode": "standard",
  "generate_audio": true,
  "image_urls": [
    "https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png"
  ]
}

webhook_url

string<uri>

sync

boolean

default:false

Response

201 - application/json

Run accepted

run_id

string

required

Unique run identifier

endpoint

string

required

Model slug

model

string

required

capability

string

required

mode

string

required

status

enum<string>

required

Available options:

queued,

processing,

succeeded,

failed,

timeout,

cancelled

created_at

string<date-time>

required

output

object | null

error

object | null

Show child attributes

billing

object | null

Show child attributes

started_at

string<date-time> | null

completed_at

string<date-time> | null

elapsed_ms

number | null

Get Started

Overview

Image

Video

Audio

Model APIs

Official SDK compatibility

Platform API Reference

Seedance 2.5 — Reference To Video

Overview

Endpoint

Pricing

Request

Parameters

Submit response

Example (async submit)

Output

Example

Authorizations

Body

Response

​Overview

​Endpoint

​Pricing

​Request

​Parameters

​Submit response

​Example (async submit)

​Output

​Example

​Related

Authorizations

Body

Response

Overview

Endpoint

Pricing

Request

Parameters

Submit response

Example (async submit)

Output

Example

Related