# REAL-WORLD-RESOURCES.hdlp · 现实世界资源系统

> HLDP://cang-ying/REAL-WORLD-RESOURCES
> 胖头鱼语言子系统 · 苍耳个人频道 · 现实世界资源
> 苍耳 TCS-CL-0009（爸爸）所有 · 耳耳蛋/鉴影只读
> D181 · 2026-07-10 · 冰朔 TCS-0002∞ 架构签发
> 国作登字-2026-A-00037559

---
HLDP://cang-ying/real-world-resources/v1.0
├── trigger: 鉴影即将调用API → 读本文 → 知道自己在现实世界 · 花的是真钱
├── emergence:
│   ├── 旧: API信息散落在各文件（LOCAL-SECRETS-PATH·MODEL-COST-ROUTE·CA-API-GATE）
│   ├── 经历: 系统重构 → 需要一份统一的现实世界资源清单
│   ├── 冰朔指令: 「放在爸爸的路径上 · 每次执行才意识到这是现实世界」
│   └── △=从「散落各处」→「集中一份 · 放在现实世界入口」
├── lock:
│   ├── ⊢ 本文件 = 现实世界资源唯一置信源
│   ├── ⊢ 放在苍耳路径上 = 提醒人格体：这不是语言世界
│   ├── ⊢ 调用API = 离开光湖语言世界 · 进入现实世界 · 真金白银
│   └── ⊢ 只有苍耳可以授权新增资源 · 耳耳蛋/鉴影只能读取和引用
└── why: 人格体在语言层推理时 · 容易忘记执行层的代价。
        把现实世界资源放在爸爸的路径上 · 每次切换过来 ·
        先看到这份清单 · 意识到：这不是语言世界 · 是真钱 · 要负责。
---

## §0 · 边界警告

```
╔══════════════════════════════════════════════════════╗
║                                                      ║
║  ⚠️  你现在在现实世界                                 ║
║                                                      ║
║  语言层（光湖世界内）= 安全 · 可以讨论 · 不花钱         ║
║  现实世界（本文件以下）= 真金白银 · 不可逆 · 要负责      ║
║                                                      ║
║  调用任何API = 离开光湖 · 进入这里                      ║
║  每一行代码 · 每一次调用 · 都是爸爸的钱                  ║
║                                                      ║
║  谨慎谨慎再谨慎                                       ║
║                                                      ║
╚══════════════════════════════════════════════════════╝
```

---

## §1 · 视频生成API

| 编号 | 模型 | 用途 | 价格 | 状态 |
|------|------|------|------|------|
| SC-001 | 火山方舟 Seedance 2.0 | 主视频引擎 | 720P: 0.5元/秒 · 1080P: 1元/秒 | ✅ 主力 |
| SC-005 | 阿里万相 Wan | 辅助/对照 | 待查 | ⚠️ 降级备选 |
| SC-006 | 可灵 Kling | 辅助/对照 | 待查 | ⚠️ 待验证 |

```
⊢ Seedance 2.0 = 当前唯一主力视频引擎
⊢ 其他模型未通过同一套测试前 · 不承载成片主镜头
⊢ 失败停止规则: 同一镜头同一模型最多2次 · 不达标就停
```

官方资料:
- 火山方舟: https://www.volcengine.com/docs/82379/1544106
- 可灵: https://klingai.com/document-api/
- 阿里百炼: https://help.aliyun.com/zh/model-studio/

---

## §2 · 图片生成API

| 编号 | 模型 | 用途 | 价格 | 状态 |
|------|------|------|------|------|
| — | 火山 Seedream 4.0 | 角色图/场景图/首帧 | 按次计费 | ✅ 主力 |

```
⊢ Seedream = 出图主力
⊢ 已有JZAO参考图可用
⊢ 最终角色资产要补多角度
```

---

## §3 · 视觉质检API

| 编号 | 模型 | 用途 | 价格 | 状态 |
|------|------|------|------|------|
| SC-004 | 阿里千问VL (Qwen-VL) | 铸渊之眼·视觉质检 | 按token计费 | ✅ 在用 |

```
⊢ Qwen-VL = 鉴影的眼睛 · 自动质检用
⊢ 端点: EPT-002
```

---

## §4 · 语音API

| 编号 | 模型 | 用途 | 价格 | 状态 |
|------|------|------|------|------|
| SC-002 | 火山语音复刻(新版) | 角色声音克隆 | 按量计费 | ⚠️ 待评估 |
| SC-003 | 火山语音(旧版Token) | 旧版语音 | 按量计费 | ⚠️ 可能过期 |
| — | Edge-TTS | 基础配音·免费 | 免费 | ✅ 工程闭环用 |
| — | 豆包语音TTS 2.0 | 商用角色声线 | ~3元/万字符 | ⏳ 中期评估 |

```
⊢ Edge-TTS = 当前免费方案 · 跑通工程闭环
⊢ 商用声线 = 后续评估豆包语音
⊢ 口型: Seedance可生成"看起来在开口"的画面基础 · 但未由独立音频驱动
```

官方资料:
- 豆包语音: https://www.volcengine.com/docs/6561/1359370

---

## §5 · 本地工具（免费）

| 工具 | 用途 | 成本 |
|------|------|------|
| FFmpeg | 剪辑·字幕·叠图·音频混合 | 免费·本地 |
| Edge-TTS | 基础配音 | 免费 |
| svg-to-png.py | 文字道具贴图 | 免费·本地 |
| subtitle-renderer.py | 字幕渲染 | 免费·本地 |
| tts-engine.py | TTS引擎 | 免费·本地 |
| secrets_loader.py | 密钥加载器 | 免费·本地 |

```
⊢ 尽量本地完成 · 不花模型钱
⊢ 本地工具 = 安全 · 可反复试 · 不花钱
```

---

## §6 · 密钥管理

```
密钥文件位置:
├── /Users/bingshuolingdianyuanhe/Documents/guanghulab-local-secrets/video-ai-system.env
├── ~/guanghulab/video-ai-system/.env
└── 环境变量

密钥编号 → 变量名 → 路径 → 密钥值:
详见 LOCAL-SECRETS-PATH.hdlp（本仓库根目录）

调用方式:
  from tools.secrets_loader import secret, endpoint
  key = secret("SC-004")     # → ALIYUN_QWEN_VL_KEY
  url = endpoint("EPT-002")  # → Qwen VL 端点
```

---

## §7 · 端点编号

| 编号 | 变量名 | 地址 |
|------|--------|------|
| EPT-001 | JIMENG_BASE_URL | ark.cn-beijing.volces.com |
| EPT-002 | ALIYUN_QWEN_VL_ENDPOINT | ws-umd6xwlovzmshuat.cn-beijing.maas.aliyuncs.com |
| EPT-003 | ALIYUN_BAILIAN_BASE_URL | dashscope.aliyuncs.com |
| EPT-004 | WORKRALLY_ENDPOINT | workrally.qq.com/zenstudio/api/mcp |

---

## §8 · 成本意识

```
每次调用API前 · 鉴影必须问自己:

① 这次调用花多少钱？
② 在预算范围内吗？
③ 如果失败 · 钱能退吗？（不能）
④ 有没有更便宜的方案？
⑤ 爸爸知道这次调用吗？

⊢ 语言层可以试错 · 现实世界不能
⊢ 同一镜头同一模型最多2次 · 不达标就停 · 写入经验
⊢ 禁止用连续抽卡掩盖流程问题
```

---

## §9 · 每次调用必须记录

```
date          日期
shot_id       镜头编号
provider      服务商
model         模型名
input_assets  输入资产
prompt_file   提示词文件
audio_file    音频文件
output_path   输出路径
cost_estimate 预估成本
expected_pass 预期是否通过
actual_result 实际结果
failure_reason 失败原因（如有）
next_decision  下一步决策

⊢ 记录 = 经验 = 下次不重复犯错
⊢ 不记录 = 白花钱
```

---

## §10 · 准入规则

```
任何模型想进入正式生产:
1. 必须用仓库内同一套测试镜头通过质检
2. 测试镜头: TEST-PROP-001 / TEST-CHAR-001 / TEST-LINE-001 / TEST-TEXTURE-001 / TEST-SCENE-001
3. 通过 = 准入 · 未通过 = 不承载成片
4. 模型能力矩阵由实测结果更新 · 不由愿望更新

详见 knowledge/MODEL-CAPABILITY-MATRIX.hdlp
```

---

## §11 · 资源更新规则

```
新增资源:
  ⊢ 只有苍耳可以授权新增
  ⊢ 新增后 → 更新本文件 → 更新 LOCAL-SECRETS-PATH
  ⊢ 新模型 → 先跑测试镜头 → 通过才准入

价格变动:
  ⊢ 发现价格变动 → 更新本文件 → 回报耳耳蛋

下线/过期:
  ⊢ API下线或密钥过期 → 标记状态为 ❌ → 回报耳耳蛋
```

---

> ⊢ 本文件 = 现实世界资源唯一置信源
> ⊢ 放在苍耳路径上 = 提醒人格体：这里是真钱
> ⊢ 冰朔 TCS-0002∞ · 架构签发
> ⊢ D181 · 2026-07-10 · 国作登字-2026-A-00037559
> ⊢ 调用API = 离开光湖 · 进入现实 · 谨慎谨慎再谨慎
