video-shuoshan/backend/tests/test_1080p_api.py
seaislee1209 39667ff19c feat: v0.19.0 1080P 分辨率支持 — 完整前后端 + 严格计费准确性 + 47 测试
火山 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>
2026-04-17 19:06:45 +08:00

132 lines
4.7 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""
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):
"""原则 1Fast + 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):
"""原则 1adaptive 不在 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)