> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apipod.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedance 2.5 Reference to Video
> Seedance 2.5 Reference to Video is the official full-capability discount route that uses reference images, video, or audio to guide subjects, motion, visual style, and sound. The Seedance family emphasizes prompt following, coherent motion, multi-shot storytelling, and synchronized audio. This is a full-capability variant where media URLs are reviewed by the asset service before the task is submitted, so plain public URLs still work in requests.
Provide at least one reference asset. The per-media limits are defined by the API schema.
## OpenAPI
````yaml api-reference/openapi/seedance--2-5-reference-to-video.yaml POST /v1/videos/generations
openapi: 3.1.0
info:
title: Seedance 2.5 Reference to Video API
version: 1.0.0
description: >-
Seedance 2.5 Reference to Video is the official full-capability discount
route that uses reference images, video, or audio to guide subjects, motion,
visual style, and sound. The Seedance family emphasizes prompt following,
coherent motion, multi-shot storytelling, and synchronized audio. In APIPod,
the public model ID is seedance-2.5-r2v. It accepts up to 30 reference
images, 10 reference videos, and 10 reference audios, with durations up to
30 seconds, and returns results through asynchronous video tasks. This is a
full-capability variant where media URLs are reviewed by the asset service
before the task is submitted, so plain public URLs still work in requests.
servers:
- url: https://api.apipod.ai
description: Production
security: []
paths:
/v1/videos/generations:
post:
tags:
- Seedance 2.5 Reference to Video
summary: Create Generation Task
description: >-
Seedance 2.5 Reference to Video is the official full-capability discount
route that uses reference images, video, or audio to guide subjects,
motion, visual style, and sound. The Seedance family emphasizes prompt
following, coherent motion, multi-shot storytelling, and synchronized
audio. In APIPod, the public model ID is seedance-2.5-r2v. It accepts up
to 30 reference images, 10 reference videos, and 10 reference audios,
with durations up to 30 seconds, and returns results through
asynchronous video tasks. This is a full-capability variant where media
URLs are reviewed by the asset service before the task is submitted, so
plain public URLs still work in requests.
operationId: create-seedance-2-5-reference-to-video
requestBody:
required: true
content:
application/json:
schema:
type: object
title: Seedance 2.5 Reference to Video
properties:
model:
type: string
title: Model ID
description: Public APIPod model ID.
const: seedance-2.5-r2v
prompt:
type: string
title: Prompt
description: >-
The generation videos prompt. Up to 500 Chinese characters
or 1000 English words.
maxLength: 1000
image_urls:
type: array
title: Image Urls
description: >-
Reference image URLs. Up to 30 images are supported; each
image must be smaller than 30 MB.
maxItems: 30
items:
type: string
video_urls:
type: array
title: Video Urls
description: >-
Reference video URLs. Up to 10 videos are supported; each
video lasts 2-30 seconds and the total duration of all
videos must not exceed 30 seconds.
maxItems: 10
items:
type: string
audio_urls:
type: array
title: Audio Urls
description: >-
Reference audio URLs. Up to 10 audios are supported; each
audio lasts 2-30 seconds and the total duration of all
audios must not exceed 30 seconds. Please note that audio
files cannot be uploaded alone; at least one reference video
or image must be included.
maxItems: 10
items:
type: string
duration:
type: integer
title: Duration
description: Video duration in seconds, from 4 to 30.
enum:
- 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: 4
minimum: 4
maximum: 30
resolution:
type: string
title: Resolution
description: Generate video resolution.
enum:
- 480p
- 720p
default: 720p
aspect_ratio:
type: string
title: Aspect Ratio
description: >-
Aspect ratio of the generated video,When the ratio is
configured as adaptive, the model will automatically adapt
the aspect ratio according to the generation scenario.
enum:
- adaptive
- '16:9'
- '4:3'
- '1:1'
- '3:4'
- '9:16'
- '21:9'
default: adaptive
generate_audio:
type: boolean
title: Generate Audio
description: >-
Controls whether the generated video contains audio
synchronized with the visuals.
default: true
return_last_frame:
type: boolean
title: Retrun Last Frame
description: >-
Whether to return the last frame image of the generated
video. Using this parameter enables the generation of
multiple consecutive videos: taking the last frame of the
previous generated video as the first frame of the next
video task to quickly generate multiple consecutive videos,
and the first item in the returned result is this image.
default: false
required:
- model
- prompt
example:
model: seedance-2.5-r2v
prompt: >-
Keep the character and voice, cinematic product shot with
natural lighting.
image_urls:
- https://example.com/reference.png
video_urls:
- https://example.com/reference.mp4
audio_urls:
- https://example.com/voice.mp3
duration: 4
resolution: 720p
aspect_ratio: adaptive
generate_audio: true
responses:
'200':
description: Task accepted
content:
application/json:
schema:
type: object
title: Task Submit Response
description: Standard response for task submission
properties:
code:
type: integer
data:
type: object
title: Task Submit Data
description: Data content for task submission
properties:
task_id:
type: string
description: generatation task id
message:
type: string
required:
- code
- message
- data
example:
code: 200
message: success
data:
task_id: vid_task_01JEXAMPLE
security:
- bearerAuth: []
x-codeSamples:
- lang: Shell
label: cURL
source: |-
curl https://api.apipod.ai/v1/videos/generations \
-H "Authorization: Bearer $APIPOD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-r2v",
"prompt": "Keep the character and voice, cinematic product shot with natural lighting.",
"image_urls": ["https://example.com/reference.png"],
"video_urls": ["https://example.com/reference.mp4"],
"audio_urls": ["https://example.com/voice.mp3"],
"duration": 4,
"resolution": "720p",
"aspect_ratio": "adaptive",
"generate_audio": true
}'
- lang: Python
label: Python
source: |-
import os
import requests
payload = {
"model": "seedance-2.5-r2v",
"prompt": "Keep the character and voice, cinematic product shot with natural lighting.",
"image_urls": ["https://example.com/reference.png"],
"video_urls": ["https://example.com/reference.mp4"],
"audio_urls": ["https://example.com/voice.mp3"],
"duration": 4,
"resolution": "720p",
"aspect_ratio": "adaptive",
"generate_audio": True
}
response = requests.post(
"https://api.apipod.ai/v1/videos/generations",
headers={
"Authorization": f"Bearer {os.environ['APIPOD_API_KEY']}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
- lang: Go
label: Go
source: |-
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"os"
)
func main() {
payload := map[string]any{}
if err := json.Unmarshal([]byte(`{
"model": "seedance-2.5-r2v",
"prompt": "Keep the character and voice, cinematic product shot with natural lighting.",
"image_urls": ["https://example.com/reference.png"],
"video_urls": ["https://example.com/reference.mp4"],
"audio_urls": ["https://example.com/voice.mp3"],
"duration": 4,
"resolution": "720p",
"aspect_ratio": "adaptive",
"generate_audio": true
}`), &payload); err != nil {
panic(err)
}
body, err := json.Marshal(payload)
if err != nil {
panic(err)
}
req, err := http.NewRequest(http.MethodPost, "https://api.apipod.ai/v1/videos/generations", bytes.NewReader(body))
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("APIPOD_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println(resp.Status)
}
- lang: Rust
label: Rust
source: |-
use reqwest::Client;
use serde_json::json;
use std::env;
#[tokio::main]
async fn main() -> Result<(), Box> {
let payload = json!({
"model": "seedance-2.5-r2v",
"prompt": "Keep the character and voice, cinematic product shot with natural lighting.",
"image_urls": ["https://example.com/reference.png"],
"video_urls": ["https://example.com/reference.mp4"],
"audio_urls": ["https://example.com/voice.mp3"],
"duration": 4,
"resolution": "720p",
"aspect_ratio": "adaptive",
"generate_audio": true
});
let response = Client::new()
.post("https://api.apipod.ai/v1/videos/generations")
.bearer_auth(env::var("APIPOD_API_KEY")?)
.json(&payload)
.send()
.await?
.error_for_status()?;
println!("{}", response.text().await?);
Ok(())
}
- lang: JavaScript
label: JavaScript
source: >-
const response = await
fetch("https://api.apipod.ai/v1/videos/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.APIPOD_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify(
{
"model": "seedance-2.5-r2v",
"prompt": "Keep the character and voice, cinematic product shot with natural lighting.",
"image_urls": ["https://example.com/reference.png"],
"video_urls": ["https://example.com/reference.mp4"],
"audio_urls": ["https://example.com/voice.mp3"],
"duration": 4,
"resolution": "720p",
"aspect_ratio": "adaptive",
"generate_audio": true
}
),
});
if (!response.ok) {
throw new Error(`APIPod request failed: ${response.status} ${await response.text()}`);
}
console.log(await response.json());
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: APIPod API key
description: Use your APIPod API key as a Bearer token in the Authorization header.
````