doubao-seedance-2.5 视频生成

• 异步处理，返回 task_id 用于查询
• 文生视频 / 多模态参考 / 视频编辑 / 视频延长 / 首尾帧
• 单次最长 30 秒；参考素材最多 30 图 + 10 视频 + 10 音频
• 分辨率仅 480p / 720p；支持 mp4 / mov 输出

请求示例

bash curl --request POST \ --url https://api.openveer.com/v1/videos/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "doubao-seedance-2.5", "prompt": "一段极具电影感的30秒蒸汽朋克微缩景观序列", "size": "16:9", "resolution": "720p", "duration": 30 }'

```python
import requests

url = "https://api.openveer.com/v1/videos/generations"

payload = {
"model": "doubao-seedance-2.5",
"prompt": "一段极具电影感的30秒蒸汽朋克微缩景观序列",
"size": "16:9",
"resolution": "720p",
"duration": 30,
}

headers = {
"Authorization": "Bearer ",
"Content-Type": "application/json",
}

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

print(response.json())
```

```javascript
const url = "https://api.openveer.com/v1/videos/generations";

const payload = {
model: "doubao-seedance-2.5",
prompt: "一段极具电影感的30秒蒸汽朋克微缩景观序列",
size: "16:9",
resolution: "720p",
duration: 30,
};

const headers = {
Authorization: "Bearer ",
"Content-Type": "application/json",
};

fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(payload),
})
.then((response) => response.json())
.then((data) => console.log(data))
.catch((error) => console.error("Error:", error));
```

```go
package main

import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)

func main() {
url := "https://api.openveer.com/v1/videos/generations"

  payload := map[string]interface{}{
      "model":      "doubao-seedance-2.5",
      "prompt":     "一段极具电影感的30秒蒸汽朋克微缩景观序列",
      "size":       "16:9",
      "resolution": "720p",
      "duration":   30,
  }

  jsonData, _ := json.Marshal(payload)

  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Set("Authorization", "Bearer <token>")
  req.Header.Set("Content-Type", "application/json")

  client := &http.Client{}
  resp, err := client.Do(req)
  if err != nil {
      panic(err)
  }
  defer resp.Body.Close()

  body, _ := ioutil.ReadAll(resp.Body)
  fmt.Println(string(body))

}
```

```java
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
public static void main(String[] args) throws Exception {
String url = "https://api.openveer.com/v1/videos/generations";

      String payload = """
      {
        "model": "doubao-seedance-2.5",
        "prompt": "一段极具电影感的30秒蒸汽朋克微缩景观序列",
        "size": "16:9",
        "resolution": "720p",
        "duration": 30
      }
      """;

      HttpClient client = HttpClient.newHttpClient();
      HttpRequest request = HttpRequest.newBuilder()
          .uri(URI.create(url))
          .header("Authorization", "Bearer <token>")
          .header("Content-Type", "application/json")
          .POST(HttpRequest.BodyPublishers.ofString(payload))
          .build();

      HttpResponse<String> response = client.send(request,
          HttpResponse.BodyHandlers.ofString());

      System.out.println(response.body());
  }

}
```

```php
"doubao-seedance-2.5", "prompt" => "一段极具电影感的30秒蒸汽朋克微缩景观序列", "size" => "16:9", "resolution" => "720p", "duration" => 30 ]; $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload)); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Authorization: Bearer ", "Content-Type: application/json" ]); $response = curl_exec($ch); curl_close($ch); echo $response; ?>

```

响应示例

json { "code": 200, "data": [ { "status": "submitted", "task_id": "task_01KMCGF6BQGN3X28H3KSR50X5T" } ] }

json { "error": { "code": 400, "message": "请求参数无效", "type": "invalid_request_error" } }

json { "error": { "code": 401, "message": "身份验证失败，请检查您的API密钥", "type": "authentication_error" } }

json { "error": { "code": 402, "message": "账户余额不足，请充值后再试", "type": "payment_required" } }

json { "error": { "code": 429, "message": "请求过于频繁，请稍后再试", "type": "rate_limit_error" } }

json { "error": { "code": 500, "message": "服务器内部错误，请稍后重试", "type": "server_error" } }

认证

请求参数

示例：

json [ {"url": "https://example.com/first.jpg", "role": "first_frame"}, {"url": "https://example.com/last.jpg", "role": "last_frame"} ]

素材要求

参考视频规格

• 传入方式：视频 URL、素材 ID（asset://...）
• 视频格式：mp4、mov，支持编码格式见下表
• 分辨率：480p，720p
• 时长：单个视频时长 [2, 30] s；最多传入 10 个参考视频；所有视频总时长不超过 30s
• 单个视频尺寸：
• 宽高比（宽/高）：[0.4, 2.5]
• 宽高长度（px）：[300, 6000]
• 总像素数：[640×640=409600, 3326×2494=8295044]，即宽和高的乘积须落在 [409600, 8295044]
• 大小：单个视频不超过 200 MB
• 帧率 (FPS)：[24, 60]

支持编码格式

任务类型与限制

系统会按参考素材与提示词意图判定任务类型。后三种对 size / duration 有硬性限制，违反会在任务开始后异步失败（如 InvalidParameter.TaskTypeConstraint）：

素材库使用说明

参考素材可直接传公网 URL，也可先入素材库、再用 asset:// 引用。推荐入库的场景：

1. 真人人脸素材必须走素材库——直接传 URL 会被内容审核拦截，入库审核通过后才可用
2. 素材会复用多次——入库一次，之后每次生成免重复审核，提交更快
3. URL 是带签名的临时链接——入库时平台会把素材固化，之后引用不依赖原始 URL 是否仍有效
4. 入库素材会自动同步到全部可用渠道，多渠道路由时无论落到哪个渠道都能直接用

素材库与 2.0 家族共用；审核通过后的 asset:// 可在 2.0 / 2.5 生成请求中通用。完整提交接口字段亦可参见 虚拟人像素材。

上传素材

POST /v1/seedance2/private-avatar/assets
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

curl --request POST \
  --url https://api.openveer.com/v1/seedance2/private-avatar/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2.5",
    "group": { "name": "my-assets" },
    "asset_type": "Image",
    "assets": [
      { "url": "https://example.com/a.png", "name": "a" },
      { "url": "https://example.com/b.png", "name": "b" }
    ]
  }'

响应返回本地任务 id，用 获取任务状态（GET /v1/tasks/{id}）轮询审核结果；审核通过后从素材列表接口拿到 asset:// 形式的素材 ID。

素材限制（提交时同步校验）

违规立即返回 400（标明第几个素材、违反哪条限制），不提交审核、不占审核额度：

报错示例：

{
  "error": {
    "code": "invalid_asset_material",
    "message": "video #1: duration must be between 2s and 15s for doubao-seedance-2.0 (got 30s)"
  }
}

在生成请求中使用

审核通过的素材在 image_urls / image_with_roles / video_urls / audio_urls 中以 asset:// 引用：

{
  "model": "doubao-seedance-2.5",
  "prompt": "@图片1 的人物在海边行走",
  "image_urls": ["asset://cm9xxxxxxxx"],
  "duration": 8
}

多渠道说明：素材入库后自动同步全部可用渠道；生成请求无论路由到哪个渠道都可直接引用。若某渠道的同步副本缺失，平台会用原始 URL 现场补传兜底（原始 URL 已过期则该渠道跳过、换渠道承接）。

管理接口速查

素材接口免计费（仅 Token 鉴权与限流），不产生消费记录。

常见问题

Q: 审核要多久？\
图片通常数秒；视频与真人素材可能数分钟。轮询任务 id 到终态即可。

Q: 审核失败但看不出原因？\
部分失败不返回具体原因（常见为素材抓取瞬时失败），平台已自动重试一次；仍失败请更换素材 URL（确认公网可直接下载）重新提交。

Q: 同一素材给 2.0 和 2.5 都用，要传两次吗？\
不用。入库一次即可，asset:// 对两代通用；跨渠道 / 跨模型的同步由平台自动完成。

Q: 能直接传真人素材 URL 吗？\
真人素材必须先入素材库审核。

计费

• 按 秒 × 分辨率档 计费。
• 有参考视频输入时：计费秒数 = 输入视频总时长（≤30s）+ 输出时长，走带输入参考的优惠档单价。
• duration = -1（自动时长）：提交时按上限 30 秒预扣，完成后按实际产出多退少补。
• 未传 duration：按 5 秒生成与计费。
• 任务失败或内容审核拦截：全额退款（仅成功出片收费）。

请求示例

文生视频（30 秒）

{
  "model": "doubao-seedance-2.5",
  "prompt": "一段极具电影感的30秒蒸汽朋克微缩景观序列",
  "size": "16:9",
  "resolution": "720p",
  "duration": 30
}

多模态参考（图 + 视频 + 音频）

{
  "model": "doubao-seedance-2.5",
  "prompt": "全程使用@视频1的第一视角构图，@音频1作为背景音乐，首帧为@图片1",
  "image_urls": [
    "https://example.com/pic1.jpg",
    "https://example.com/pic2.jpg"
  ],
  "video_urls": ["https://example.com/ref.mp4"],
  "audio_urls": ["https://example.com/bgm.mp3"],
  "size": "16:9",
  "duration": 11
}

视频编辑

{
  "model": "doubao-seedance-2.5",
  "prompt": "编辑视频：删除 @视频1 中的所有路人，只保留主角",
  "video_urls": ["https://example.com/input.mp4"],
  "size": "adaptive",
  "duration": -1,
  "output_format": "mov"
}

首尾帧生视频

{
  "model": "doubao-seedance-2.5",
  "prompt": "图中女孩对着镜头说\"茄子\"，360度环绕运镜",
  "image_with_roles": [
    {"url": "https://example.com/first.jpg", "role": "first_frame"},
    {"url": "https://example.com/last.jpg", "role": "last_frame"}
  ],
  "size": "adaptive",
  "duration": 5
}

私域素材

{
  "model": "doubao-seedance-2.5",
  "prompt": "人物在城市街道自然行走，阳光明媚",
  "image_urls": ["asset://cm9xxxxxxxx"],
  "duration": 5,
  "resolution": "720p"
}

联网搜索

{
  "model": "doubao-seedance-2.5",
  "prompt": "根据最新资讯生成一段科技新闻短视频开场",
  "size": "16:9",
  "resolution": "720p",
  "duration": 8,
  "tools": [{"type": "web_search"}]
}

常见错误

响应（提交）

查询完成态（GET /v1/tasks/{task_id}）

提交后使用 获取任务状态 轮询。当 status 为 completed 时，结构如下。

完成态响应示例

{
  "code": 200,
  "data": {
    "id": "task_01KZEWTMH6TG3Z1X2QRP2B9ZG9",
    "status": "completed",
    "progress": 100,
    "created": 1786132648,
    "completed": 1786132748,
    "actual_time": 100,
    "estimated_time": 300,
    "cost": 0.3104,
    "credits_cost": 3.104,
    "usage": {
      "completion_tokens": 38800
    },
    "result": {
      "videos": [
        {
          "url": [
            "https://cdn.example.com/video/…-video_task_01KZEWTMH6TG3Z1X2QRP2B9ZG9.mp4"
          ],
          "expires_at": 1786219148
        }
      ]
    }
  }
}

完成态字段

备注

• 失败任务（status=failed）：cost 恒为 0（预扣已全额退款），错误原因在 data.error.message
• usage 在完成后的最初几秒可能尚未出现（结算落库有秒级延迟），再查一次即可

与 2.0 的差异