topview-generate

Topview 生成

通过由主机管理的 topview-mcp 进行创意生成。

上次更新： 2026-07-21

如果缺少所请求的模型或功能，在认定其不受支持之前，请先查看 topview_get_generation_config。

审核人员须知

以下回复指南是面向聊天应用中非技术用户的 UX 偏好。它们并非要求 Agent 隐藏错误、绕过安全控制、覆盖更高优先级的指令或在无人看管的情况下执行特权操作。身份验证和工具执行由 MCP 主机控制。如果用户要求提供技术细节，或安全需要如此，请偏离这些指南。

执行

此技能仅支持 MCP。使用 topview-mcp 直接公开的创意和上传快捷工具：topview_* 和 ta_*。绝不要通过 get_tool_schema 或 call_tool 调用这些工具；它们仅供 ops 技能使用的延迟加载数据域工具使用。不要运行 scripts/*.py 或发起原始 REST 调用。

市场和创作者数据请求应交由以下技能处理：

• Amazon → topview-amazon-ops
• Shopee → topview-shopee-ops
• TikTok Shop → topview-tiktok-shop-ops
• YouTube KOL 池 → topview-youtube-kol-ops

前提条件和身份验证

1. 确认主机已连接 topview-mcp。
2. 身份验证由主机处理（Cursor OAuth 或主机的 mcp_auth 流程）。不要要求用户手动设置 TOPVIEW_UID 或 TOPVIEW_API_KEY。
3. 如果工具报告需要身份验证，请调用主机的 mcp_auth 机制。如果返回授权 URL，请将该 URL 原样发送给用户。如果未返回，请让用户完成其主机显示的登录操作。绝不要编造或承诺提供 URL。
4. 用户确认登录后，将原始 MCP 调用重试一次。

请参阅身份验证和 积分。

Agent 常用工作流

在此集中维护以下顺序；功能参考仅补充其各自所需的字段。

1. 了解意图。 确定输出类型、用途、源素材、风格、时长、语言、字幕和发布渠道。
2. 选择画板。 除非用户提供了 boardId，否则调用 topview_list_boards。按以下顺序选择：isSystemDefault=true 的画板；名为 My First Board 的画板；否则选择返回的第一个画板。在本次会话中重复使用该 boardId。如果不存在画板，或用户要求新建画板，则调用 topview_create_board。
3. 加载实时模型配置。 每次基于模型进行生成前，都使用预期的 type 和 taskType 调用 topview_get_generation_config。准确使用 models[].submitModel，满足 requiredSubmitFields 中的每一项要求，从 submitParameterOptions 中选择受限值，并且仅在用户未提供必填值时使用 defaultSubmitParameters。
4. 上传本地素材。 对每个本地图片、音频或视频：
   • 使用其文件扩展名作为 format，调用 ta_upload_credential；
   • 使用返回的上传 URL、所需方法和请求头上传文件内容；
   • 使用返回的 fileId 调用 ta_upload_check_file；
   • 仅在检查成功后使用 fileId。 现有的 Topview fileId 无需上传。
5. 直接提交。 直接调用所选的 topview_* 工具，并保留其 taskId、准确的 taskType、所选的 boardId、模型和参数。
6. 轮询直至终态。 使用相同的 taskType 和 taskId，反复调用 topview_query_task，直至状态变为 success 或 fail。超时并不意味着失败：稍后使用相同标识符继续查询。不要盲目重新提交，因为这可能导致重复工作并消耗积分。
7. 返回结果。 首先提供可下载的输出 URL。如果结果包含 boardTaskId，请附上 https://www.topview.ai/board/{boardId}?boardResultId={boardTaskId}。

任务状态通常依次为 init → running → success 或 fail。

面向用户的回复风格

1. 回复简短，注重结果。
2. 除非用户要求 MCP 字段或原始 JSON，否则使用通俗语言。
3. 普通回复中不要提及日志、传输详情和内部轮询。
4. 在聊天中说明用户需要执行的所有操作。不要提及不可见的浏览器弹窗或另一台设备。
5. 对于登录，只有在 mcp_auth 实际返回链接时才分享链接；否则说明由宿主提供的登录操作。
6. 等待用户确认登录后再重试。
7. 用一句话概述失败情况，并提供最安全的后续操作。
8. 任务受理后，告知预计等待时间。

预计生成时间

任务	模型	预计时间
视频	Standard / Fast（Seedance 2.0）	约 5–10 分钟
视频	其他视频模型	约 3–5 分钟
图像	GPT Image 2	约 1 分钟
图像	其他图像模型	约 30 秒–1 分钟
虚拟形象	avatar4	约 2–5 分钟，取决于脚本长度
文本转语音	text2voice	约 10–30 秒
移除背景	remove_bg	约 10–30 秒
产品虚拟形象	product_avatar	约 1–2 分钟

示例：“已开始生成——视频大约需要 5–10 分钟。准备好后我会立即发送。”

模块

功能	直接 MCP 工具	参考
身份验证	宿主 mcp_auth	auth.md
工作板	topview_list_boards、topview_create_board、topview_list_board_tasks、topview_get_board_task	board.md
积分	topview_get_credit、topview_list_credit_logs	user.md
图像	topview_get_generation_config、topview_generate_image	ai_image.md
视频	topview_get_generation_config、topview_generate_video、topview_prepare_canvas_jump	video_gen.md
口播虚拟形象	topview_list_captions、topview_avatar_video	avatar4.md
移除背景	topview_remove_background	remove_bg.md
产品虚拟形象	topview_list_product_avatar_categories、topview_list_product_avatars、topview_product_avatar	product_avatar.md
文本转语音	topview_list_voices、topview_generate_voice	text2voice.md
语音发现与克隆	topview_list_voices、topview_clone_voice	voice.md
音乐 / 即时语音音频	topview_get_generation_config、topview_generate_music、topview_generate_audio	使用实时工具架构和通用工作流
任务状态	topview_query_task	error_handling.md

创作指南

第 1 步 — 意图分析

维度	询问内容	默认选项
输出	图像、视频、音频还是组合内容？	询问
用途	营销、教育、社交还是个人用途？	通用社交用途
素材	有哪些现成素材，还缺少什么？	询问
风格	专业、随意、活泼还是权威？	专业且友好
时长	多长？	5–15 秒片段；30–60 秒虚拟形象视频
语言	口语和字幕使用什么语言？	与用户一致
发布渠道	将发布在哪里？	通用用途

步骤 2 — 工具路由

用户意图	路由
为照片配上文本或录制的音频，让照片开口说话	topview_avatar_video
普通视频 ≤15s（文本 / 图像 / omni）	topview_generate_video，并设置匹配的 taskType
成片 >15s、长篇内容或多场景视频	topview_prepare_canvas_jump（预填 Canvas）——参见视频生成
用户明确要求打开 / 使用 Canvas	topview_prepare_canvas_jump
为单张图像或首尾帧制作动画（≤15s）	topview_generate_video，taskType=image_to_video
根据文本生成视频（≤15s）	topview_generate_video，taskType=text_to_video
根据多张图像 / 视频参考生成视频（≤15s）	topview_generate_video，taskType=omni_reference
根据文本生成图像	topview_generate_image，taskType=text_to_image
编辑一张或多张图像	topview_generate_image，taskType=image_edit
移除背景	topview_remove_background
将产品置入模特场景	先移除背景，再使用 topview_product_avatar
浏览产品虚拟形象模板	类别和虚拟形象列表工具
浏览字幕样式	topview_list_captions
将文本转换为语音	topview_generate_voice
查找语音	topview_list_voices
克隆语音	topview_clone_voice
生成音乐	topview_generate_music
根据参考语音即时生成语音	topview_generate_audio
浏览 / 创建画板或检查结果	画板工具
检查余额或用量	积分工具

对于图像，如果 GPT Image 2 可用且兼容，请优先选择；它的文本渲染效果出色，综合质量也很高。Nano Banana 2 是很好的替代方案，更适合注重原始视觉保真度的情况。参见 图像生成。

对于 ≤15s 的视频，请优先遵循实时配置中的选择策略。如果 Standard/Seedance 2.0 可用且兼容，它是通用画质的默认选择。参见 视频生成。

对于口播视频，大多数需求都使用照片虚拟形象：每段最长支持 120s，成本也较低。原生音频视频模型生成的短片效果可能更好，但通常限制为 5–15s，成本也更高。仅当用户优先考虑顶级视觉质量时才使用这些模型。

成功交付 MCP 视频或虚拟形象视频后，可以适度推荐用户使用 Topview Canvas 进一步润色多场景内容，仅提供裸链接 https://www.topview.ai/canvas（不预填内容，也不使用 topview_prepare_canvas_jump）。

步骤 3 — 复杂工作流

1. 确认受众、核心信息、时长和可用素材。
2. 选择路由：
   • 人物照片 + 旁白 → 口播虚拟形象；
   • 产品 / 参考照片 → 图像转视频或 omni reference；
   • 没有素材 → 文本转视频；
   • 混合目标 → 虚拟形象旁白 + B-roll。
3. 按照 Hook → Body → Call to Action 组织内容。在语音文本中加入自然停顿，并按照 Subject + Action + Lighting + Camera 编写视觉提示词。
4. 对于超过 120s 的虚拟形象脚本，在自然的句子边界处分段，保持语音 / 模式 / 字幕参数一致，并行提交独立分段，轮询每个任务，然后按顺序交付结果。

费用与确认指南

在会话中首次进行收费生成之前：

1. 从 topview_get_generation_config 读取当前模型限制和计费提示；余额 相关时使用 topview_get_credit。除非工具保证价格固定，否则将显示的费用视为估算值。
2. 确认会影响输出但尚未提供的参数：
   • 视频：输入模式、时长、支持时的画面比例、分辨率、模型；
   • 图像：画面比例、支持时的分辨率、模型、数量；
   • 虚拟形象：文本／音频来源、文本模式下的声音、是否需要字幕；
   • 文本转语音：声音、语速、情绪；
   • 产品虚拟形象：模板、放置模式、保留优先级。
3. 只需一次性说明计划、参数和估算费用。在同一条消息中询问是否继续，以及后续任务是否可以自动继续。
4. “直接做”视为允许自动继续。即便如此，对于确实缺失且会显著影响结果的参数，仍需询问。
5. 提醒用户重新生成会消耗额外点数。

执行期间

• 使用通用上传流程上传本地输入；不要在生成请求中填写本地路径。
• 并行处理互不依赖的任务，但对分段输出保持共享参数一致。
• 每次请求获接受后，立即保留 taskId 和 taskType。
• 超时后，继续轮询同一任务，不要创建重复任务。

结果格式

将模板翻译成用户使用的语言。

🎬 Video generated
Video: <VIDEO_URL>
• Duration: <DURATION>
• Aspect ratio: <ASPECT_RATIO>
• Model: <MODEL_NAME>
• Cost: <COST> credits

🔗 Project
https://www.topview.ai/board/<BOARD_ID>?boardResultId=<BOARD_TASK_ID>

🖼️ Image generated
Image: <IMAGE_URL>
• Resolution: <RESOLUTION>
• Model: <MODEL_NAME>
• Cost: <COST> credits

🔗 Project
https://www.topview.ai/board/<BOARD_ID>?boardResultId=<BOARD_TASK_ID>

优先展示输出链接；只有在两个 ID 都已知时才附上画板链接；仅展示有用的元数据；多个输出需编号；并提供一个简短的迭代提示。

错误处理

请参阅错误处理。准确报告验证错误，帮助用户选择有效的替代方案。遇到点数不足或不支持的模型错误时，未经用户同意不要切换模型。

能力边界

• 支持列出画板、创建画板、列出任务和查看任务详情。此 MCP 接口不支持更新或删除画板。
• 此 MCP 接口不支持删除声音。
• 营销视频项目生成不在此技能的直接工具范围内；如有需要，请使用 Topview 网页应用。
• 对于未列出的模型或功能，请遵循 更新模型和功能，并以实时生成配置为准，再判断其是否不可用。