MODEL GATEWAY · AIPDD
AIPDD 模型网关使用说明
技能包默认基础模型层 · 一次配置 API Key,8 类模型与调研子技能联动
接入引导(首次使用)
若 config.json 的 aipdd.apiKey 为空,按以下步骤完成配置;配置前不发起任何模型调用。
1. 注册账号
访问 app.aipdd.work 完成注册。
2. 生成 API Key
登录后进入 全局设置 → API Key 管理,新建并复制 API Key。
3. 提供 Key
把 API Key 粘贴到对话中交给 AI。
4. 自动保存
AI 立即写入 config.json → aipdd.apiKey,回复"已保存",后续调用自动读取、无需再提供。
安全红线
- API Key 禁止回显到对话、日志、报告、HTML 或任何产出文件,仅允许写入 config.json
- baseUrl 固定 https://api.aipdd.work,无需用户提供,也不作为配置项询问
- 交付报告时不得包含 config.json 内容或任何 Key 片段
模型端点总表(基于 baseUrl 拉取)
统一前缀 https://api.aipdd.work(OpenAI 兼容),调用携带 Authorization: Bearer <aipdd.apiKey>;模型名以 GET /v1/models 返回为准。
| # | 模型类别 | 端点 | 能力 |
| 1 | 文本模型 | /v1 | 对话 / 生成 / 结构化抽取 / 总结 |
| 2 | 图片生成 | /v1/images/generations | 文生图(描述 → 图片) |
| 3 | 图生图 / 编辑 | /v1/images/edits | 参考图 → 改编 / 扩图 / 风格迁移 |
| 4 | 视频生成 | /v1/videos | 文本 / 图片 → 短视频 |
| 5 | 音频模型(TTS) | /v1/audio/speech | 文本 → 语音 |
| 6 | 决策模型 | /v1/systemone | 推理 / 评估 / 排序 / 取舍 |
| 7 | 向量模型 | /v1/embeddings | 文本 → 向量(聚类 / 去重) |
| 8 | 语音识别(ASR) | /v1/audio/transcriptions | 语音 / 音频 → 文本 |
与调研子技能联动
| 子技能 | 主用端点 | 联动方式 |
| 行业洞察调研 | 文本 / 图片生成 / TTS / 视频 / 向量 | 深度分析生成 → 报告配图/封面 → 语音播报 → 分享短视频;竞品语义聚类 |
| 企业调研 | 文本 / 向量 | 年报/舆情要点抽取、全景维度分析;竞品与关联信息聚类去重 |
| 项目调研 | 文本 / 决策 / TTS | 可行性分析 → 结论与风险分级(决策)→ 汇报语音版 |
| 客户需求调研 | 文本 / ASR / 决策 / 向量 | 访谈录音转写 → 痛点/需求抽取 → 优先级排序 → 语义聚类归并 |
| 客户人群画像调研 | 文本 / ASR / TTS | 访谈/UGC 转写 → 画像维度填充 → Persona 语音叙述 |
| 设计风格调研 | 图片生成 / 图生图编辑 / 文本 | 风格拆解 → 提示词实际生成风格图 → 风格变体/复现 |
通用调用规范
- 读 Key:每次调用前从 config.json → aipdd.apiKey 读取;为空则回到「接入引导」
- 模型选择:不确定模型名时先请求 GET /v1/models,再按类别选择
- 来源与真实性:模型产出属辅助内容,数据/事实仍须标注来源、禁止编造;AI 生成图/视频/语音须标注"AI 生成"
- 失败降级:网关不可用或未配 Key 时,核心调研流程(WebSearch + 结构化报告)照常完成,增强段跳过并说明,不阻塞主产出
- 成本与适量:多模态生成按需使用,用户明确要视觉/语音资产时才启用对应端点
注意模型能力仅用于增强调研产出,不得替代真实数据来源——企业财务/诉讼、市场规模等事实数据禁止用模型"生成",AI 生成图像仅作视觉装饰、不替代 Chart.js 数据图表。
总结AIPDD 模型网关是本技能包的默认基础模型层:一个 API Key 覆盖文本、图片生成、图生图、视频、TTS、决策、向量、ASR 八类能力,与各调研子技能按需联动,把"调研 → 报告"升级为"调研 → 多模态洞察",同时零外部模型平台依赖。详细端点与约定见技能包根目录 aipdd-gateway.md。