火山 Seedance 2.0 于 2026-04-16 上线 1080P 支持。本次实现前端 UI、
后端校验/计费、数据库迁移,并严格遵守三原则:
1. 禁止兜底/静默降级 — Fast+1080P 组合在 UI/store/serializer/view/计价
五层防御,任一层穿透都 fail loud,不悄悄按 720P 扣费
2. 钱的计算绝对准确 — 前端预估公式与后端 estimate_tokens 完全一致
`(输入时长+输出时长) × 宽 × 高 × fps / 1024`;实际扣费按火山返回
total_tokens × 官方单价;预估端不维护最低 token 修正表
3. 不隐藏 bug — 无 `or '720p'` / `|| '720p'` 兜底;类型严格;异常暴露
## 后端(7 处 + 1 次迁移)
- models.py: QuotaConfig 加 base_token_price_1080p(51)/base_token_price_1080p_video(31);
GenerationRecord.resolution 加 RESOLUTION_CHOICES 约束 + default='720p'
- migrations/0020: 含 RunPython data migration 回填历史 resolution='' → '720p'
- utils/billing.py:
* RESOLUTION_MAP 加 1080P 六种宽高比(21:9 是 2206×946,不是 seedance 1.0 值)
* get_resolution 去掉 tier 默认值,非法组合 raise KeyError 不静默降级
* estimate_tokens 纯官方公式,加 input_video_duration 参数(公式完整)
- utils/airdrama_client.py: create_task 加 resolution 必填参数(无默认值)
- apps/generation/serializers.py:
* VideoGenerateSerializer 加 resolution ChoiceField
* aspect_ratio 改 ChoiceField 显式拒绝 adaptive
* SystemSettingsSerializer 加 2 个 1080P 单价
- apps/generation/views.py:
* _get_token_price 加 resolution 必填参数,Fast+1080P raise ValueError
* _sum_video_duration 累加视频参考时长
* video_generate_view 读 resolution、400 拒绝 Fast+1080P 组合、
传给 get_resolution/estimate_tokens/_get_token_price/create_task/
GenerationRecord.resolution(移除 L450 硬编码 '720p')
* _settle_payment 按 record.resolution 取单价(1080P 结算按 1080P 价)
* _serialize_task + 5 处手工序列化加 resolution 字段(无 `or '720p'`)
- apps/accounts/views.py: team 接口返回 token_price_1080p/_video
## 前端(10 处)
- types/index.ts: Resolution 类型;GenerationTask/BackendTask/Team/
QuotaConfig/AssetVideo 加字段(全部必填,无 optional)
- store/inputBar.ts: resolution state;setModel/setResolution 双向拦截
Fast+1080P 组合,toast 提示引导,不静默降级
- store/generation.ts: addTask/backendToFrontend/reEdit/regenerate 全链路
携带 resolution;mapErrorMessage 改 '今日生成次数或团队余额不足'
- components/Toolbar.tsx:
* 加分辨率选择器 Dropdown(位置:比例和时长之间)
* modelItems/resolutionItems 双向 disabled(Fast 下 1080P 灰 / 1080P 下 Fast 灰)
* estimatedTokens 对齐后端公式(含输入视频时长 + assetMentions 视频时长)
* estimatedCost 按 resolution 选单价(Fast→fast_*、1080p→1080p_*、其他→基础)
* tooltip 明示"实际费用以火山 API 返回的 token 数为准"
- components/Dropdown.tsx: 加 disabled 属性支持
- components/VideoDetailModal.tsx: 重新编辑恢复 resolution
- components/GenerationCard.tsx: 动态显示 task.resolution.toUpperCase()
- pages/SettingsPage.tsx: 加 2 个 1080P 单价输入框(独立分组)
- pages/AdminAssetsPage.tsx / TeamAssetsPage.tsx: 去 || '720p' 兜底
- lib/api.ts: videoApi.generate 参数 resolution 必填
## 测试(47 个用例)
### 后端(28 个)
- tests/test_1080p_billing.py(23): RESOLUTION_MAP 像素、estimate_tokens
公式(含/不含输入视频、不做最低 token 修正)、_get_token_price 六种
组合、Fast+1080P 抛异常、calculate_cost 对齐官方示例 4.97 / 12.39 元
- tests/test_1080p_api.py(5): video_generate_view 拒绝 Fast+1080P (400)
+ 拒绝 adaptive + 拒绝非法 resolution + 默认值兼容 + 合法组合通过
### 前端(19 个)
- test/unit/resolution1080p.test.ts(14): store 状态、双向拦截
(1080P 下切 Fast 被阻止 model 不变、反向同样)、官方像素契约测试、
价格示例对齐(720P 4.97 / 1080P 12.39)
- test/e2e/resolution-1080p.spec.ts(5): 真实浏览器验证默认 720P、
Dropdown 双向置灰、tooltip 明示以火山为准
## 与官方文档对齐
- 参数:resolution (480p/720p/1080p 小写)、ratio、duration、generate_audio
- 像素:来自 docs/API文档/创建视频生成任务API.md Seedance 2.0 & 2.0 fast 列
- 单价:来自 docs/API文档/seedance模型价格.md (46/28/51/31/37/22)
- Fast 不支持 1080P:来自 docs/API文档/Seedance 2.0 1080P.md
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
132 lines
4.7 KiB
Python
132 lines
4.7 KiB
Python
"""
|
||
1080P API 集成测试 — 验证 video_generate_view 的入口校验。
|
||
"""
|
||
import os
|
||
import sys
|
||
import django
|
||
|
||
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings')
|
||
sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
|
||
django.setup()
|
||
|
||
import unittest
|
||
from django.test import TestCase
|
||
from django.contrib.auth import get_user_model
|
||
from rest_framework.test import APIClient
|
||
from apps.accounts.models import Team
|
||
from apps.generation.models import QuotaConfig
|
||
|
||
User = get_user_model()
|
||
|
||
|
||
class TestVideoGenerateResolution(TestCase):
|
||
"""video_generate_view 的分辨率+模型组合校验。"""
|
||
|
||
def setUp(self):
|
||
# 初始化 QuotaConfig
|
||
QuotaConfig.objects.get_or_create(pk=1)
|
||
|
||
# 建测试 team + user
|
||
self.team = Team.objects.create(
|
||
name='test-1080p',
|
||
is_active=True,
|
||
monthly_spending_limit=1000,
|
||
markup_percentage=0,
|
||
balance=1000,
|
||
frozen_amount=0,
|
||
)
|
||
self.user = User.objects.create_user(
|
||
username='test_1080p_user',
|
||
email='test1080p@example.com',
|
||
password='testpass123',
|
||
team=self.team,
|
||
spending_limit=-1,
|
||
daily_generation_limit=-1,
|
||
monthly_generation_limit=-1,
|
||
)
|
||
self.client = APIClient()
|
||
self.client.force_authenticate(user=self.user)
|
||
|
||
def test_reject_fast_plus_1080p(self):
|
||
"""原则 1:Fast + 1080P 组合必须 400 拒绝,不能静默降级。"""
|
||
resp = self.client.post('/api/v1/video/generate', {
|
||
'prompt': '测试',
|
||
'mode': 'universal',
|
||
'model': 'seedance_2.0_fast',
|
||
'aspect_ratio': '16:9',
|
||
'duration': 5,
|
||
'resolution': '1080p',
|
||
'references': [],
|
||
}, format='json')
|
||
self.assertEqual(resp.status_code, 400)
|
||
body = resp.json()
|
||
self.assertEqual(body.get('error'), 'invalid_resolution')
|
||
# 提示信息要明确告知用户原因
|
||
self.assertIn('1080P', body.get('message', ''))
|
||
self.assertIn('Fast', body.get('message', ''))
|
||
|
||
def test_reject_adaptive_ratio(self):
|
||
"""原则 1:adaptive 不在 6 选 1 白名单,拒绝。"""
|
||
resp = self.client.post('/api/v1/video/generate', {
|
||
'prompt': '测试',
|
||
'mode': 'universal',
|
||
'model': 'seedance_2.0',
|
||
'aspect_ratio': 'adaptive',
|
||
'duration': 5,
|
||
'resolution': '720p',
|
||
'references': [],
|
||
}, format='json')
|
||
self.assertEqual(resp.status_code, 400)
|
||
# serializer 错误:aspect_ratio 不在 choices
|
||
self.assertIn('aspect_ratio', str(resp.content))
|
||
|
||
def test_reject_invalid_resolution(self):
|
||
"""resolution 不在 480p/720p/1080p 白名单,拒绝。"""
|
||
resp = self.client.post('/api/v1/video/generate', {
|
||
'prompt': '测试',
|
||
'mode': 'universal',
|
||
'model': 'seedance_2.0',
|
||
'aspect_ratio': '16:9',
|
||
'duration': 5,
|
||
'resolution': '4K',
|
||
'references': [],
|
||
}, format='json')
|
||
self.assertEqual(resp.status_code, 400)
|
||
|
||
def test_resolution_default_720p_when_missing(self):
|
||
"""旧客户端不传 resolution 字段时,serializer default='720p' 生效。"""
|
||
# 不传 resolution(兼容旧客户端)
|
||
resp = self.client.post('/api/v1/video/generate', {
|
||
'prompt': '测试',
|
||
'mode': 'universal',
|
||
'model': 'seedance_2.0',
|
||
'aspect_ratio': '16:9',
|
||
'duration': 5,
|
||
'references': [],
|
||
}, format='json')
|
||
# serializer 应该接受(default='720p');可能因火山 API 未开通等其他原因失败,
|
||
# 但不该是 resolution 相关的 400 错误
|
||
if resp.status_code == 400:
|
||
body = resp.json()
|
||
self.assertNotEqual(body.get('error'), 'invalid_resolution')
|
||
|
||
def test_accept_valid_1080p_airdrama(self):
|
||
"""原则:AirDrama + 1080P 组合合法,不被 400 拒绝。"""
|
||
resp = self.client.post('/api/v1/video/generate', {
|
||
'prompt': '测试',
|
||
'mode': 'universal',
|
||
'model': 'seedance_2.0',
|
||
'aspect_ratio': '16:9',
|
||
'duration': 5,
|
||
'resolution': '1080p',
|
||
'references': [],
|
||
}, format='json')
|
||
# 不应该因为分辨率被 400(可能因余额/API 未开通等其他原因失败)
|
||
if resp.status_code == 400:
|
||
body = resp.json()
|
||
self.assertNotEqual(body.get('error'), 'invalid_resolution')
|
||
|
||
|
||
if __name__ == '__main__':
|
||
unittest.main(verbosity=2)
|