Seedance 2.5
curl --request POST \
--url https://api.tensorslab.com/v1/video/contents/generations/tasksimport requests
url = "https://api.tensorslab.com/v1/video/contents/generations/tasks"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.tensorslab.com/v1/video/contents/generations/tasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tensorslab.com/v1/video/contents/generations/tasks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tensorslab.com/v1/video/contents/generations/tasks"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tensorslab.com/v1/video/contents/generations/tasks")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tensorslab.com/v1/video/contents/generations/tasks")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body视频生成
Seedance 2.5
使用字节官方模型 ID 和 content[] JSON 创建 Seedance 2.5 视频任务
Seedance 2.5
curl --request POST \
--url https://api.tensorslab.com/v1/video/contents/generations/tasksimport requests
url = "https://api.tensorslab.com/v1/video/contents/generations/tasks"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.tensorslab.com/v1/video/contents/generations/tasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tensorslab.com/v1/video/contents/generations/tasks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tensorslab.com/v1/video/contents/generations/tasks"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tensorslab.com/v1/video/contents/generations/tasks")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tensorslab.com/v1/video/contents/generations/tasks")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body
使用字节官方模型 ID
成功返回 HTTP 200:
保存返回的
请求体上限为 64 MiB。布尔参数请使用 JSON 的
素材可使用公网 HTTP(S) URL 或当前账号的
“试一试”默认提供一条文本和一条图片。通过
成功响应示例(可选元数据以实际返回为准):
只可查询当前账号创建的任务。主视频地址为平台转存地址;启用并成功返回尾帧时读取
设置环境变量
dreamina-seedance-2-5-260628。沿用官方 JSON 请求结构,替换视频基础 URL 和 API Key 即可接入 TensorAI;资产管理的 URL、AK/SK 替换方式见 迁移配置。
点击“试一试”创建任务;成功后可点击“查询任务”,自动带入任务 ID 和 API Key。已有任务可使用 查询视频任务 查看状态和结果。
创建任务
curl -X POST "https://api.tensorslab.com/v1/video/contents/generations/tasks" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "dreamina-seedance-2-5-260628",
"content": [{"type": "text", "text": "一只纸船漂过平静的湖面,镜头缓慢推进"}],
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"generate_audio": true,
"watermark": false
}'
{"id":"task_example"}
id,用于查询任务状态和视频结果。
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
model | string,必填 | 字节官方 ID dreamina-seedance-2-5-260628 |
content | object[],必填 | 按官方格式传入文本、图片、音频、视频等内容 |
duration | integer | 秒数,4–30 或 -1(自动选择);省略时由模型决定 |
resolution | string | 480p、720p、1080p,具体组合受模型约束 |
ratio | string | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 |
generate_audio、watermark、return_last_frame | boolean | 音画同步、水印、返回尾帧,按模型能力处理 |
seed | integer | -1–2147483647,受模型能力限制 |
frames | integer | 29–289 且为 25+4n;优先于 duration,受模型能力限制 |
execution_expires_after | integer | 执行有效期(秒),3600–259200 |
priority | integer | 执行优先级 0–9 |
safety_identifier、callback_url、service_tier | string | 安全标识、回调地址、服务等级,原样转发 |
draft、camera_fixed | boolean | 样片模式、固定镜头,受模型能力限制 |
tools | object[] | 工具列表;当前最多一个 {"type":"web_search"},是否可用取决于模型 |
output_format | string | mp4 或 mov |
omni_reference_task_type | string | auto、reference、edit、extend |
true / false;可选参数未传时由模型决定,传入值须符合字段及模型要求。
2.5 参数组合
首帧 / 首尾帧任务,以及edit / extend 任务需使用 ratio=adaptive。编辑和延长需提供 reference_video;编辑时若指定 duration,须为 -1。
支持 {"type":"draft_task","draft_task":{"id":"<DRAFT_TASK_ID>"}} 引用同账号已成功的 2.5 样片任务;请使用与样片相同的模型。正式成片参数还需满足实际模型对分辨率等字段的要求。
素材与 content
| 类型 | 内容字段 | role |
|---|---|---|
| 文本 | text | 不需要 |
| 图片 | image_url.url | first_frame、last_frame、reference_image;可省略,按官方首帧语义处理 |
| 音频 | audio_url.url | reference_audio |
| 视频 | video_url.url | reference_video |
asset://<ASSET_ID>。图片、音频还支持 Base64 Data URL(解码后分别最多 30 MiB、15 MiB);视频暂不支持内联 Base64。公网 URL 不能指向本地或私网地址。
例如,把创建请求中的 content 替换为参考图输入:
[
{"type":"text","text":"保持参考角色的外观,让角色在雨中漫步"},
{"type":"image_url","image_url":{"url":"asset://<ASSET_ID>"},"role":"reference_image"}
]
type 选择素材类型,填写对应字段;其他素材可点击“添加项目”继续添加,也可删除不需要的项目。
已有资产引用会校验归属和状态。手动管理资产的创建、查询与活体校验见 资产管理。
查询结果
试一试:查询视频任务。Seedance 2.0、2.5 共用同一查询接口。curl "https://api.tensorslab.com/v1/video/contents/generations/tasks/<TASK_ID>" \
-H "Authorization: Bearer <YOUR_API_KEY>"
status | 含义 |
|---|---|
queued | 已排队 |
running | 正在处理(包括结果转存) |
succeeded | 成功,读取 content.video_url |
failed、cancelled、expired | 终态,查看 error.code / error.message |
{
"id":"task_example",
"model":"dreamina-seedance-2-5-260628",
"status":"succeeded",
"content":{"video_url":"https://example.com/output.mp4","last_frame_url":"","file_url":""},
"usage":{"prompt_tokens":0,"completion_tokens":1000,"total_tokens":1000},
"resolution":"720p","ratio":"16:9","duration":5,"framespersecond":24,
"created_at":1794787200,"updated_at":1794787260
}
content.last_frame_url。自动时长场景读取查询结果的实际 duration。
官方 Python SDK 接入
以下示例使用官方volcenginesdkarkruntime SDK。SDK 安装说明见 官方文档。
pip install 'volcengine-python-sdk[ark]'
PLATFORM_API_KEY 为 TensorAI API Key:
import os
import time
from volcenginesdkarkruntime import Ark
client = Ark(api_key=os.environ["PLATFORM_API_KEY"],
base_url="https://api.tensorslab.com/v1/video")
task = client.content_generation.tasks.create(
model="dreamina-seedance-2-5-260628",
content=[{"type":"text","text":"A paper boat floating on a quiet lake"}],
duration=5, resolution="720p", ratio="16:9",
)
for _ in range(240):
result = client.content_generation.tasks.get(task_id=task.id)
if result.status == "succeeded":
print(result.content.video_url)
break
if result.status in {"failed", "cancelled", "expired"}:
raise RuntimeError(result.error)
time.sleep(5)
else:
raise TimeoutError("Retain task.id and query again later")