> ## 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 参考视频生成是官方满血折扣路由，使用参考图、参考视频或参考音频约束主体、运动、视觉风格与声音。Seedance 系列强调提示词遵循、连贯运动、多镜头叙事和音画同步。该系列为满血版：媒体 URL 会先经素材服务送审再提交任务，因此直接使用公网 URL 也可以。
必须至少提供一种参考素材；图片、视频和音频的数量上限以 API 参数定义为准。
## OpenAPI
````yaml api-reference/openapi/seedance--2-5-reference-to-video.zh.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 参考视频生成是官方满血折扣路由，使用参考图、参考视频或参考音频约束主体、 运动、视觉风格与声音。Seedance
系列强调提示词遵循、连贯运动、多镜头叙事和音画同步。在 APIPod 中，公开模型 ID 为 seedance-2.5-r2v，支持最多 30
张参考图、10 个参考视频和 10 段参考音频，时长最长 30 秒，并通过异步视频任务返回结果。该系列为满血版：媒体 URL
会先经素材服务送审再提交任务，因此直接使用公网 URL 也可以。
servers:
- url: https://api.apipod.ai
description: 生产环境
security: []
paths:
/v1/videos/generations:
post:
tags:
- Seedance 2.5 Reference to Video
summary: 创建生成任务
description: >-
Seedance 2.5 参考视频生成是官方满血折扣路由，使用参考图、参考视频或参考音频约束主体、 运动、视觉风格与声音。Seedance
系列强调提示词遵循、连贯运动、多镜头叙事和音画同步。在 APIPod 中，公开模型 ID 为 seedance-2.5-r2v，支持最多 30
张参考图、10 个参考视频和 10 段参考音频，时长最长 30 秒，并通过异步视频任务返回结果。该系列为满血版：媒体 URL
会先经素材服务送审再提交任务，因此直接使用公网 URL 也可以。
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: APIPod 公开模型 ID。
const: seedance-2.5-r2v
prompt:
type: string
title: Prompt
description: 生成或编辑指令。中文建议不超过 500 字，英文建议不超过 1000 词。
maxLength: 1000
image_urls:
type: array
title: Image Urls
description: 参考图 URL。最多支持 30 张；单张图片小于 30 MB。
maxItems: 30
items:
type: string
video_urls:
type: array
title: Video Urls
description: 参考视频 URL。最多支持 10 个；单个视频时长 2-30 秒，所有视频总时长不超过 30 秒。
maxItems: 10
items:
type: string
audio_urls:
type: array
title: Audio Urls
description: >-
参考音频 URL。最多支持 10 段；单个音频时长 2-30 秒，所有音频总时长不超过 30
秒。注意音频不能单独上传，需至少包含一个参考图或参考视频。
maxItems: 10
items:
type: string
duration:
type: integer
title: Duration
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
description: 视频时长，单位为秒。 最小值：4。 最大值：30。
resolution:
type: string
title: Resolution
description: 输出分辨率档位。
enum:
- 480p
- 720p
default: 720p
aspect_ratio:
type: string
title: Aspect Ratio
description: 输出宽高比。
enum:
- adaptive
- '16:9'
- '4:3'
- '1:1'
- '3:4'
- '9:16'
- '21:9'
default: adaptive
generate_audio:
type: boolean
title: Generate Audio
description: 为视频生成同步音频。
default: true
return_last_frame:
type: boolean
title: Retrun Last Frame
description: 返回生成视频的尾帧，用于续作工作流。
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: 任务已受理
content:
application/json:
schema:
type: object
title: Task Submit Response
description: Standard response for task submission
properties:
code:
type: integer
description: HTTP 状态码。
data:
type: object
title: Task Submit Data
description: 响应数据。
properties:
task_id:
type: string
description: 用于查询任务状态的 APIPod 任务 ID。
message:
type: string
description: 响应消息。
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: 使用你的 APIPod API Key 作为 Authorization 请求头中的 Bearer token。
````