Compare commits
2 Commits
2281c64ee8
...
624e12ae46
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
624e12ae46 | ||
|
|
dafdc8983f |
@ -15,6 +15,7 @@ ERROR_MESSAGES = {
|
||||
'InputAudioSensitiveContentDetected': '参考音频包含敏感内容,请更换音频后重试',
|
||||
# Output content moderation
|
||||
'OutputVideoSensitiveContentDetected': '生成的视频包含敏感内容,已被系统拦截,请修改提示词后重试',
|
||||
'OutputVideoSensitiveContentDetected.PolicyViolation': '生成的视频涉及版权限制内容(如知名IP、名人肖像等),已被系统拦截,请修改提示词后重试',
|
||||
'OutputImageSensitiveContentDetected': '生成的图片包含敏感内容,已被系统拦截',
|
||||
# Parameter errors
|
||||
'InvalidParameter': '请求参数无效,请检查输入内容',
|
||||
|
||||
85
docs/API文档/Seedance 2.0 1080P.md
Normal file
85
docs/API文档/Seedance 2.0 1080P.md
Normal file
@ -0,0 +1,85 @@
|
||||
# [请填写客户名称]Seedance 2.0 1080P
|
||||
|
||||
> 本文档仅供方舟保底客户查阅,请勿发给没有签约保底的客户
|
||||
|
||||
### 功能说明
|
||||
|
||||
⚠️❗️❗️:目前seedance2.0产出的1080p暂时无法支持产物受信功能,即seedance2.0产出的含有人脸的1080p视频将接受安全审查,如果您需要参考含有人脸的1080p视频,请您将该视频上传至虚拟素材库
|
||||
|
||||
#### **功能1 输出视频分辨率 支持 1080P**
|
||||
|
||||
* **上线时间**:预计国内外4月16日22:00完成上线
|
||||
|
||||
* **用户范围**:
|
||||
|
||||
* **“抢先体验计划”:功能上线后 72 小时内,部分用户可抢先体验**,官网文档暂不更新
|
||||
|
||||
* 72 小时后,面向全部用户开放,官网文档同步公开
|
||||
|
||||
* **支持模型**:仅限Seedance 2.0(Seedance 2.0 fast 不支持)
|
||||
|
||||
* **使用方式:**在请求参数`resolution`中传入`1080p`
|
||||
|
||||
```c++
|
||||
curl https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "Authorization: Bearer $ARK_API_KEY" \
|
||||
-d '{
|
||||
"model": "doubao-seedance-2-0-260128",
|
||||
"content": [
|
||||
{
|
||||
"type": "text",
|
||||
"text": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4 秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6 秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8 秒:第一人称手持举杯,你将图片2中的果茶举到镜头前(模拟递到观众面前的视角),杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片2。背景声音统一为女生音色。"
|
||||
},
|
||||
{
|
||||
"type": "image_url",
|
||||
"image_url": {
|
||||
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
|
||||
},
|
||||
"role": "reference_image"
|
||||
},
|
||||
{
|
||||
"type": "image_url",
|
||||
"image_url": {
|
||||
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
|
||||
},
|
||||
"role": "reference_image"
|
||||
},
|
||||
{
|
||||
"type": "video_url",
|
||||
"video_url": {
|
||||
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
|
||||
},
|
||||
"role": "reference_video"
|
||||
},
|
||||
{
|
||||
"type": "audio_url",
|
||||
"audio_url": {
|
||||
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
|
||||
},
|
||||
"role": "reference_audio"
|
||||
}
|
||||
],
|
||||
"resolution": "1080p",
|
||||
"generate_audio":true,
|
||||
"ratio": "16:9",
|
||||
"duration": 11,
|
||||
"watermark": false
|
||||
}'
|
||||
```
|
||||
|
||||
#### **功能2 输入视频分辨率 支持 1080P**
|
||||
|
||||
* **功能说明**:对输入视频的总像素限制扩大至 2086876(2206x946),支持传入1080P视频作为参考
|
||||
|
||||
* **上线时间**:预计国内外4月16日 22:00 完成上线
|
||||
|
||||
* **用户范围**:全部用户可用,官网文档同步公开
|
||||
|
||||
* **支持模型**:Seedance 2.0、Seedance 2.0 fast 均支持
|
||||
|
||||
### 费用说明
|
||||
|
||||
1080P 和 720P/480P 视频区分定价
|
||||
|
||||
价格详见:https://www.volcengine.com/docs/82379/1544106?lang=zh#02affcb8
|
||||
2233
docs/API文档/seedance 2.0 系列教程.md
Normal file
2233
docs/API文档/seedance 2.0 系列教程.md
Normal file
File diff suppressed because it is too large
Load Diff
481
docs/API文档/seedance模型价格.md
Normal file
481
docs/API文档/seedance模型价格.md
Normal file
@ -0,0 +1,481 @@
|
||||
不同模型服务支持的能力及单价各不相同,本文为您介绍各模型的计费公式及单价,方便您进行模型价格查阅和比较。
|
||||
:::tip
|
||||
|
||||
* 如需了解计费方式及详细计费逻辑,请参见 [模型服务计费说明](/docs/82379/1544681)。
|
||||
* 支持通过 [价格计算器](https://www.volcengine.com/pricing?product=ark_bd&tab=2) **预估** 满足业务需求所需的费用。
|
||||
* 本文价格和 [定价详情页](https://www.volcengine.com/pricing?product=ark_bd&tab=1) 仅作为商品规格和价格的参考,具体可购买的商品规格及费用请以实际下单结果为准。
|
||||
|
||||
:::
|
||||
<span id="76de5911"></span>
|
||||
# 大语言模型
|
||||
<span id="aa1874cf"></span>
|
||||
## 在线推理(常规)
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,2,1,1,1,1"></span>
|
||||
|模型名称 |条件|输入|缓存存储|缓存输入|输出|\
|
||||
| |千 token |元/百万token |元/百万 token /小时 |元/百万token |元/百万token |
|
||||
|---|---|---|---|---|---|
|
||||
|doubao\-seed\-2.0\-pro |输入长度 [0, 32] |3.2 |0.017 |0.64 |16.0 |
|
||||
|^^|输入长度 (32, 128] |4.8 |0.017 |0.96 |24.0 |
|
||||
|^^|输入长度 (128, 256] |9.6 |0.017 |1.92 |48.0 |
|
||||
|doubao\-seed\-2.0\-lite |输入长度 [0, 32] |0.6 |0.017 |0.12 |3.6 |
|
||||
|^^|输入长度 (32, 128] |0.9 |0.017 |0.18 |5.4 |
|
||||
|^^|输入长度 (128, 256] |1.8 |0.017 |0.36 |10.8 |
|
||||
|doubao\-seed\-2.0\-mini |输入长度 [0, 32] |0.2 |0.017 |0.04 |2.0 |
|
||||
|^^|输入长度 (32, 128] |0.4 |0.017 |0.08 |4.0 |
|
||||
|^^|输入长度 (128, 256] |0.8 |0.017 |0.16 |8.0 |
|
||||
|doubao\-seed\-2.0\-code |输入长度 [0, 32] |3.2 |0.017 |0.64 |16.0 |
|
||||
|^^|输入长度 (32, 128] |4.8 |0.017 |0.96 |24.0 |
|
||||
|^^|输入长度 (128, 256] |9.6 |0.017 |1.92 |48.0 |
|
||||
|doubao\-seed\-1.8 |输入长度 [0, 32]|0.80 |0.017 |0.16 |2.00 |\
|
||||
| |且输出长度 [0, 0.2] | | | | |
|
||||
|^^|输入长度 [0, 32]|0.80 |0.017 |0.16 |8.00 |\
|
||||
| |且输出长度 (0.2,+∞) | | | | |
|
||||
|^^|输入长度 (32, 128] |1.20 |0.017 |0.16 |16.00 |
|
||||
|^^|输入长度 (128, 256] |2.40 |0.017 |0.16 |24.00 |
|
||||
|doubao\-seed\-character |输入长度 [0, 32] |0.80 |0.017 |0.16 |2.00 |
|
||||
|^^|输入长度 (32, 128] |1.20 |0.017 |0.16 |6.00 |
|
||||
|doubao\-seed\-code |输入长度 [0, 32] |1.20 |0.017 |0.24 |8.00 |
|
||||
|^^|输入长度 (32, 128] |1.40 |0.017 |0.24 |12.00 |
|
||||
|^^|输入长度 (128, 256] |2.80 |0.017 |0.24 |16.00 |
|
||||
|doubao\-seed\-1.6 |输入长度 [0, 32]|0.80 |0.017 |0.16 |2.00 |\
|
||||
| |且输出长度 [0, 0.2] | | | | |
|
||||
|^^|输入长度 [0, 32]|0.80 |0.017 |0.16 |8.00 |\
|
||||
| |且输出长度 (0.2,+∞) | | | | |
|
||||
|^^|输入长度 (32, 128] |1.20 |0.017 |0.16 |16.00 |
|
||||
|^^|输入长度 (128, 256] |2.40 |0.017 |0.16 |24.00 |
|
||||
|doubao\-seed\-1.6\-lite |输入长度 [0, 32]|0.30 |0.017 |0.06 |0.60 |\
|
||||
| |且输出长度 [0, 0.2] | | | | |
|
||||
|^^|输入长度 [0, 32]|0.30 |0.017 |0.06 |2.40 |\
|
||||
| |且输出长度 (0.2,+∞) | | | | |
|
||||
|^^|输入长度 (32, 128] |0.60 |0.017 |0.06 |4.00 |
|
||||
|^^|输入长度 (128, 256] |1.20 |0.017 |0.06 |12.00 |
|
||||
|doubao\-seed\-1.6\-flash |输入长度 [0, 32] |0.15 |0.017 |0.03 |1.50 |
|
||||
|^^|输入长度 (32, 128] |0.30 |0.017 |0.03 |3.00 |
|
||||
|^^|输入长度 (128, 256] |0.60 |0.017 |0.03 |6.00 |
|
||||
|doubao\-seed\-1.6\-vision |输入长度 [0, 32] |0.80 |0.017 |0.16 |8.00 |
|
||||
|^^|输入长度 (32, 128] |1.20 |0.017 |0.16 |16.00 |
|
||||
|^^|输入长度 (128, 256] |2.40 |0.017 |0.16 |24.00 |
|
||||
|doubao\-seed\-translation |\- |1.20 |不支持 |不支持 |3.60 |
|
||||
|doubao\-1.5\-pro\-32k |\- |0.80 |0.017 |0.16 |2.00 |
|
||||
|doubao\-1.5\-lite\-32k |\- |0.30 |0.017 |0.06 |0.60 |
|
||||
|doubao\-1.5\-vision\-pro |\- |3.00 |不支持 |不支持 |9.00 |
|
||||
|glm\-4.7 |输入长度 [0, 32]|2.0 |0.017 |0.4 |8.0 |\
|
||||
| |且输出长度 [0, 0.2] | | | | |
|
||||
|^^|输入长度 [0, 32]|3.0 |0.017 |0.6 |14.0 |\
|
||||
| |且输出长度 (0.2,+∞) | | | | |
|
||||
|^^|输入长度 (32, 200] |4.0 |0.017 |0.8 |16.0 |
|
||||
|deepseek\-v3.2 |输入长度 [0, 32] |2.00 |0.017 |0.4 |3.00 |
|
||||
|^^|输入长度 (32, 128] |4.00 |0.017 |0.4 |6.00 |
|
||||
|deepseek\-v3.1 |\- |4.00 |0.017 |0.80 |12.00 |
|
||||
|deepseek\-v3 |\- |2.00 |0.017 |0.40 |8.00 |
|
||||
|deepseek\-r1 |\- |4.00 |0.017 |0.80 |16.00 |
|
||||
|
||||
|
||||
> * 按 token 后付费,计算公式:
|
||||
> * `在线推理费用 = 输入单价 × 输入token + 缓存输入单价 × 缓存命中token + 缓存存储单价 × 缓存存储token × 时长 + 输出单价 × 输出token`
|
||||
> * 分段计费:部分模型适用,不同的输入长度(和输出长度),token单价不同:
|
||||
> * 举例:请求输入 200k tokens,输出 14k tokens,满足 **输入长度 (128, 256]** 条件,模型输入输出 token 按照:输入 2.4 元/百万 token,输出 24 元/百万 token 单价计费。
|
||||
> * 常见问题: [如何查看历史调用的输入输出长度的区间分布?](/docs/82379/1359411#fba666f2)
|
||||
|
||||
<span id="d3774bbd"></span>
|
||||
## 在线推理(低延迟)
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,2,1,1,1"></span>
|
||||
|模型名称 |条件|输入|缓存输入|输出|\
|
||||
| |千 token |元/百万token |元/百万token |元/百万token |
|
||||
|---|---|---|---|---|
|
||||
|doubao\-seed\-2.0\-pro |输入长度 [0, 32] |9.6 |1.92 |48.0 |
|
||||
|^^|输入长度 (32, 128] |14.4 |2.88 |72.0 |
|
||||
|^^|输入长度 (128, 256] |28.8 |5.76 |144.0 |
|
||||
|doubao\-seed\-2.0\-lite |输入长度 [0, 32] |1.2 |0.24 |7.2 |
|
||||
|^^|输入长度 (32, 128] |1.8 |0.36 |10.8 |
|
||||
|^^|输入长度 (128, 256] |3.6 |0.72 |21.6 |
|
||||
|doubao\-seed\-2.0\-mini |输入长度 [0, 32] |0.4 |0.08 |4.0 |
|
||||
|^^|输入长度 (32, 128] |0.8 |0.16 |8.0 |
|
||||
|^^|输入长度 (128, 256] |1.6 |0.32 |16.0 |
|
||||
|
||||
<span id="952683a2"></span>
|
||||
## 在线推理(TPM 保障包)
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,2,2,2"></span>
|
||||
|模型 |计费方式 |输入|输出|\
|
||||
| | |元/每10K TPM |元/每1K TPM |
|
||||
|---|---|---|---|
|
||||
|doubao\-seed\-1.8 |按购买时长后付费 |1.920 |0.480 |
|
||||
|^^|包天预付费 |23.040 |5.760 |
|
||||
|doubao\-seed\-1.6 |按购买时长后付费 |1.920 |0.480 |
|
||||
|^^|包天预付费 |23.040 |5.760 |
|
||||
|doubao\-seed\-1.6\-vision |按购买时长后付费 |1.920 |0.480 |
|
||||
|^^|包天预付费 |23.040 |5.760 |
|
||||
|doubao\-seed\-1.6\-flash|按购买时长后付费 |0.360 |0.360 |\
|
||||
|> 0615版本不支持 | | | |
|
||||
|^^|包天预付费 |4.320 |4.320 |
|
||||
|doubao\-1.5\-vision\-pro |按购买时长后付费 |7.200 |2.160 |
|
||||
|^^|包天预付费 |86.400 |25.920 |
|
||||
|doubao\-1.5\-pro\-32k|按购买时长后付费 |1.920 |0.480 |\
|
||||
|> 包含 character\-250715 版本 | | | |
|
||||
|^^|包天预付费 |23.040 |5.760 |
|
||||
|doubao\-1.5\-lite\-32k |按购买时长后付费 |0.72 |0.144 |
|
||||
|^^|包天预付费 |8.64 |1.728 |
|
||||
|doubao\-pro\-32k |按购买时长后付费 |1.920 |0.480 |
|
||||
|^^|包天预付费 |23.040 |5.760 |
|
||||
|deepseek\-v3.2 |按购买时长后付费 |7.2 |1.08 |
|
||||
|^^|包天预付费 |86.4 |12.96 |
|
||||
|deepseek\-v3.1 |按购买时长后付费 |9.60 |2.88 |
|
||||
|^^|包天预付费 |115.20 |34.56 |
|
||||
|deepseek\-v3 |按购买时长后付费 |4.80 |1.92 |
|
||||
|^^|包天预付费 |57.60 |23.04 |
|
||||
|deepseek\-r1 |按购买时长后付费 |9.60 |3.84 |
|
||||
|^^|包天预付费 |115.20 |46.08 |
|
||||
|
||||
|
||||
> * 相比普通的按token计费模式,TPM保障包具备更高并发,更低的延迟,更强稳定性。支持的模型,以[接入点创建页](https://console.volcengine.com/ark/region:ark+cn-beijing/endpoint/create)可选的付费方式为准。
|
||||
> * 支持「按购买时长后付费」和「包天预付费」两种方式叠加购买,可灵活组合。
|
||||
> * **doubao\-seed\-1.6 系列及之后模型,deepseek\-v3.2 模型,不同长度请求抵扣 TPM 速度不同**,可通过 TPM 计算器查看相应的抵扣系数,估算实际需购买的**可抵扣TPM**。
|
||||
|
||||
<span id="a6471f38"></span>
|
||||
## 批量推理
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,2,1,1,2"></span>
|
||||
|模型名称 |条件|输入|缓存命中|输出|\
|
||||
| |千 token |元/百万token |元/百万token |元/百万token |
|
||||
|---|---|---|---|---|
|
||||
|doubao\-seed\-2.0\-pro |输入长度 [0, 32] |1.6 |0.64 |8.0 |
|
||||
|^^|输入长度 (32, 128] |2.4 |0.96 |12.0 |
|
||||
|^^|输入长度 (128, 256] |4.8 |1.92 |24.0 |
|
||||
|doubao\-seed\-2.0\-lite |输入长度 [0, 32] |0.3 |0.12 |1.8 |
|
||||
|^^|输入长度 (32, 128] |0.45 |0.18 |2.7 |
|
||||
|^^|输入长度 (128, 256] |0.9 |0.36 |5.4 |
|
||||
|doubao\-seed\-2.0\-mini |输入长度 [0, 32] |0.1 |0.04 |1.0 |
|
||||
|^^|输入长度 (32, 128] |0.2 |0.08 |2.0 |
|
||||
|^^|输入长度 (128, 256] |0.4 |0.16 |4.0 |
|
||||
|doubao\-seed\-2.0\-code |输入长度 [0, 32] |1.6 |0.64 |8.0 |
|
||||
|^^|输入长度 (32, 128] |2.4 |0.96 |12.0 |
|
||||
|^^|输入长度 (128, 256] |4.8 |1.92 |24.0 |
|
||||
|doubao\-seed\-1.8 |输入长度 [0, 32]|0.40 |0.16 |1.00 |\
|
||||
| |且输出长度 [0, 0.2] | | | |
|
||||
|^^|输入长度 [0, 32]|0.40 |0.16 |4.00 |\
|
||||
| |且输出长度 (0.2,+∞) | | | |
|
||||
|^^|输入长度 (32, 128] |0.60 |0.16 |8.00 |
|
||||
|^^|输入长度 (128, 256] |1.20 |0.16 |12.00 |
|
||||
|doubao\-seed\-1.6\-vision |输入长度 [0, 32] |0.40 |0.16 |4.00 |
|
||||
|^^|输入长度 (32, 128] |0.60 |0.16 |8.00 |
|
||||
|^^|输入长度 (128, 256] |1.20 |0.16 |12.00 |
|
||||
|doubao\-seed\-1.6\-lite |输入长度 [0, 32]|0.15 |0.06 |0.30 |\
|
||||
| |且输出长度 [0, 0.2] | | | |
|
||||
|^^|输入长度 [0, 32]|0.15 |0.06 |1.20 |\
|
||||
| |且输出长度 (0.2,+∞) | | | |
|
||||
|^^|输入长度 (32, 128] |0.30 |0.06 |2.00 |
|
||||
|^^|输入长度 (128, 256] |0.60 |0.06 |6.00 |
|
||||
|doubao\-seed\-1.6 |输入长度 [0, 32]|0.40 |0.16 |1.00 |\
|
||||
| |且输出长度 [0, 0.2] | | | |
|
||||
|^^|输入长度 [0, 32]|0.40 |0.16 |4.00 |\
|
||||
| |且输出长度 (0.2,+∞) | | | |
|
||||
|^^|输入长度 (32, 128] |0.60 |0.16 |8.00 |
|
||||
|^^|输入长度 (128, 256] |1.20 |0.16 |12.00 |
|
||||
|doubao\-seed\-1.6\-flash |输入长度 [0, 32] |0.075 |0.03 |0.75 |
|
||||
|^^|输入长度 (32, 128] |0.150 |0.03 |1.50 |
|
||||
|^^|输入长度 (128, 256] |0.300 |0.03 |3.00 |
|
||||
|doubao\-seed\-translation |\- |0.60 |0.24 |1.80 |
|
||||
|doubao\-1.5\-pro\-32k |\- |0.40 |0.16 |1.00 |
|
||||
|doubao\-1.5\-lite\-32k |\- |0.15 |0.06 |0.30 |
|
||||
|doubao\-pro\-32k |\- |0.80 |0.16 |2.00 |
|
||||
|deepseek\-v3.2 |输入长度 [0, 32] |1.00 |0.40 |1.50 |
|
||||
|^^|输入长度 (32, 128] |2.00 |0.40 |3.00 |
|
||||
|deepseek\-v3.1 |\- |2.00 |0.80 |6.00 |
|
||||
|deepseek\-v3 |\- |1.00 |0.40 |4.00 |
|
||||
|deepseek\-r1 |\- |2.00 |0.80 |8.00 |
|
||||
|
||||
|
||||
> * 按 token 后付费,计算公式:`批量推理费用 = 输入单价 × 输入token + 缓存命中单价 × 缓存命中token + 输出单价 × 输出token`
|
||||
> * 部分模型已支持透明前缀缓存能力,无需任何配置,享受命中缓存后的更低单价。
|
||||
> * doubao\-seed\-1.6 系列支持分段计费,即根据每次请求的输入及输出长度,采用不同 token 单价。
|
||||
> * 举例:当某次请求的输入长度为 200k,输出长度为 14k 时,满足 **输入长度 (128, 256]** 条件,模型产生的所有 token 按照:输入2.4 元/百万 token,输出 24 元/百万 token 单价计费。
|
||||
> * 查看往期调用的输入输出长度分布,请查看常见问题 [如何查看历史调用的输入输出长度的区间分布?](/docs/82379/1359411#fba666f2)
|
||||
|
||||
<span id="02affcb8"></span>
|
||||
# 视频生成模型
|
||||
<span id="2864f00a"></span>
|
||||
## 按token单价
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,3,3"></span>
|
||||
|模型 |在线推理|离线推理|\
|
||||
| |元/百万token |元/百万token |
|
||||
|---|---|---|
|
||||
|doubao\-seedance\-2.0|* 输出视频分辨率为 480p,720p|暂不支持 |\
|
||||
|> 按输出视频分辨率和输入是否包含视频区分定价 | * 输入不含视频:46.00| |\
|
||||
| | * 输入包含视频:28.00| |\
|
||||
| |* 输出视频分辨率为 1080p| |\
|
||||
| | * 输入不含视频:51.00| |\
|
||||
| | * 输入包含视频:31.00 | |
|
||||
|doubao\-seedance\-2.0\-fast|* 输入不含视频:37.00|暂不支持 |\
|
||||
|> 按输入是否包含视频区分定价|* 输入包含视频:22.00 | |\
|
||||
|> 不支持输出 1080p 视频 | | |
|
||||
|doubao\-seedance\-1.5\-pro|* 有声视频:16.00|* 有声视频:8.00|\
|
||||
|> 按输出视频是否包含声音区分定价 |* 无声视频:8.00 |* 无声视频:4.00 |
|
||||
|doubao\-seedance\-1.0\-pro |15.00 |7.50 |
|
||||
|doubao\-seedance\-1.0\-pro\-fast |4.20 |2.10 |
|
||||
|doubao\-seedance\-1.0\-lite |10.00 |5.00 |
|
||||
|
||||
|
||||
> * 仅对成功生成的视频计费。因审核等原因导致生成失败的,不收取费用。
|
||||
> * 视频价格估算公式:`按 token 单价 × token 用量`
|
||||
> * 正常视频 token 用量估算:`(输入视频时长+输出视频时长) × 输出视频的宽 × 输出视频的高 × 输出视频的帧率/1024`,注意存在输入视频时, Seedance 2.0 和 Seedance 2.0 fast 模型针对不同的视频输出时长存在最低 Token 用量限制,详见下文表格。
|
||||
> * Draft 视频(仅480p)token 用量估算:`正常视频 token 用量公式 × 折算系数`,折算系数与模型相关,Seedance 1.5 pro 的 token 折算系数:无声 0.7;有声 0.6,其他模型暂不支持。
|
||||
> * 准确 token 用量:以调用 API 后返回信息中的 usage 字段为准。
|
||||
|
||||
<span id="2653dbb3"></span>
|
||||
## 价格示例
|
||||
基于 token 用量公式估算的视频单价,方便您直观了解不同规格的视频成本。更多价格示例请参见[火山方舟视频生成模型价格快查表](https://bytedance.larkoffice.com/wiki/FXaYwxzJ5i5Zdik32ipcWzt7nxd?table=tblns3WjGMNbR8sL&view=vewPa39Do4#CategoryScheduledTask)。
|
||||
<span id="83af2aad"></span>
|
||||
### doubao\-seedance\-2.0 & 2.0 fast
|
||||
|
||||
> * 视频价格估算公式:`按 token 单价 × token 用量`=`按 token 单价 × (输入视频时长+输出视频时长) × 输出视频的宽 × 输出视频的高 × 输出视频的帧率/1024`
|
||||
> * 注意:输入包含视频时, Seedance 2.0 和 Seedance 2.0 fast 模型针对不同的视频输出时长存在最低 token 用量限制,如果 token 估算用量 < 最低 token 用量限制,则按最低 token 用量计算视频价格。
|
||||
* **输入不含视频**
|
||||
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="2,2,3,4,4"></span>
|
||||
|分辨率 |宽高比 |输出视频时长(秒) |doubao\-seedance\-2.0|doubao\-seedance\-2.0\-fast|\
|
||||
| | | |视频价格(元/个) |视频价格(元/个) |
|
||||
|---|---|---|---|---|
|
||||
|480p |16:9 |5 |2.31 |1.86 |
|
||||
|720p |16:9 |5 |4.97 |4.00 |
|
||||
|1080p |16:9 |5 |12.39 |不支持 |
|
||||
|
||||
|
||||
* **输入包含视频**
|
||||
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="2,2,3,3,4,4"></span>
|
||||
|分辨率 |宽高比 |输入视频时长(秒) |输出视频时长(秒) |doubao\-seedance\-2.0|doubao\-seedance\-2.0\-fast|\
|
||||
| | | | |视频价格(元/个) |视频价格(元/个) |
|
||||
|---|---|---|---|---|---|
|
||||
|480p |16:9 |2~15 |5 |2.53~5.62|1.99~4.42|\
|
||||
| | | | |> 最低价对应输入2~4秒|> 最低价对应输入2~4秒|\
|
||||
| | | | |> 最高价对应输入15秒 |> 最高价对应输入15秒 |
|
||||
|720p |16:9 |2~15 |5 |5.44~12.10|4.28~9.50|\
|
||||
| | | | |> 最低价对应输入2~4秒|> 最低价对应输入2~4秒|\
|
||||
| | | | |> 最高价对应输入15秒 |> 最高价对应输入15秒 |
|
||||
|1080p |16:9 |2~15 |5 |13.56~30.13|不支持 |\
|
||||
| | | | |> 最低价对应输入2~4秒| |\
|
||||
| | | | |> 最高价对应输入15秒 | |
|
||||
|
||||
附:输入包含视频时,Seedance 2.0 & 2.0 fast 的最低 token 用量限制。本表以 16:9 宽高比为例展示各分辨率下的最低 token 用量。不同宽高比的最低 token 用量存在少许差异,详情参见 [火山方舟视频生成模型价格快查表](https://bytedance.larkoffice.com/wiki/FXaYwxzJ5i5Zdik32ipcWzt7nxd?table=tblmNCuMjADrXtDf&view=vewPa39Do4#CategoryScheduledTask)。
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,3,3,3"></span>
|
||||
|输出视频秒数 |最低tokens\-480P |最低tokens\-720P |最低tokens\-1080P |
|
||||
|---|---|---|---|
|
||||
|4 |70308 |151200 |340200 |
|
||||
|5 |90396 |194400 |437400 |
|
||||
|6 |100440 |216000 |486000 |
|
||||
|7 |120528 |259200 |583200 |
|
||||
|8 |140616 |302400 |680400 |
|
||||
|9 |150660 |324000 |729000 |
|
||||
|10 |170748 |367200 |826200 |
|
||||
|11 |190836 |410400 |923400 |
|
||||
|12 |200880 |432000 |972000 |
|
||||
|13 |220968 |475200 |1069200 |
|
||||
|14 |241056 |518400 |1166400 |
|
||||
|15 |251100 |540000 |1215000 |
|
||||
|
||||
<span id="dd571290"></span>
|
||||
### doubao\-seedance\-1.5\-pro
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="2,2,2,3,3,3,3"></span>
|
||||
|分辨率 |宽高比 |时长(秒) |有声视频|Draft 有声|无声视频|Draft无声|\
|
||||
| | | |价格|视频价格|价格|视频价格|\
|
||||
| | | |(元/个) |(元/个) |(元/个) |(元/个) |
|
||||
|---|---|---|---|---|---|---|
|
||||
|480p |16:9 |5 |0.80 |0.48 |0.40 |0.28 |
|
||||
|720p |16:9 |5 |1.73 |不支持 |0.86 |不支持 |
|
||||
|1080p |16:9 |5 |3.89 |不支持 |1.94 |不支持 |
|
||||
|
||||
<span id="457edfd0"></span>
|
||||
# 图片生成模型
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,6"></span>
|
||||
|模型名称 |单价|\
|
||||
| |元/张 |
|
||||
|---|---|
|
||||
|doubao\-seedream\-5.0\-lite |0.22 |
|
||||
|doubao\-seedream\-4.5 |0.25 |
|
||||
|doubao\-seedream\-4.0 |0.2 |
|
||||
|doubao\-seedream\-3.0\-t2i |0.259 |
|
||||
|
||||
|
||||
> * 按成功输出图片数量计费:
|
||||
> * 组图场景按实际生成的图片数量计费。
|
||||
> * 因审核等原因未成功输出的图片不计费。
|
||||
|
||||
|
||||
<span id="e68ea83c"></span>
|
||||
# 向量模型
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,3,3"></span>
|
||||
|模型 |文本输入|图片输入|\
|
||||
| |元/百万 token |元/百万 token |
|
||||
|---|---|---|
|
||||
|doubao\-embedding\-vision |0.70 |1.80 |
|
||||
|
||||
> 按输入的 tokens 计费:
|
||||
> 费用 = `文本输入 tokens × 文本输入单价 + 图片输入 tokens × 图片输入单价`
|
||||
> = `文本输入 tokens × 文本输入单价+ min((width × height)/784,1312 ) × 图片输入单价`
|
||||
|
||||
<span id="b3a42676"></span>
|
||||
# 模型精调
|
||||
<span id="7e451788"></span>
|
||||
## 精调\-按 token 后付费
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,3,3"></span>
|
||||
|基础模型 ID |LoRA精调|全量精调|\
|
||||
| |元/百万token |元/百万token |
|
||||
|---|---|---|
|
||||
|doubao\-seed\-1.6 |40 |80 |
|
||||
|doubao\-seed\-1.6\-flash |7 |14 |
|
||||
|doubao\-1\-5\-pro\-32k\-250115 |50 |100 |
|
||||
|doubao\-1\-5\-lite\-32k\-250115 |30 |60 |
|
||||
|
||||
> 训练费用 = 总 token 数 x 精调单价 =(用户训练集token数+混入token数+验证集token数)x 迭代轮次 x 精调token单价
|
||||
> * 若 token 数小于 1000,将会上取整为 1000 tokens 计算。
|
||||
|
||||
<span id="b2811e92"></span>
|
||||
## 精调\-按算力付费
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,3,3"></span>
|
||||
|算力规格 |计费方式 |定价|\
|
||||
| | |元/小时 |
|
||||
|---|---|---|
|
||||
|方舟A型模型单元 |按量后付费 |25 |
|
||||
|方舟B型模型单元 |按量后付费 |15 |
|
||||
|方舟C型模型单元 |按量后付费 |10 |
|
||||
|方舟D型模型单元 |按量后付费 |20 |
|
||||
|
||||
> 训练费用=训练计费时长*使用的模版单价=训练计费时长*模型单元数\*模型单元单价。
|
||||
|
||||
<span id="c6d128f7"></span>
|
||||
## 推理\-在线推理
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,2,2,2"></span>
|
||||
|精调模型对应的基础模型 |条件(千 token) |输入|输出|\
|
||||
| | |元/百万token |元/百万token |
|
||||
|---|---|---|---|
|
||||
|doubao\-seed\-1.6 |输入长度 [0, 32] |1.60 |16.00 |
|
||||
|^^|输入长度 (32, 128] |2.40 |32.00 |
|
||||
|doubao\-seed\-1.6\-flash |输入长度 [0, 32] |0.30 |3.00 |
|
||||
|^^|输入长度 (32, 128] |0.60 |6.00 |
|
||||
|doubao\-1.5\-pro\-32k |\- |2.00 |5.00 |
|
||||
|doubao\-1.5\-lite\-32k |\- |0.75 |1.50 |
|
||||
|doubao\-pro\-32k |\- |0.80 |2.00 |
|
||||
|
||||
> 按 token 后付费价格,仅部分 doubao 模型在精调后支持按 token 付费,以[接入点创建页](https://console.volcengine.com/ark/region:ark+cn-beijing/endpoint/create)可选的付费方式为准。
|
||||
|
||||
<span id="0c211d41"></span>
|
||||
## 推理\-批量推理
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,2,1,1,2"></span>
|
||||
|精调模型对应的基础模型 |条件(千 token) |输入|缓存命中|输出|\
|
||||
| | |元/百万token |元/百万token |元/百万token |
|
||||
|---|---|---|---|---|
|
||||
|doubao\-seed\-1.6 |输入长度 [0, 32] |0.40 |0.16 |4.00 |
|
||||
|^^|输入长度 (32, 128] |0.60 |0.16 |8.00 |
|
||||
|^^|输入长度 (128, 256] |1.20 |0.16 |12.00 |
|
||||
|doubao\-seed\-1.6\-flash |输入长度 [0, 32] |0.075 |0.03 |0.75 |
|
||||
|^^|输入长度 (32, 128] |0.15 |0.03 |1.50 |
|
||||
|^^|输入长度 (128, 256] |0.30 |0.03 |3.00 |
|
||||
|doubao\-1.5\-pro\-32k |\- |0.40 |0.16 |1.00 |
|
||||
|doubao\-1.5\-lite\-32k |\- |0.15 |0.06 |0.30 |
|
||||
|doubao\-pro\-32k |\- |0.80 |0.16 |2.00 |
|
||||
|
||||
> 按token后付费,相比在线推理,价格低至50%。
|
||||
|
||||
<span id="c26435c9"></span>
|
||||
# 模型单元
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,3,3"></span>
|
||||
|机型 |计费方式 |定价|\
|
||||
| | |元/个 |
|
||||
|---|---|---|
|
||||
|方舟A型模型单元 |按购买时长后付费 |25.00 |
|
||||
|^^|包月预付费 |16700.00 |
|
||||
|方舟B型模型单元 |按购买时长后付费 |15.00 |
|
||||
|^^|包月预付费 |10400.00 |
|
||||
|方舟C型模型单元 |按购买时长后付费 |10.00 |
|
||||
|^^|包月预付费 |7100.00 |
|
||||
|方舟D型模型单元 |按购买时长后付费 |20.00 |
|
||||
|^^|包月预付费 |12800.00 |
|
||||
|
||||
> 支持「按购买时长后付费」和「包月预付费」两种方式叠加购买,可灵活组合。
|
||||
> **提供** [单元计算器](https://console.volcengine.com/ark/region:ark+cn-beijing/endpoint/create) 估算需要的机型数量。更推荐通过实际业务流量压测,计算需要的机型和数量。
|
||||
|
||||
<span id="3adb5876"></span>
|
||||
# 工具及插件
|
||||
<span id="f2e7c4f6"></span>
|
||||
## 联网内容插件
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,2,4"></span>
|
||||
|服务项 |价格|说明 |\
|
||||
| |元/千次 | |
|
||||
|---|---|---|
|
||||
|联网资源 |4 |实时搜索互联网公开域内容,每月提供2万次免费额度。 |
|
||||
|头条资源 |6 |实时搜索今日头条图文内容,并提供内容详情信息供展示交互卡片。 |
|
||||
|抖音资源 |6 |实时搜索抖音百科内容,并提供内容详情信息供展示交互卡片。 |
|
||||
|墨迹天气 |6 |实时搜索墨迹天气内容资源。 |
|
||||
|
||||
|
||||
> * 出账及计费:按量后付费
|
||||
> * 用量:每次请求产生的调用次数,可返回结构体的 **source_type** 字段计算得到。
|
||||
> * 更多说明请参见 [联网内容插件功能说明](/docs/82379/1338552)。
|
||||
|
||||
<span id="abf4f1e8"></span>
|
||||
## 豆包助手
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,2,4"></span>
|
||||
|服务项 |价格|说明 |\
|
||||
| |元/次 | |
|
||||
|---|---|---|
|
||||
|日常沟通 |0.1 |全能助手,自然交流,多轮对话,高情商人格化聊天。 |
|
||||
|深度沟通 |0.2 |深度理解,精准解析,先思考再回答,复杂问题尽在掌握。 |
|
||||
|联网搜索 |0.2 |全网搜索,信源丰富,无需费力找资料,一键搜索实时资讯。 |
|
||||
|边想边搜 |0.5 |逻辑缜密,深度洞察,遇难题问豆包,想得更深,答得更准。 |
|
||||
|
||||
|
||||
> * 出账及计费:按量后付费
|
||||
> * 用量:每次请求产生的调用次数,可返回结构体的 **source_type** 字段计算得到。
|
||||
> * 更多说明请参见 [联网内容插件功能说明](/docs/82379/1338552)。
|
||||
|
||||
<span id="bce8c602"></span>
|
||||
## 知识库
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="6,3"></span>
|
||||
|服务项 |价格 |
|
||||
|---|---|
|
||||
|计算资源\-知识库【旗舰版】 |0.45 元/CU/小时 |
|
||||
|离线存储资源\-知识库【旗舰版】 |0.0015 元/GB/小时 |
|
||||
|标准计算资源\-知识库【标准版】 |0.0416 元/知识库/小时 |
|
||||
|文本向量模型\-知识库【通用】 |0.0005 元/千token |
|
||||
|文本向量模型(多功能版)\-知识库【通用】 |0.0005 元/千token |
|
||||
|文本向量模型(Doubao\-embedding)\-知识库【通用】 |0.0005 元/千token |
|
||||
|文本向量模型(Doubao\- embedding\-large)\-知识库【通用】 |0.0007 元/千token |
|
||||
|多模态向量模型(Doubao\-embedding\-vision\-text)\-知识库【通用】 |0.0007 元/千token |
|
||||
|多模态向量模型(Doubao\-embedding\-vision\-image)\-知识库【通用】 |0.0018 元/千token |
|
||||
|重排模型\-知识库【通用】 |0.0005 元/千token |
|
||||
|
||||
> 更多说明请参见 [知识库计费](/docs/82379/1263336)。
|
||||
|
||||
<span id="f47e6c9b"></span>
|
||||
# Coding Plan 个人版
|
||||
|
||||
<span aceTableMode="list" aceTableWidth="3,3,3"></span>
|
||||
|套餐类型 |订阅时长 |价格 |
|
||||
|---|---|---|
|
||||
|Lite 套餐 |1 个月 |40 元/月 |
|
||||
|^^|3 个月 |120 元/季 |
|
||||
|Pro 套餐 |1 个月 |200 元/月 |
|
||||
|^^|3 个月 |600 元/季 |
|
||||
|
||||
> 套餐信息及特惠活动参见[套餐概览](/docs/82379/1925114)。
|
||||
|
||||
|
||||
|
||||
648
docs/API文档/创建视频生成任务API.md
Normal file
648
docs/API文档/创建视频生成任务API.md
Normal file
@ -0,0 +1,648 @@
|
||||
`POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks` [ ](https://api.volcengine.com/api-explorer/?action=CreateContentsGenerationsTasks&data=%7B%7D&groupName=%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90API&query=%7B%7D&serviceCode=ark&version=2024-01-01)[运行](https://api.volcengine.com/api-explorer/?action=CreateContentsGenerationsTasks&data=%7B%7D&groupName=%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90API&query=%7B%7D&serviceCode=ark&version=2024-01-01)
|
||||
本文介绍创建视频生成任务 API 的输入输出参数,供您使用接口时查阅字段含义。模型会依据传入的图片及文本信息生成视频,待生成完成后,您可以按条件查询任务并获取生成的视频。
|
||||
:::tip
|
||||
请确保您的账户余额大于等于 200 元([前往充值](https://console.volcengine.com/finance/fund/recharge)),或已[购买资源包](https://console.volcengine.com/common-buy/fast/ark_bd%7C%7Cd682ppeeq1mp7kd5q0e0),否则无法开通 seedance 2.0 及 seedance 2.0 fast 模型。
|
||||
|
||||
:::
|
||||
**模型能力==^new^==**
|
||||
|
||||
* **seedance 2.0 & 2.0 fast==^new^==** ** (有声视频/无声视频)**
|
||||
* **多模态参考生视频==^new^==**:输入++参考图片(0~9)+参考视频(0~3)+ 参考音频(0~3)+ 文本提示词(可选)++ 生成 1 个目标视频。注意不可单独输入音频,应至少包含 1 个参考视频或图片。支持生成全新视频、编辑视频、延长视频,[阅读教程](https://www.volcengine.com/docs/82379/2291680) 获取详细代码示例。
|
||||
* **图生视频\-首尾帧**:输入++首帧图片+尾帧图片+文本提示词(可选)++ 生成 1 个目标视频。
|
||||
* **图生视频\-首帧**:输入++首帧图片+文本提示词(可选)++ 生成 1 个目标视频。
|
||||
* **文生视频**:输入++文本提示词++生成 1 个目标视频。
|
||||
* **seedance 1.5 pro (有声视频/无声视频)**
|
||||
【图生视频\-首尾帧】【图生视频\-首帧】【文生视频】
|
||||
* **seedance 1.0 pro**
|
||||
【图生视频\-首尾帧】【图生视频\-首帧】【文生视频】
|
||||
* **seedance 1.0 pro fast**
|
||||
【图生视频\-首帧】【文生视频】
|
||||
* **seedance 1.0 lite**
|
||||
* **doubao\-seedance\-1\-0\-lite\-t2v:** 文生视频
|
||||
* **doubao\-seedance\-1\-0\-lite\-i2v:**
|
||||
* 参考图生视频:根据您输入的**++参考图片(1\-4张)++ ** +++文本提示词(可选)++ 生成 1 个目标视频。
|
||||
* 图生视频\-首尾帧
|
||||
* 图生视频\-首帧
|
||||
|
||||
|
||||
Tips:一键展开折叠,快速检索内容
|
||||
打开页面右上角开关,**ctrl ** + **f** 可检索页面内所有内容。
|
||||
<span> </span>
|
||||
|
||||
|
||||
```mixin-react
|
||||
return (<Tabs>
|
||||
<Tabs.TabPane title="在线调试" key="4rK5FhUg"><RenderMd content={`<APILink link="https://api.volcengine.com/api-explorer/?action=CreateContentsGenerationsTasks&data=%7B%7D&groupName=%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90API&query=%7B%7D&serviceCode=ark&version=2024-01-01" description="API Explorer 您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。"></APILink>
|
||||
`}></RenderMd></Tabs.TabPane>
|
||||
<Tabs.TabPane title="鉴权说明" key="iRuPtuk6"><RenderMd content={`本接口仅支持 API Key 鉴权,请在 [获取 API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey) 页面,获取长效 API Key。
|
||||
`}></RenderMd></Tabs.TabPane>
|
||||
<Tabs.TabPane title="快速入口" key="5LZLMN0J"><RenderMd content={` [ ](#)[体验中心](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision) <span> </span>[模型列表](https://www.volcengine.com/docs/82379/1330310?lang=zh#2705b333) <span> </span>[模型计费](https://www.volcengine.com/docs/82379/1544106?redirect=1&lang=zh#02affcb8) <span> </span>[API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey?apikey=%7B%7D)
|
||||
<span> </span>[调用教程](https://www.volcengine.com/docs/82379/1366799) <span> </span>[接口文档](https://www.volcengine.com/docs/82379/1520758) <span> </span>[常见问题](https://www.volcengine.com/docs/82379/1359411) <span> </span>[开通模型](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)
|
||||
`}></RenderMd></Tabs.TabPane></Tabs>);
|
||||
```
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
<span id="5qndT7DS"></span>
|
||||
## 请求参数
|
||||
> 跳转 [响应参数](#y2hhTyHB)
|
||||
|
||||
<span id="wsGzv1pD"></span>
|
||||
### 请求体
|
||||
|
||||
---
|
||||
|
||||
|
||||
**model** `string` %%require%%
|
||||
您需要调用的模型的 ID (Model ID),[开通模型服务](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false),并[查询 Model ID](https://www.volcengine.com/docs/82379/1330310) 。
|
||||
您也可通过 Endpoint ID 来调用模型,获得限流、计费类型(前付费/后付费)、运行状态查询、监控、安全等高级能力,可参考[获取 Endpoint ID](https://www.volcengine.com/docs/82379/1099522)。
|
||||
|
||||
---
|
||||
|
||||
|
||||
**content** `object[]` %%require%%
|
||||
输入给模型,生成视频的信息,支持文本、图片、音频、视频、样片任务 ID。
|
||||
:::warning
|
||||
seedance 2.0 系列模型不支持直接上传含有真人人脸的参考图/视频。为了便利创作者对肖像的使用,平台推出了以下解决方案,详情参见 [教程](https://www.volcengine.com/docs/82379/2291680?lang=zh#5c67c9a1)。
|
||||
|
||||
* 支持使用部分模型的含人脸原始产物作为输入素材
|
||||
* 支持使用预置虚拟人像作为输入素材
|
||||
* 支持使用已授权真人素材作为输入
|
||||
|
||||
:::
|
||||
支持以下几种组合:
|
||||
|
||||
* **文本**
|
||||
* **文本(可选)+ 图片**
|
||||
* **文本(可选)+ 视频**
|
||||
* **文本(可选)+ 图片 + 音频**
|
||||
* **文本(可选)+ 图片 + 视频**
|
||||
* **文本(可选)+ 视频 + 音频**
|
||||
* **文本(可选)+ 图片 + 视频 + 音频**
|
||||
* **样片任务 ID**:样片指使用 seedance 模型成功生成的样片视频,模型可基于样片生成高质量正式视频。
|
||||
|
||||
|
||||
信息类型
|
||||
|
||||
---
|
||||
|
||||
|
||||
**文本信息** `object`
|
||||
输入给模型的提示词信息。
|
||||
|
||||
属性
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.**type ** `string` %%require%%
|
||||
输入内容的类型,此处应为 `text`。
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.**text ** `string` %%require%%
|
||||
输入给模型的文本提示词,描述期望生成的视频。
|
||||
:::tip
|
||||
|
||||
* 提示词语言支持:所有模型均支持中英文提示词;seedance 2.0 及 seedance 2.0 fast 额外支持日语、印尼语、西班牙语、葡萄牙语。
|
||||
* 提示词字数建议:中文提示词不超过500字,英文提示词不超过1000词。字数过多易导致信息分散,模型可能忽略细节、仅关注重点,进而造成视频缺失部分元素。
|
||||
* 更多使用技巧:提示词的详细使用技巧,请参见 [seedance 提示词指南](https://www.volcengine.com/docs/82379/2222480?lang=zh)。
|
||||
|
||||
|
||||
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
|
||||
**图片信息==^new^==** `object`
|
||||
输入给模型的图片信息。
|
||||
|
||||
属性
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.**type ** `string` %%require%%
|
||||
输入内容的类型,此处应为 `image_url`。
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.**image_url ** `object` %%require%%
|
||||
输入给模型的图片对象。
|
||||
|
||||
属性
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.image_url.**url ** `string` %%require%%
|
||||
图片 URL 、图片 Base64 编码、素材 ID。
|
||||
|
||||
* 图片 URL:填入图片的公网 URL。
|
||||
* Base64 编码:将本地文件转换为 Base64 编码字符串,然后提交给大模型。遵循格式:`data:image/<图片格式>;base64,<Base64编码>`,注意 `<图片格式>` 需小写,如 `data:image/png;base64,{base64_image}`。
|
||||
* 素材 ID:用于视频生成的预置素材及虚拟人像的 ID,遵循格式:asset://<ASSET_ID\>。可从 [素材&虚拟人像库](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128) 获取。
|
||||
|
||||
:::tip 传入单张图片要求
|
||||
|
||||
* 格式:jpeg、png、webp、bmp、tiff、gif。其中,seedance 1.5 pro 新增支持 heic 和 heif。
|
||||
* 宽高比(宽/高): (0.4, 2.5)
|
||||
* 宽高长度(px):(300, 6000)
|
||||
* 大小:单张图片小于 30 MB。请求体大小不超过 64 MB。大文件请勿使用Base64编码。
|
||||
* 图片数量:
|
||||
* 图生视频\-首帧:1 张
|
||||
* 图生视频\-首尾帧:2 张
|
||||
* seedance 2.0&2.0 fast 多模态参考生视频:1~9 张
|
||||
* seedance 1.0 lite 参考图生视频:1~4 张
|
||||
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.**role ** `string` `条件必填`
|
||||
图片的位置或用途。
|
||||
:::warning
|
||||
|
||||
* **图生视频\-首帧**、**图生视频\-首尾帧**、**多模态参考生视频**(包括参考图、视频、音频)为 3 种互斥场景,**不可混用**。
|
||||
* **多模态参考生视频**可通过提示词指定参考图片作为首帧/尾帧,间接实现“首尾帧+多模态参考”效果。若需严格保障首尾帧和指定图片一致,**优先使用图生视频\-首尾帧**(配置 role 为 first_frame/last_frame)。
|
||||
|
||||
|
||||
:::
|
||||
图生视频\-首帧
|
||||
|
||||
* **支持模型:** 所有图生视频模型
|
||||
* **字段role取值:** 需要传入1个 image_url 对象,字段 role 为 first_frame 或不填。
|
||||
|
||||
|
||||
图生视频\-首尾帧
|
||||
|
||||
* **支持模型:** seedance 2.0 & 2.0 fast,seedance 1.5 pro、seedance 1.0 pro、seedance 1.0 lite i2v
|
||||
* **字段role取值:** 需要传入2个image_url对象,且字段 role 必填。
|
||||
* 首帧图片对应的字段 role 为:first_frame
|
||||
* 尾帧图片对应的字段 role 为:last_frame
|
||||
|
||||
:::tip
|
||||
传入的首尾帧图片可相同。首尾帧图片的宽高比不一致时,以首帧图片为主,尾帧图片会自动裁剪适配。
|
||||
|
||||
:::
|
||||
|
||||
图生视频\-参考图
|
||||
|
||||
* **支持模型:** seedance 2.0 & 2.0 fast(1~9 张图片),seedance 1.0 lite i2v(1~4 张图片)
|
||||
* **字段role取值:** 必填,每张参考图对应的字段 role 均为:reference_image
|
||||
|
||||
:::tip
|
||||
参考图生视频功能的文本提示词,可以用自然语言指定多张图片的组合。但若想有更好的指令遵循效果,**推荐使用“[图1]xxx,[图2]xxx”的方式来指定图片**。
|
||||
示例1:戴着眼镜穿着蓝色T恤的男生和柯基小狗,坐在草坪上,3D卡通风格
|
||||
示例2:[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗,坐在[图3]的草坪上,3D卡通风格
|
||||
|
||||
:::
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
**视频信息==^new^==** `object`
|
||||
输入给模型的视频信息。仅 seedance 2.0 & 2.0 fast 支持输入视频。
|
||||
方舟平台信任 seedance 2.0 及 2.0 fast 模型生成的含人脸视频,您可使用**本账号下近30天内由上述模型生成的含人脸原始视频**,作为输入素材进行二次创作,详情参见 [教程](https://www.volcengine.com/docs/82379/2291680?lang=zh#86c3831f)。
|
||||
|
||||
属性
|
||||
content.**type ** `string` %%require%%
|
||||
输入内容的类型,此处应为`video_url`。
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.**video_url** ** ** `object` %%require%%
|
||||
输入给模型的视频对象。
|
||||
|
||||
属性
|
||||
content.video_url.**url ** `string` %%require%%
|
||||
视频URL、素材 ID。
|
||||
|
||||
* 视频 URL:填入视频的公网 URL。
|
||||
* 素材 ID:用于视频生成的预置素材及虚拟人像视频的 ID,遵循格式:asset://<ASSET_ID\>。可从[素材&虚拟人像库](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128)获取。
|
||||
|
||||
:::tip 传入单个视频要求
|
||||
|
||||
* 视频格式:mp4、mov,支持编码格式见下表。
|
||||
* 分辨率:480p,720p,1080p
|
||||
* 时长:单个视频时长 [2, 15] s,最多传入 3 个参考视频,所有视频总时长不超过 15s。
|
||||
* 尺寸:
|
||||
* 宽高比(宽/高):[0.4, 2.5]
|
||||
* 宽高长度(px):[300, 6000]
|
||||
* 总像素数:[640×640=409600, 2206×946=2086876],即宽和高的乘积符合 [409600, 2086876] 的区间要求。
|
||||
* 大小:单个视频不超过 50 MB。
|
||||
* 帧率 (FPS):[24, 60]
|
||||
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.**role ** `string` `条件必填`
|
||||
视频的位置或用途。当前仅支持 reference_video:参考视频。
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
**音频信息==^new^==** `object`
|
||||
输入给模型的音频信息。仅 seedance 2.0&2.0 fast 支持输入音频。
|
||||
注意不可单独输入音频,应至少包含 1 个参考视频或图片。
|
||||
|
||||
属性
|
||||
content.**type ** `string` %%require%%
|
||||
输入内容的类型,此处应为`audio_url`。
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.**audio_url** ** ** `object` %%require%%
|
||||
输入给模型的音频对象。
|
||||
|
||||
属性
|
||||
content.audio_url.**url ** `string` %%require%%
|
||||
音频 URL 、音频 Base64 编码、素材 ID。
|
||||
|
||||
* 音频 URL:填入音频的公网 URL。
|
||||
* Base64 编码:将本地文件转换为 Base64 编码字符串,然后提交给大模型。遵循格式:`data:audio/<音频格式>;base64,<Base64编码>`,注意 `<音频格式>` 需小写,如 `data:audio/wav;base64,{base64_audio}`。
|
||||
* 素材 ID:用于视频生成的虚拟人的音频素材 ID,遵循格式:asset://<ASSET_ID\>。可从[素材&虚拟人像库](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128)获取。
|
||||
|
||||
:::tip 传入单个音频要求
|
||||
|
||||
* 格式:wav、mp3
|
||||
* 时长:单个音频时长 [2, 15] s,最多传入 3 段参考音频,所有音频总时长不超过 15 s。
|
||||
* 大小:单个音频不超过 15 MB,请求体大小不超过 64 MB。大文件请勿使用Base64编码。
|
||||
|
||||
|
||||
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.**role ** `string` `条件必填`
|
||||
音频的位置或用途。当前仅支持 reference_audio:参考音频。
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
**样片信息 ** `object`
|
||||
基于样片任务 ID,生成正式视频。仅 seedance 1.5 pro 支持该功能。[阅读](https://www.volcengine.com/docs/82379/1366799?lang=zh#5acd28c8)[文档](https://www.volcengine.com/docs/82379/1366799?lang=zh#5acd28c8) 获取 draft 功能的使用教程和注意事项。
|
||||
|
||||
属性
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.**type ** `string` %%require%%
|
||||
输入内容的类型,此处应为 `draft_task`。
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.**draft_task** ** ** `object` %%require%%
|
||||
输入给模型的样片任务。
|
||||
|
||||
属性
|
||||
|
||||
---
|
||||
|
||||
|
||||
content.draft_task.**id ** `string` %%require%%
|
||||
样片任务 ID。平台将自动复用 Draft 视频使用的用户输入(**model、** content.**text、** content.**image_url、generate_audio、seed、ratio、duration、camera_fixed ** ),生成正式视频。其余参数支持指定,不指定将使用本模型的默认值。
|
||||
使用分为两步:Step1: 调用本接口生成 Draft 视频。Step2: 如果确认 Draft 视频符合预期,可基于 Step1 返回的 Draft 视频任务 ID,调用本接口生成最终视频。[阅读文档](https://www.volcengine.com/docs/82379/1366799?lang=zh#5acd28c8) 获取详细教程。
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
**callback_url** `string`
|
||||
填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时,方舟将向此地址推送 POST 请求。
|
||||
回调请求内容结构与[查询任务API](https://www.volcengine.com/docs/82379/1521309)的返回体一致。
|
||||
回调返回的 status 包括以下状态:
|
||||
|
||||
* queued:排队中。
|
||||
* running:任务运行中。
|
||||
* succeeded: 任务成功。(如发送失败,即5秒内没有接收到成功发送的信息,回调三次)
|
||||
* failed:任务失败。(如发送失败,即5秒内没有接收到成功发送的信息,回调三次)
|
||||
* expired:任务超时,即任务处于**运行中或排队中**状态超过过期时间。可通过 **execution_expires_after ** 字段设置过期时间。
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
**return_last_frame** `boolean` `默认值 false`
|
||||
|
||||
* true:返回生成视频的尾帧图像。设置为 `true` 后,可通过 [查询视频生成任务接口](https://www.volcengine.com/docs/82379/1521309) 获取视频的尾帧图像。尾帧图像的格式为 png,宽高像素值与生成的视频保持一致,无水印。
|
||||
使用该参数可实现生成多个连续视频:以上一个生成视频的尾帧作为下一个视频任务的首帧,快速生成多个连续视频,调用示例详见 [教程](https://www.volcengine.com/docs/82379/1366799?lang=zh#141cf7fa)。
|
||||
* false:不返回生成视频的尾帧图像。
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
**service_tier** `string` `默认值 default`
|
||||
> 不支持修改已提交任务的服务等级
|
||||
> seedance 2.0 & 2.0 fast 不支持离线推理
|
||||
|
||||
指定处理本次请求的服务等级类型,枚举值:
|
||||
|
||||
* default:在线推理模式,RPM 和并发数配额较低(详见 [模型列表](https://www.volcengine.com/docs/82379/1330310?lang=zh#2705b333)),适合对推理时效性要求较高的场景。
|
||||
* flex:离线推理模式,TPD 配额更高(详见 [模型列表](https://www.volcengine.com/docs/82379/1330310?lang=zh#2705b333)),价格为在线推理的 50%, 适合对推理时延要求不高的场景。
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
**execution_expires_after ** `integer` `默认值 172800`
|
||||
任务超时阈值。指定任务提交后的过期时间(单位:秒),从 **created at** 时间戳开始计算。默认值 172800 秒,即 48 小时。取值范围:[3600,259200]。
|
||||
不论使用哪种 **service_tier**,都建议根据业务场景设置合适的超时时间。超过该时间后任务会被自动终止,并标记为`expired`状态。
|
||||
|
||||
---
|
||||
|
||||
|
||||
**generate_audio ** `boolean` `默认值 true`
|
||||
> 仅 seedance 2.0 & 2.0 fast、seedance 1.5 pro 支持
|
||||
|
||||
控制生成的视频是否包含与画面同步的声音。
|
||||
|
||||
* true:模型输出的视频包含同步音频。模型会基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:“你记住,以后不可以用手指指月亮。”
|
||||
* false:模型输出的视频为无声视频。
|
||||
|
||||
:::warning
|
||||
生成的有声视频均为单声道,和传入的音频声道数无关。
|
||||
|
||||
:::
|
||||
---
|
||||
|
||||
|
||||
**draft ** `boolean` `默认值 false`
|
||||
> 仅 seedance 1.5 pro 支持
|
||||
|
||||
控制是否开启样片模式。[阅读文档](https://www.volcengine.com/docs/82379/1366799?lang=zh#5acd28c8) 获取使用教程和注意事项。
|
||||
|
||||
* true:开启样片模式,生成一段预览视频,快速验证场景结构、镜头调度、主体动作与 prompt 意图是否符合预期。消耗 token 数较正常视频更少,使用成本更低。
|
||||
* false:关闭样片模式,正常生成一段视频。
|
||||
|
||||
:::tip
|
||||
开启样片模式后,将使用 480p 分辨率生成 Draft 视频(使用其他分辨率会报错),不支持返回尾帧功能,不支持离线推理功能。
|
||||
|
||||
:::
|
||||
---
|
||||
|
||||
|
||||
**tools==^new^==** ** ** `object[]`
|
||||
> 仅 seedance 2.0 & 2.0 fast 支持
|
||||
|
||||
配置模型要调用的工具。
|
||||
|
||||
属性
|
||||
tools.**type ** `string`
|
||||
指定使用的工具类型。
|
||||
|
||||
* web_search:联网搜索工具。[阅读教程](https://www.volcengine.com/docs/82379/1366799?lang=zh#c40ed3ef) 获取详细代码示例。
|
||||
|
||||
:::tip
|
||||
|
||||
* 开启联网搜索后,模型会根据用户的提示词自主判断是否搜索互联网内容(如商品、天气等)。可提升生成视频的时效性,但也会增加一定的时延。
|
||||
* 实际搜索次数可通过 [查询视频生成任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 usage.tool_usage.**web_search** 字段获取,如果为 0 表示未搜索。
|
||||
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
|
||||
**safety_identifier==^new^==** `string`
|
||||
终端用户的唯一标识符,用于协助平台检测您的应用中可能违反火山方舟使用政策的用户。该标识符为英文字符串,需保证对单个用户固定且唯一,长度不超过 64 个字符。推荐传入对用户名、用户 ID 或邮箱进行哈希处理后生成的字符串,避免泄露用户隐私信息。
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
:::warning 部分参数升级说明
|
||||
|
||||
* **对于 resolution、ratio、duration、frames、seed、camera_fixed、watermark 参数,平台升级了参数传入方式,示例如下。所有模型依然兼容支持旧方式。**
|
||||
* 不同模型,可能对应支持不同的参数与取值,详见 [输出视频格式](https://www.volcengine.com/docs/82379/1366799?lang=zh#9fe4cce0)。当输入的参数或取值不符合所选的模型时,该参数将被忽略或触发报错:
|
||||
* 新方式:在 request body 中直接传入参数。此方式为**强校验,** 若参数填写错误,模型会返回错误提示。
|
||||
* 旧方式:在文本提示词后追加 \-\-[parameters]。此方式为**弱校验,** 若参数填写错误,该参数将被忽略或触发报错。
|
||||
|
||||
|
||||
:::
|
||||
**新方式(推荐):在 request body 中直接传入参数**
|
||||
```JSON
|
||||
...
|
||||
// Specify the aspect ratio of the generated video as 16:9, duration as 5 seconds, resolution as 720p, seed as 11, and include a watermark. The camera is not fixed.
|
||||
"model": "doubao-seedance-1-5-pro-251215",
|
||||
"content": [
|
||||
{
|
||||
"type": "text",
|
||||
"text": "小猫对着镜头打哈欠"
|
||||
}
|
||||
],
|
||||
// All parameters must be written in full; abbreviations are not supported
|
||||
"resolution": "720p",
|
||||
"ratio":"16:9",
|
||||
"duration": 5,
|
||||
// "frames": 29, Either duration or frames is required
|
||||
"seed": 11,
|
||||
"camera_fixed": false,
|
||||
"watermark": true
|
||||
...
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
**旧方式:在文本提示词后追加 \-\-[parameters]**
|
||||
```JSON
|
||||
...
|
||||
// Specify the aspect ratio of the generated video as 16:9, duration as 5 seconds, resolution as 720p, seed as 11, and include a watermark. The camera is not fixed.
|
||||
"model": "doubao-seedance-1-5-pro-251215",
|
||||
"content": [
|
||||
{
|
||||
"type": "text",
|
||||
"text": "小猫对着镜头打哈欠 --rs 720p --rt 16:9 --dur 5 --seed 11 --cf false --wm true"
|
||||
// "text": "小猫对着镜头打哈欠 --resolution 720p --ratio 16:9 --duration 5 --seed 11 --camerafixed false --watermark true"
|
||||
}
|
||||
]
|
||||
...
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
**resolution ** `string`
|
||||
> seedance 2.0 & 2.0 fast、seedance 1.5 pro、seedance 1.0 lite 默认值:`720p`
|
||||
> seedance 1.0 pro & pro\-fast 默认值:`1080p`
|
||||
|
||||
视频分辨率,枚举值:
|
||||
|
||||
* 480p
|
||||
* 720p
|
||||
* 1080p:seedance 1.0 lite 参考图场景、seedance 2.0 & 2.0 fast 不支持
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
**ratio ** `string`
|
||||
> seedance 2.0 & 2.0 fast、seedance 1.5 pro 默认值为 `adaptive`
|
||||
> seedance 1.0 lite 参考图场景默认值为 `16:9`
|
||||
> 其他模型:文生视频默认值 `16:9`,图生视频默认值 `adaptive`
|
||||
|
||||
生成视频的宽高比例。不同宽高比对应的宽高像素值见下方表格。
|
||||
|
||||
* 16:9
|
||||
* 4:3
|
||||
* 1:1
|
||||
* 3:4
|
||||
* 9:16
|
||||
* 21:9
|
||||
* adaptive:根据输入自动选择最合适的宽高比(详见下文说明)
|
||||
|
||||
:::warning **adaptive ** 适配规则
|
||||
当配置 **ratio** 为 `adaptive` 时,模型会根据生成场景自动适配宽高比;实际生成的视频宽高比可通过 [查询视频生成任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 **ratio** 字段获取。
|
||||
**支持模型:**
|
||||
|
||||
* seedance 2.0 & 2.0 fast、seedance 1.5 Pro 支持
|
||||
* 其他模型仅图生视频场景支持,注意 seedance 1.0 lite 参考图场景不支持。
|
||||
|
||||
**取值规则:**
|
||||
|
||||
* 文生视频:根据输入的提示词,智能选择最合适的宽高比。
|
||||
* 首帧 / 首尾帧生视频:根据上传的首帧图片比例,自动选择最接近的宽高比。
|
||||
* 多模态参考生视频:根据用户提示词意图判断,如果是首帧生视频/编辑视频/延长视频,以该图片/视频为准选择最接近的宽高比;否则,以传入的第一个媒体文件为准(优先级:视频>图片)选择最接近的宽高比。
|
||||
|
||||
:::
|
||||
|
||||
|
||||
不同宽高比对应的宽高像素值
|
||||
Note:图生视频,选择的宽高比与您上传的图片宽高比不一致时,方舟会对您的图片进行裁剪,裁剪时会居中裁剪,详细规则见 [图片裁剪规则](https://www.volcengine.com/docs/82379/1366799?lang=zh#f76aafc8)。
|
||||
|
||||
|分辨率 |宽高比|宽高像素值|宽高像素值|\
|
||||
| | |seedance 1.0 系列 |seedance 1.5 pro|\
|
||||
| | | |seedance 2.0 & 2.0 fast |
|
||||
|---|---|---|---|
|
||||
|480p |16:9 |864×480 |864×496 |
|
||||
|^^|4:3 |736×544 |752×560 |
|
||||
|^^|1:1 |640×640 |640×640 |
|
||||
|^^|3:4 |544×736 |560×752 |
|
||||
|^^|9:16 |480×864 |496×864 |
|
||||
|^^|21:9 |960×416 |992×432 |
|
||||
|720p |16:9 |1248×704 |1280×720 |
|
||||
|^^|4:3 |1120×832 |1112×834 |
|
||||
|^^|1:1 |960×960 |960×960 |
|
||||
|^^|3:4 |832×1120 |834×1112 |
|
||||
|^^|9:16 |704×1248 |720×1280 |
|
||||
|^^|21:9 |1504×640 |1470×630 |
|
||||
|1080p |16:9 |1920×1088 |1920×1080 |\
|
||||
|> 1.0 lite 参考图场景不支持,seedance 2.0 & 2.0 fast不支持 | | | |
|
||||
|^^|4:3 |1664×1248 |1664×1248 |
|
||||
|^^|1:1 |1440×1440 |1440×1440 |
|
||||
|^^|3:4 |1248×1664 |1248×1664 |
|
||||
|^^|9:16 |1088×1920 |1080×1920 |
|
||||
|^^|21:9 |2176×928 |2206×946 |
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
**duration** `integer` `默认值 5`
|
||||
> duration 和 frames 二选一即可,frames 的优先级高于 duration。如果您希望生成整数秒的视频,建议指定 duration。
|
||||
|
||||
生成视频时长,仅支持整数,单位:秒。
|
||||
|
||||
* seedance 1.0 pro、seedance 1.0 pro fast、seedance 1.0 lite: [2, 12] s。
|
||||
* seedance 1.5 pro: [4,12] 或设置为`-1`
|
||||
* seedance 2.0 & 2.0 fast: [4,15] 或设置为`-1`
|
||||
|
||||
:::warning
|
||||
seedance 2.0 & 2.0 fast、seedance 1.5 pro 支持两种配置方法
|
||||
|
||||
* 指定具体时长:支持有效范围内的任一整数。
|
||||
* 智能指定:设置为 `-1`,表示由模型在有效范围内自主选择合适的视频长度(整数秒)。实际生成视频的时长可通过 [查询视频生成任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 **duration** 字段获取。注意视频时长与计费相关,请谨慎设置。
|
||||
|
||||
|
||||
:::
|
||||
---
|
||||
|
||||
|
||||
**frames** `integer`
|
||||
> seedance 2.0 & 2.0 fast、seedance 1.5 pro 暂不支持
|
||||
> duration 和 frames 二选一即可,frames 的优先级高于 duration。如果您希望生成小数秒的视频,建议指定 frames。
|
||||
|
||||
生成视频的帧数。通过指定帧数,可以灵活控制生成视频的长度,生成小数秒的视频。
|
||||
由于 frames 的取值限制,仅能支持有限小数秒,您需要根据公式推算最接近的帧数。
|
||||
|
||||
* 计算公式:帧数 = 时长 × 帧率(24)。
|
||||
* 取值范围:支持 [29, 289] 区间内所有满足 `25 + 4n` 格式的整数值,其中 n 为正整数。
|
||||
|
||||
例如:假设需要生成 2.4 秒的视频,帧数=2.4×24=57.6。由于 frames 不支持 57.6,此时您只能选择一个最接近的值。根据 25+4n 计算出最接近的帧数为 57,实际生成的视频为 57/24=2.375 秒。
|
||||
|
||||
---
|
||||
|
||||
|
||||
**seed** `integer` `默认值 -1`
|
||||
种子整数,用于控制生成内容的随机性。
|
||||
取值范围:[\-1, 2^32\-1]之间的整数。
|
||||
:::warning
|
||||
|
||||
* 相同的请求下,模型收到不同的seed值,如:不指定seed值或令seed取值为\-1(会使用随机数替代)、或手动变更seed值,将生成不同的结果。
|
||||
* 相同的请求下,模型收到相同的seed值,会生成类似的结果,但不保证完全一致。
|
||||
|
||||
|
||||
:::
|
||||
---
|
||||
|
||||
|
||||
**camera_fixed** `boolean` `默认值 false`
|
||||
> 参考图场景不支持,seedance 2.0 & 2.0 fast 暂不支持
|
||||
|
||||
是否固定摄像头。枚举值:
|
||||
|
||||
* true:固定摄像头。平台会在用户提示词中追加固定摄像头,实际效果不保证。
|
||||
* false:不固定摄像头。
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
**watermark** `boolean` `默认值 false`
|
||||
生成视频是否包含水印。枚举值:
|
||||
|
||||
* false:不含水印。
|
||||
* true:含有水印。
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
<span id="oCS1tULg"></span>
|
||||
## 响应参数
|
||||
> 跳转 [请求参数](#RxN8G2nH)
|
||||
|
||||
**id ** `string`
|
||||
视频生成任务 ID 。仅保存 7 天(从 **created at** 时间戳开始计算),超时后将自动清除。
|
||||
|
||||
* 设置`"draft": true`,为 Draft 视频任务 ID。
|
||||
* 设置 `"draft": false`,为正常视频任务 ID。
|
||||
|
||||
创建视频生成任务为异步接口,获取 ID 后,需要通过 [查询视频生成任务 API](https://www.volcengine.com/docs/82379/1521309) 来查询视频生成任务的状态。任务成功后,会输出生成视频的`video_url`。
|
||||
|
||||
|
||||
@ -4,6 +4,71 @@
|
||||
|
||||
---
|
||||
|
||||
## 2026-04-17 — v0.18.3: 版权报错友好提示 + 图片删除即梦式连续重命名
|
||||
|
||||
**状态**: ✅ 已完成 | **验收**: 14 个自动化测试全过(11 单元 + 3 E2E)
|
||||
|
||||
### 变更内容
|
||||
|
||||
#### 后端
|
||||
1. **版权限制错误友好提示** — `OutputVideoSensitiveContentDetected.PolicyViolation`(漫威等知名 IP 触发的版权拦截)加中文错误码映射:"生成的视频涉及版权限制内容(如知名IP、名人肖像等),已被系统拦截,请修改提示词后重试"。精确匹配 API 返回的 code,不影响父级 `OutputVideoSensitiveContentDetected`(敏感内容)的现有提示
|
||||
|
||||
#### 前端
|
||||
2. **图片删除即梦式连续重命名** — 现有逻辑:删图片2 后,图片3 保持原名称,再上传新图会出现"两个图片2"。修复后:
|
||||
- `inputBar.ts::removeReference` 删除后,同类型(图片/视频/音频)剩余引用按顺序连续重命名(图片1/图片2/图片3 连续无空位)
|
||||
- 用 `DOMParser` 解析 editorHtml,找到对应 `data-ref-id` 的 @mention span,更新 textContent(提示词栏里的 `@图片3` 自动变 `@图片2`)
|
||||
- 缩略图区和提示词栏视觉同步刷新
|
||||
|
||||
#### 测试覆盖
|
||||
- **Vitest 单元测试 11 个**(test/unit/removeReferenceRelabeling.test.ts):图片三场景、视频/音频独立编号、空 editorHtml、无 @mention、传入无效 id、部分 @、连续快速删除等边界
|
||||
- **Playwright E2E 3 个**(test/e2e/bug2-rename.spec.ts):真实浏览器验证上传 3 张图 → 删中间 → 再上传,编号不冲突
|
||||
|
||||
#### 文档整理
|
||||
3. **AirDrama 根目录归档**:8 个过期 MD 文档移至 `archive/`(_settle_payment 双重结算/v0.15.1 部署/公告HTML/迁移到火山/全平台账务审计/火山耗时分析/图片上传blob/迭代需求_20260320)
|
||||
4. **video-shuoshan/docs 归档**:6 个过期文档移至 `docs/archive/`(celery 轮询修复/design-review/PRD/test-report/两版旧 API 文档)
|
||||
5. **新增 1080P Plan**:`AirDrama/1080P分辨率支持开发计划.md`,对照官方 API 文档完成 3 轮审查修正(21:9 像素值错误、_settle_payment 遗漏、VideoDetailModal 重新编辑、regenerate、API 响应 6 处、serializer 命名、GenerationRecord.resolution 字段已存在等),标注 5 项已知计费缺陷
|
||||
|
||||
### 变更文件
|
||||
- `backend/utils/airdrama_client.py` — ERROR_MESSAGES 加 PolicyViolation 映射
|
||||
- `web/src/store/inputBar.ts` — removeReference 重写(即梦逻辑 + editorHtml 同步)
|
||||
- `web/test/unit/removeReferenceRelabeling.test.ts` — 11 个单元测试(新增)
|
||||
- `web/test/e2e/bug2-rename.spec.ts` — 3 个 E2E 测试(新增)
|
||||
- `AirDrama/1080P分辨率支持开发计划.md` — 1080P 开发 Plan(新增)
|
||||
- `AirDrama/版本管理.md` — 添加 v0.18.3 记录
|
||||
- `AirDrama/项目总览与待办.md` — 完成项 + 1080P P0 待办
|
||||
- 16 个 MD 文档归档到两个 archive 目录
|
||||
|
||||
### 触发原因
|
||||
- 用户反馈:漫威素材生成失败时显示英文错误,不友好
|
||||
- 用户反馈:删除中间图片后再上传会出现重复编号(参考即梦交互)
|
||||
- 火山 2026-04-16 1080P 上线,需提前规划开发
|
||||
|
||||
---
|
||||
|
||||
## 2026-04-13 — v0.18.2: 资产页修复 + 重新编辑素材泄漏 + 音频校验
|
||||
|
||||
**状态**: ✅ 已完成 | **验收**: 待测试
|
||||
|
||||
### 变更内容
|
||||
|
||||
#### 前端
|
||||
1. **资产页素材库引用不可查看** — Admin/Team 资产页的 `assetVideoToTask` 直接用了 `asset://` 协议 URL 作为 `previewUrl`,浏览器无法加载。改为检测 `asset://` 后使用 `thumb_url`(真实 TOS 缩略图地址),并标记 `isAssetRef`。同步修复 `BackendTask` 和 `AssetVideo` 类型定义补 `thumb_url` 字段
|
||||
2. **重新编辑素材泄漏** — `reEdit()` 把素材库引用混入 `references` 数组(注释写已过滤但实际没有),用户删除 @标签后旧素材仍通过 `filesToUpload` 路径发出。修复:`reEdit/regenerate` 加 `.filter(!isAssetRef)`;`PromptInput.extractText` 每次 DOM 变化时实时同步 `assetMentions` store
|
||||
3. **音频不能作为唯一参考素材** — Seedance API 不支持"纯音频"和"文本+音频"。`canSubmit()` 去掉 `!hasText` 条件,同时检查 `references` 和 `assetMentions` 中的图片/视频;Toolbar 点击禁用按钮弹 toast 提示原因
|
||||
4. **素材库引用缩略图烂图** — `pollStatus` 跨项目素材保护
|
||||
5. **音频 ♫ 符号溢出** — 改用 CSS `::before` 渲染,不再污染 prompt 文本
|
||||
|
||||
### 变更文件
|
||||
- `web/src/pages/AdminAssetsPage.tsx` — isAssetUrl + thumb_url 处理
|
||||
- `web/src/pages/TeamAssetsPage.tsx` — 同上
|
||||
- `web/src/types/index.ts` — BackendTask/AssetVideo 补 thumb_url
|
||||
- `web/src/store/generation.ts` — reEdit/regenerate 过滤 isAssetRef
|
||||
- `web/src/components/PromptInput.tsx` — extractText 同步 assetMentions
|
||||
- `web/src/store/inputBar.ts` — canSubmit 音频校验增强
|
||||
- `web/src/components/Toolbar.tsx` — 音频受限 toast 提示
|
||||
|
||||
---
|
||||
|
||||
## 2026-03-19 — v0.9.7: 登录风控第二期 — IP归属地解析 + 异常检测 + 飞书告警 + 自动封禁
|
||||
|
||||
**状态**: ✅ 已完成 | **验收**: ✅ 通过(本地验证,IP138 在线 API 需部署至阿里云后验证)
|
||||
|
||||
65
docs/todo/提示词AI优化功能.md
Normal file
65
docs/todo/提示词AI优化功能.md
Normal file
@ -0,0 +1,65 @@
|
||||
# 提示词 AI 优化功能
|
||||
|
||||
**状态**:待开发
|
||||
**创建日期**:2026-04-17
|
||||
|
||||
## 需求背景
|
||||
|
||||
用户写提示词时,经常写得过于简单或不符合 Seedance 2.0 的提示词规范(如没用「图片n」引用素材、缺少核心要素、镜头语言模糊等),导致生成效果不理想。
|
||||
|
||||
引入火山官方的 SKILL.md(Seedance 2.0 Prompt Optimizer)能力,让用户在写完提示词后一键优化。
|
||||
|
||||
## 功能设计
|
||||
|
||||
### 用户视角
|
||||
1. 用户在提示词输入框输入原始提示词(带 @素材引用)
|
||||
2. 点击输入框旁的「AI 优化」按钮
|
||||
3. 弹出预览弹窗,显示优化后的提示词
|
||||
4. 用户点「采纳」→ 替换原提示词;点「取消」→ 保留原文
|
||||
5. 消耗一定 token 数(计入团队 token 池)
|
||||
|
||||
### 技术方案
|
||||
|
||||
**后端**
|
||||
- 新接口:`POST /api/v1/prompt/optimize`
|
||||
- 入参:`prompt`(原始提示词,含 `@素材` 标记)、`asset_refs`(素材引用列表:label + type + url)
|
||||
- 调用豆包模型(推荐 `doubao-seed-2.0` 最新版本,具体 model id 需确认)
|
||||
- System prompt:基于 SKILL.md 改造成**一次性输出**模式(不做多轮交互)
|
||||
- 返回:`optimized_prompt`(优化后的文本)+ `token_used`(消耗 token 数)
|
||||
- 同时扣减团队 token 池
|
||||
|
||||
**前端**
|
||||
- `PromptInput` 组件右侧加「AI 优化」按钮(带 ✨ 图标)
|
||||
- 点击后:loading 状态 → 调用后端接口 → 弹出 `PromptOptimizeModal` 预览弹窗
|
||||
- 弹窗显示:原始 vs 优化对比、token 消耗提示、采纳/取消按钮
|
||||
- 采纳后:把优化结果写回 editor(保持 @mention 标签正确渲染)
|
||||
|
||||
**SKILL.md 改造要点**
|
||||
- 去掉 Step 0(主动引导提问)→ 一次输入一次输出
|
||||
- 去掉 Step 3 的「多选模板交互」→ 如遇歧义/冲突,在输出里以备注形式标注(如 `【注:检测到 X 冲突,已按 Y 处理】`)
|
||||
- 保留 Step 2(素材自动映射 `@图N`)、Step 4(结构化输出:优化后提示词 / 优化问题 / 相关原则)
|
||||
|
||||
## 计费设计
|
||||
- 提示词优化和视频生成共用**同一个 token 池**(用户已熟悉的计费机制)
|
||||
- 不单独限额,按实际 token 消耗扣减
|
||||
- 前端展示:"本次优化消耗约 X token"
|
||||
|
||||
## 模型选择
|
||||
- **首选**:豆包 2.0 系列最强模型(需查火山文档确认最新 model id)
|
||||
- 备选:`doubao-1-5-pro-32k`(成本更低,任务够用)
|
||||
|
||||
## 待确认事项
|
||||
- [ ] 豆包 2.0 系列当前最强模型的具体 model id
|
||||
- [ ] Token 池扣减逻辑是否需要团队/个人双重配额
|
||||
- [ ] 优化失败时(LLM 报错、token 超限)的前端兜底提示
|
||||
|
||||
## 验收标准
|
||||
1. 用户输入粗糙提示词(如「美女跳舞」)→ 优化后符合 SKILL.md 的三段式结构(全局设定 / 时间线脚本 / 质感风格与约束)
|
||||
2. 带 `@素材` 的提示词 → 优化后正确使用 `@图1/@图2/@视频1` 等标记
|
||||
3. 冲突/缺失场景 → 在输出中以备注标明,不擅自填充
|
||||
4. Token 消耗正确扣减到团队池
|
||||
5. 用户可在弹窗中选择采纳或取消
|
||||
|
||||
## 参考文件
|
||||
- SKILL.md(火山提供的原始技能文件)
|
||||
- `docs/API文档/seedance 2.0 系列教程.MD` 第 2152 行起的「提示词技巧」部分
|
||||
@ -218,9 +218,43 @@ export const useInputBarStore = create<InputBarState>((set, get) => ({
|
||||
},
|
||||
removeReference: (id) => {
|
||||
const state = get();
|
||||
const ref = state.references.find((r) => r.id === id);
|
||||
if (ref) URL.revokeObjectURL(ref.previewUrl);
|
||||
set({ references: state.references.filter((r) => r.id !== id) });
|
||||
const removedRef = state.references.find((r) => r.id === id);
|
||||
if (!removedRef) return;
|
||||
if (removedRef.previewUrl) URL.revokeObjectURL(removedRef.previewUrl);
|
||||
|
||||
// 删除后同类型的剩余引用按顺序重新编号(即梦逻辑:保持 1/2/3 连续)
|
||||
const remaining = state.references.filter((r) => r.id !== id);
|
||||
const labelPrefix = removedRef.type === 'image' ? '图片' : removedRef.type === 'video' ? '视频' : '音频';
|
||||
const labelUpdates = new Map<string, string>(); // refId -> newLabel
|
||||
let idx = 1;
|
||||
const relabeled = remaining.map((r) => {
|
||||
if (r.type !== removedRef.type) return r;
|
||||
const newLabel = `${labelPrefix}${idx++}`;
|
||||
if (r.label !== newLabel) labelUpdates.set(r.id, newLabel);
|
||||
return r.label === newLabel ? r : { ...r, label: newLabel };
|
||||
});
|
||||
|
||||
// 同步更新 editorHtml 里对应 refId 的 @mention span 文本
|
||||
let newEditorHtml = state.editorHtml;
|
||||
if (labelUpdates.size > 0 && newEditorHtml) {
|
||||
const doc = new DOMParser().parseFromString(`<div>${newEditorHtml}</div>`, 'text/html');
|
||||
const container = doc.body.firstChild as HTMLElement | null;
|
||||
if (container) {
|
||||
container.querySelectorAll('[data-ref-id]').forEach((span) => {
|
||||
const el = span as HTMLElement;
|
||||
const refId = el.dataset.refId;
|
||||
if (refId && labelUpdates.has(refId)) {
|
||||
const newLabel = labelUpdates.get(refId)!;
|
||||
// span 结构:[icon/img] + atHidden(@) + textNode(label)
|
||||
const labelNode = [...el.childNodes].reverse().find((n) => n.nodeType === Node.TEXT_NODE);
|
||||
if (labelNode) labelNode.textContent = newLabel;
|
||||
}
|
||||
});
|
||||
newEditorHtml = container.innerHTML;
|
||||
}
|
||||
}
|
||||
|
||||
set({ references: relabeled, editorHtml: newEditorHtml });
|
||||
},
|
||||
clearReferences: () => {
|
||||
const state = get();
|
||||
|
||||
133
web/test/e2e/bug2-rename.spec.ts
Normal file
133
web/test/e2e/bug2-rename.spec.ts
Normal file
@ -0,0 +1,133 @@
|
||||
/**
|
||||
* Bug 2 E2E 验证:图片删除后即梦式连续重命名
|
||||
* 针对本地开发环境(localhost:5173 + 127.0.0.1:8000)
|
||||
*/
|
||||
import { test, expect, Page } from '@playwright/test';
|
||||
|
||||
const BASE_URL = 'http://localhost:5173';
|
||||
const API_URL = 'http://127.0.0.1:8000';
|
||||
const USERNAME = 'admin';
|
||||
const PASSWORD = 'admin123';
|
||||
|
||||
const TEST_IMAGES_DIR = 'C:/Users/Air-work/AppData/Local/Temp/bug2test';
|
||||
const IMG_RED = `${TEST_IMAGES_DIR}/test_red.png`;
|
||||
const IMG_GREEN = `${TEST_IMAGES_DIR}/test_green.png`;
|
||||
const IMG_BLUE = `${TEST_IMAGES_DIR}/test_blue.png`;
|
||||
|
||||
async function login(page: Page) {
|
||||
const resp = await page.request.post(`${API_URL}/api/v1/auth/login`, {
|
||||
data: { username: USERNAME, password: PASSWORD },
|
||||
});
|
||||
if (!resp.ok()) {
|
||||
const errText = await resp.text();
|
||||
console.log('LOGIN FAILED:', resp.status(), errText);
|
||||
}
|
||||
expect(resp.ok()).toBeTruthy();
|
||||
const body = await resp.json();
|
||||
|
||||
await page.goto(BASE_URL);
|
||||
await page.evaluate(({ access, refresh }) => {
|
||||
localStorage.setItem('access_token', access);
|
||||
localStorage.setItem('refresh_token', refresh);
|
||||
}, { access: body.tokens.access, refresh: body.tokens.refresh });
|
||||
await page.goto(`${BASE_URL}/app`);
|
||||
await page.waitForTimeout(1500);
|
||||
|
||||
// 关闭初次登录可能出现的公告弹窗
|
||||
const knowBtn = page.getByRole('button', { name: /我知道了|知道了|关闭/ }).first();
|
||||
if (await knowBtn.isVisible().catch(() => false)) {
|
||||
await knowBtn.click();
|
||||
await page.waitForTimeout(300);
|
||||
}
|
||||
}
|
||||
|
||||
test.describe.serial('Bug 2: 图片删除后即梦式连续重命名', () => {
|
||||
test('上传 3 张图 → 删除图片2 → 图片3 变为图片2', async ({ page }) => {
|
||||
await login(page);
|
||||
|
||||
// 上传 3 张图
|
||||
const fileInput = page.locator('input[type="file"]').first();
|
||||
await fileInput.setInputFiles([IMG_RED, IMG_GREEN, IMG_BLUE]);
|
||||
await page.waitForTimeout(2000); // 等图片校验和 ref 添加完成
|
||||
|
||||
// 展开缩略图堆栈(hover 触发)
|
||||
const thumbRow = page.locator('[class*="thumbRow"]').first();
|
||||
await thumbRow.hover();
|
||||
await page.waitForTimeout(500);
|
||||
|
||||
// 验证上传后初始状态:图片1/图片2/图片3
|
||||
const labelsInitial = await page.locator('[class*="thumbLabel"]').allTextContents();
|
||||
console.log('初始标签:', labelsInitial);
|
||||
expect(labelsInitial).toEqual(['图片1', '图片2', '图片3']);
|
||||
|
||||
// 点第 2 张图的删除按钮
|
||||
const secondThumb = page.locator('[class*="thumbItem"]').nth(1);
|
||||
await secondThumb.hover();
|
||||
await secondThumb.locator('[class*="thumbClose"]').click({ force: true });
|
||||
await page.waitForTimeout(500);
|
||||
|
||||
// 验证重命名后:图片1/图片2(原图片3)
|
||||
await thumbRow.hover();
|
||||
await page.waitForTimeout(300);
|
||||
const labelsAfterDelete = await page.locator('[class*="thumbLabel"]').allTextContents();
|
||||
console.log('删除图片2后:', labelsAfterDelete);
|
||||
expect(labelsAfterDelete).toEqual(['图片1', '图片2']);
|
||||
expect(labelsAfterDelete.length).toBe(2);
|
||||
});
|
||||
|
||||
test('删除图片2 后再上传 1 张 → 新图是图片3(不和现有冲突)', async ({ page }) => {
|
||||
await login(page);
|
||||
|
||||
// 上传 3 张
|
||||
const fileInput = page.locator('input[type="file"]').first();
|
||||
await fileInput.setInputFiles([IMG_RED, IMG_GREEN, IMG_BLUE]);
|
||||
await page.waitForTimeout(2000);
|
||||
|
||||
const thumbRow = page.locator('[class*="thumbRow"]').first();
|
||||
await thumbRow.hover();
|
||||
await page.waitForTimeout(500);
|
||||
|
||||
// 删除第 2 张
|
||||
const secondThumb = page.locator('[class*="thumbItem"]').nth(1);
|
||||
await secondThumb.hover();
|
||||
await secondThumb.locator('[class*="thumbClose"]').click({ force: true });
|
||||
await page.waitForTimeout(500);
|
||||
|
||||
// 再上传 1 张
|
||||
await fileInput.setInputFiles([IMG_RED]);
|
||||
await page.waitForTimeout(2000);
|
||||
|
||||
// 验证:原图片1、原图片3(已改名图片2)、新图片3
|
||||
await thumbRow.hover();
|
||||
await page.waitForTimeout(300);
|
||||
const finalLabels = await page.locator('[class*="thumbLabel"]').allTextContents();
|
||||
console.log('删除后再上传:', finalLabels);
|
||||
expect(finalLabels).toEqual(['图片1', '图片2', '图片3']);
|
||||
// 无重复编号
|
||||
expect(new Set(finalLabels).size).toBe(finalLabels.length);
|
||||
});
|
||||
|
||||
test('删除第 1 张 → 剩余图片全部前移', async ({ page }) => {
|
||||
await login(page);
|
||||
|
||||
const fileInput = page.locator('input[type="file"]').first();
|
||||
await fileInput.setInputFiles([IMG_RED, IMG_GREEN, IMG_BLUE]);
|
||||
await page.waitForTimeout(2000);
|
||||
|
||||
const thumbRow = page.locator('[class*="thumbRow"]').first();
|
||||
await thumbRow.hover();
|
||||
await page.waitForTimeout(500);
|
||||
|
||||
// 删除第 1 张
|
||||
const firstThumb = page.locator('[class*="thumbItem"]').nth(0);
|
||||
await firstThumb.hover();
|
||||
await firstThumb.locator('[class*="thumbClose"]').click({ force: true });
|
||||
await page.waitForTimeout(500);
|
||||
|
||||
await thumbRow.hover();
|
||||
await page.waitForTimeout(300);
|
||||
const labels = await page.locator('[class*="thumbLabel"]').allTextContents();
|
||||
console.log('删除图片1后:', labels);
|
||||
expect(labels).toEqual(['图片1', '图片2']);
|
||||
});
|
||||
});
|
||||
234
web/test/unit/removeReferenceRelabeling.test.ts
Normal file
234
web/test/unit/removeReferenceRelabeling.test.ts
Normal file
@ -0,0 +1,234 @@
|
||||
/**
|
||||
* Bug 2 fix verification: 删除引用后,同类型剩余引用连续重命名(即梦逻辑)
|
||||
* 同时同步更新 editorHtml 中 @mention span 的文本。
|
||||
*/
|
||||
import { describe, it, expect, beforeEach } from 'vitest';
|
||||
import { useInputBarStore } from '../../src/store/inputBar';
|
||||
|
||||
function mockFile(name: string, type = 'image/jpeg'): File {
|
||||
return new File(['mock'], name, { type });
|
||||
}
|
||||
|
||||
function mockRef(id: string, type: 'image' | 'video' | 'audio', label: string) {
|
||||
return {
|
||||
id,
|
||||
file: mockFile(`${id}.${type === 'image' ? 'jpg' : type === 'video' ? 'mp4' : 'mp3'}`),
|
||||
type,
|
||||
previewUrl: `blob:${id}`,
|
||||
label,
|
||||
};
|
||||
}
|
||||
|
||||
function mentionSpan(refId: string, refType: string, label: string): string {
|
||||
return `<span data-ref-id="${refId}" data-ref-type="${refType}" class="mention" contenteditable="false"><span style="font-size:0;width:0;overflow:hidden;display:inline">@</span>${label}</span>`;
|
||||
}
|
||||
|
||||
describe('removeReference — 即梦式连续重命名', () => {
|
||||
beforeEach(() => {
|
||||
useInputBarStore.getState().reset();
|
||||
});
|
||||
|
||||
describe('图片重命名', () => {
|
||||
it('删除图片2 后,图片3 重命名为图片2(references + editorHtml 同步)', () => {
|
||||
const refs = [
|
||||
mockRef('ref_1', 'image', '图片1'),
|
||||
mockRef('ref_2', 'image', '图片2'),
|
||||
mockRef('ref_3', 'image', '图片3'),
|
||||
];
|
||||
const editorHtml =
|
||||
`开场 ${mentionSpan('ref_1', 'image', '图片1')} 和 ${mentionSpan('ref_2', 'image', '图片2')} 在和 ${mentionSpan('ref_3', 'image', '图片3')} 讲话`;
|
||||
|
||||
useInputBarStore.setState({ references: refs, editorHtml });
|
||||
useInputBarStore.getState().removeReference('ref_2');
|
||||
|
||||
const state = useInputBarStore.getState();
|
||||
expect(state.references).toHaveLength(2);
|
||||
expect(state.references[0].id).toBe('ref_1');
|
||||
expect(state.references[0].label).toBe('图片1');
|
||||
expect(state.references[1].id).toBe('ref_3');
|
||||
expect(state.references[1].label).toBe('图片2'); // 原图片3 → 图片2
|
||||
|
||||
// editorHtml 里 ref_3 的 textNode 应该变成 "图片2"
|
||||
expect(state.editorHtml).toContain('data-ref-id="ref_3"');
|
||||
expect(state.editorHtml).toMatch(/data-ref-id="ref_3"[^>]*>[\s\S]*?图片2<\/span>/);
|
||||
// ref_1 保持 "图片1"
|
||||
expect(state.editorHtml).toMatch(/data-ref-id="ref_1"[^>]*>[\s\S]*?图片1<\/span>/);
|
||||
});
|
||||
|
||||
it('删除图片1 后,图片2、图片3 重命名为图片1、图片2', () => {
|
||||
const refs = [
|
||||
mockRef('ref_1', 'image', '图片1'),
|
||||
mockRef('ref_2', 'image', '图片2'),
|
||||
mockRef('ref_3', 'image', '图片3'),
|
||||
];
|
||||
const editorHtml = `${mentionSpan('ref_2', 'image', '图片2')} ${mentionSpan('ref_3', 'image', '图片3')}`;
|
||||
|
||||
useInputBarStore.setState({ references: refs, editorHtml });
|
||||
useInputBarStore.getState().removeReference('ref_1');
|
||||
|
||||
const state = useInputBarStore.getState();
|
||||
expect(state.references[0].label).toBe('图片1'); // ref_2
|
||||
expect(state.references[1].label).toBe('图片2'); // ref_3
|
||||
expect(state.editorHtml).toMatch(/data-ref-id="ref_2"[^>]*>[\s\S]*?图片1<\/span>/);
|
||||
expect(state.editorHtml).toMatch(/data-ref-id="ref_3"[^>]*>[\s\S]*?图片2<\/span>/);
|
||||
});
|
||||
|
||||
it('删除最后一张图片(唯一图片)— references 清空,editorHtml 不变', () => {
|
||||
const refs = [mockRef('ref_1', 'image', '图片1')];
|
||||
const editorHtml = `内容 ${mentionSpan('ref_1', 'image', '图片1')} 尾部`;
|
||||
|
||||
useInputBarStore.setState({ references: refs, editorHtml });
|
||||
useInputBarStore.getState().removeReference('ref_1');
|
||||
|
||||
const state = useInputBarStore.getState();
|
||||
expect(state.references).toHaveLength(0);
|
||||
// remaining 为空 → labelUpdates 为空 → 跳过 DOM 操作 → editorHtml 原样保留
|
||||
expect(state.editorHtml).toBe(editorHtml);
|
||||
});
|
||||
});
|
||||
|
||||
describe('视频/音频独立编号', () => {
|
||||
it('图片和视频混合时,删图片只重命名图片,视频不动', () => {
|
||||
const refs = [
|
||||
mockRef('ref_1', 'image', '图片1'),
|
||||
mockRef('ref_2', 'image', '图片2'),
|
||||
mockRef('ref_3', 'video', '视频1'),
|
||||
];
|
||||
const editorHtml =
|
||||
`${mentionSpan('ref_1', 'image', '图片1')} ${mentionSpan('ref_2', 'image', '图片2')} ${mentionSpan('ref_3', 'video', '视频1')}`;
|
||||
|
||||
useInputBarStore.setState({ references: refs, editorHtml });
|
||||
useInputBarStore.getState().removeReference('ref_1');
|
||||
|
||||
const state = useInputBarStore.getState();
|
||||
expect(state.references).toHaveLength(2);
|
||||
expect(state.references[0].label).toBe('图片1'); // 原图片2
|
||||
expect(state.references[1].label).toBe('视频1'); // 视频不变
|
||||
expect(state.editorHtml).toMatch(/data-ref-id="ref_2"[^>]*>[\s\S]*?图片1<\/span>/);
|
||||
expect(state.editorHtml).toMatch(/data-ref-id="ref_3"[^>]*>[\s\S]*?视频1<\/span>/);
|
||||
});
|
||||
|
||||
it('删除视频2,视频3 重命名为视频2', () => {
|
||||
const refs = [
|
||||
mockRef('ref_1', 'video', '视频1'),
|
||||
mockRef('ref_2', 'video', '视频2'),
|
||||
mockRef('ref_3', 'video', '视频3'),
|
||||
];
|
||||
const editorHtml = `${mentionSpan('ref_3', 'video', '视频3')}`;
|
||||
|
||||
useInputBarStore.setState({ references: refs, editorHtml });
|
||||
useInputBarStore.getState().removeReference('ref_2');
|
||||
|
||||
const state = useInputBarStore.getState();
|
||||
expect(state.references[0].label).toBe('视频1');
|
||||
expect(state.references[1].label).toBe('视频2'); // 原视频3
|
||||
expect(state.editorHtml).toMatch(/data-ref-id="ref_3"[^>]*>[\s\S]*?视频2<\/span>/);
|
||||
});
|
||||
|
||||
it('删除音频1,音频2 重命名为音频1', () => {
|
||||
const refs = [
|
||||
mockRef('ref_1', 'audio', '音频1'),
|
||||
mockRef('ref_2', 'audio', '音频2'),
|
||||
];
|
||||
const editorHtml = `${mentionSpan('ref_1', 'audio', '音频1')} ${mentionSpan('ref_2', 'audio', '音频2')}`;
|
||||
|
||||
useInputBarStore.setState({ references: refs, editorHtml });
|
||||
useInputBarStore.getState().removeReference('ref_1');
|
||||
|
||||
const state = useInputBarStore.getState();
|
||||
expect(state.references).toHaveLength(1);
|
||||
expect(state.references[0].id).toBe('ref_2');
|
||||
expect(state.references[0].label).toBe('音频1'); // 原音频2
|
||||
expect(state.editorHtml).toMatch(/data-ref-id="ref_2"[^>]*>[\s\S]*?音频1<\/span>/);
|
||||
});
|
||||
});
|
||||
|
||||
describe('边界场景', () => {
|
||||
it('editorHtml 为空 — 不报错,只重命名 references', () => {
|
||||
const refs = [
|
||||
mockRef('ref_1', 'image', '图片1'),
|
||||
mockRef('ref_2', 'image', '图片2'),
|
||||
];
|
||||
useInputBarStore.setState({ references: refs, editorHtml: '' });
|
||||
useInputBarStore.getState().removeReference('ref_1');
|
||||
|
||||
const state = useInputBarStore.getState();
|
||||
expect(state.references).toHaveLength(1);
|
||||
expect(state.references[0].label).toBe('图片1');
|
||||
expect(state.editorHtml).toBe('');
|
||||
});
|
||||
|
||||
it('editorHtml 中没有对应的 @mention span — 只改 references', () => {
|
||||
const refs = [
|
||||
mockRef('ref_1', 'image', '图片1'),
|
||||
mockRef('ref_2', 'image', '图片2'),
|
||||
];
|
||||
const editorHtml = '<span>纯文本,没有 mention span</span>';
|
||||
|
||||
useInputBarStore.setState({ references: refs, editorHtml });
|
||||
useInputBarStore.getState().removeReference('ref_1');
|
||||
|
||||
const state = useInputBarStore.getState();
|
||||
expect(state.references).toHaveLength(1);
|
||||
expect(state.references[0].label).toBe('图片1'); // ref_2 重命名
|
||||
// editorHtml 不含对应 span,无法更新,但不报错
|
||||
});
|
||||
|
||||
it('传入不存在的 id — 静默返回,状态不变', () => {
|
||||
const refs = [mockRef('ref_1', 'image', '图片1')];
|
||||
const editorHtml = mentionSpan('ref_1', 'image', '图片1');
|
||||
|
||||
useInputBarStore.setState({ references: refs, editorHtml });
|
||||
useInputBarStore.getState().removeReference('nonexistent_id');
|
||||
|
||||
const state = useInputBarStore.getState();
|
||||
expect(state.references).toHaveLength(1);
|
||||
expect(state.references[0].label).toBe('图片1');
|
||||
expect(state.editorHtml).toBe(editorHtml);
|
||||
});
|
||||
|
||||
it('删除的图片没被 @ 到 editor,其他图片仍被重命名', () => {
|
||||
const refs = [
|
||||
mockRef('ref_1', 'image', '图片1'),
|
||||
mockRef('ref_2', 'image', '图片2'),
|
||||
mockRef('ref_3', 'image', '图片3'),
|
||||
];
|
||||
// editorHtml 只 @ 了图片3,没 @图片1/2
|
||||
const editorHtml = `${mentionSpan('ref_3', 'image', '图片3')}`;
|
||||
|
||||
useInputBarStore.setState({ references: refs, editorHtml });
|
||||
useInputBarStore.getState().removeReference('ref_1');
|
||||
|
||||
const state = useInputBarStore.getState();
|
||||
expect(state.references[0].label).toBe('图片1'); // 原图片2
|
||||
expect(state.references[1].label).toBe('图片2'); // 原图片3
|
||||
// editor 里只有 ref_3 的 span,应该更新成"图片2"
|
||||
expect(state.editorHtml).toMatch(/data-ref-id="ref_3"[^>]*>[\s\S]*?图片2<\/span>/);
|
||||
});
|
||||
});
|
||||
|
||||
describe('连续删除(并发)', () => {
|
||||
it('连续删除两张图片,剩余图片正确重编号', () => {
|
||||
const refs = [
|
||||
mockRef('ref_1', 'image', '图片1'),
|
||||
mockRef('ref_2', 'image', '图片2'),
|
||||
mockRef('ref_3', 'image', '图片3'),
|
||||
mockRef('ref_4', 'image', '图片4'),
|
||||
];
|
||||
const editorHtml = `${mentionSpan('ref_1', 'image', '图片1')} ${mentionSpan('ref_2', 'image', '图片2')} ${mentionSpan('ref_3', 'image', '图片3')} ${mentionSpan('ref_4', 'image', '图片4')}`;
|
||||
|
||||
useInputBarStore.setState({ references: refs, editorHtml });
|
||||
useInputBarStore.getState().removeReference('ref_2');
|
||||
useInputBarStore.getState().removeReference('ref_1');
|
||||
|
||||
const state = useInputBarStore.getState();
|
||||
expect(state.references).toHaveLength(2);
|
||||
expect(state.references[0].id).toBe('ref_3');
|
||||
expect(state.references[0].label).toBe('图片1');
|
||||
expect(state.references[1].id).toBe('ref_4');
|
||||
expect(state.references[1].label).toBe('图片2');
|
||||
expect(state.editorHtml).toMatch(/data-ref-id="ref_3"[^>]*>[\s\S]*?图片1<\/span>/);
|
||||
expect(state.editorHtml).toMatch(/data-ref-id="ref_4"[^>]*>[\s\S]*?图片2<\/span>/);
|
||||
});
|
||||
});
|
||||
});
|
||||
Loading…
x
Reference in New Issue
Block a user