AI 与媒体能力
AI 平台（ai）
AI 平台统一管理大模型供应商（如阿里百炼 / DeepSeek / OpenAI 兼容端点），应用通过平台 API 调用，不直接持有各家 key。
能力矩阵
| 能力 | 说明 | 默认免费额度 | ||
|---|---|---|---|---|
| 文生图 | 图像生成 | 1 次/日 | ||
| 视频生成 | 视频生成 | 1 次/日 | ||
| 语音生成 | TTS 配音 | 1 次/日 | ||
| 对话 / 文本 | 问答、摘要、写作 | 按套餐 | ||
| 翻译 | 多语言翻译 | 按套餐 |
调用
POST /ai/v1/generate
body: {
"kind": "image", # image / text / video / audio / translate
"prompt": "一只戴着耳机的猫，赛博朋克风",
"model": "wan2.7-image", # 模型（默认使用非 pro 模型，控制成本）
"size": "1024x1024"
}额度检查
GET /ai/v1/entitlement
→ { "tier": "basic", "ai_enabled": true, "quota_remaining": 5 }平台内置成本控制：带 pro 的模型默认不调用（除非付费套餐），避免单次生成烧掉大量额度。
媒体平台（media）
媒体平台管理文件上传与 OSS 对象存储：
# 上传（multipart 或 base64）
POST /media/v1/files
→ { "url": "https://...", "storage": "local|oss", "bytes": 12345 }
# 列表
GET /media/v1/files?appid={appid}&page=1&page_size=20图片搜索（免费图源）
GET /imagesearch/v1/search?q=headphones&page=1聚合多个免费图源（Pexels / Pixabay 等），按轮询策略分配额度，可记录各源次数与剩余免费额度。适合做产品图、封面图的辅助搜索。
最佳实践
- AI 生成结果先入库（媒体平台）再引用 URL，避免重复生成浪费额度；
- 图像生成设超时与重试；
pro模型只在付费用户场景启用； - 所有用户可见的 AI 内容建议落审计与来源标记。