服务端合成渲染免费试用流程指南
本文档面向希望体验美摄服务端合成渲染能力的客户。试用过程无需在本地部署渲染服务：获取试用 API Key 后，即可使用现有 JSON 示例发起合成任务，并查看任务进度与最终视频效果。
整个流程分为四步：获取试用凭证、准备 JSON、发起任务、获取结果。
试用前准备
开始前，请准备一台能够发送 HTTP 请求的本地计算机，并联系美摄商务获取以下试用信息：
- 服务端合成渲染 API Key（接口鉴权凭证）；
API Key 仅用于免费试用期间的接口鉴权，请妥善保存，不要将其写入公开代码仓库、网页前端代码或对外分享的日志中。
第一步：获取 API Key
前往美摄官网联系美摄商务，说明希望试用服务端合成渲染能力。完成试用开通后，您将获得调用接口所需的 API Key 。
调用时，请将API Key添加到Authorization请求头中，用于通过鉴权。
第二步：准备完整 JSON
前往最小 JSON 样例，选择一个接近目标效果的功能分类，并复制子页面中的完整 JSON。完整示例已经包含合成任务所需的数据结构，比从零开始编写时间线更适合首次试用。
准备 JSON 时请注意：
- 复制完整 JSON，不要只复制局部字段或参数片段；
- 如需替换视频、音频或图片，请确保素材地址能够被合成服务访问；
- 如需替换资源包 ID，请确认对应资源已经安装在当前试用环境中；
- 首次试用建议先跑通流程，再逐步调整分辨率、字幕、转场、特效等内容。
第三步：发起合成任务
打开发起合成任务，按照页面说明在本地调用任务创建接口：
- 调用合成接口；
- 按要求携带 API Key；
- 将上一步准备的 JSON 数据放入对应的请求参数；
- 发送请求并检查接口响应。
任务创建成功后，响应中会返回 taskId。请保存该值，后续查询进度和获取结果时需要使用它。
如果任务创建接口直接返回错误，请先检查 API Key、请求地址、请求方式和 JSON 格式。
第四步：查看进度和渲染结果
任务发起后，可通过以下两种方式获取执行状态：
主动查询
前往查询任务结果，使用 taskId 查询任务进度。首次试用建议采用这种方式，因为无需额外准备回调服务。
当任务状态为完成且结果成功时，响应中会提供合成视频地址。请打开视频确认画面、声音、字幕和特效是否符合预期，并根据页面提示及时下载试用产物。
接口回调
可以查看：
试用完成检查
满足以下条件，说明服务端合成渲染的基础流程已经跑通：
- 任务创建接口调用成功；
- 已获得有效的
taskId； - 能够查询到任务进度，或成功收到回调；
- 任务执行成功，并获得合成视频地址；
- 视频可以正常打开，且内容与所选 JSON 示例一致。
常见问题排查
鉴权失败
确认使用的是当前试用环境对应的 API Key，并检查鉴权信息是否按照提供的方式放入请求。不要在排查过程中公开 API Key。
请求参数错误
重新从 JSON 示例页面复制完整内容，并对照发起合成任务检查请求体结构、请求方式和 Content-Type。
素材无法读取
确认 JSON 中的视频、音频和图片地址有效，并且合成服务能够访问这些地址。仅能在个人电脑本地访问的文件路径不能直接作为远程合成素材地址。
任务执行失败
通过查询任务结果查看错误信息；如果无法自行定位，请将 taskId、错误信息和复现步骤提供给美摄技术支持。请勿提供 API Key。
下一步
完成首次试用后，可以继续阅读时间线 JSON 数据结构说明，了解如何定制视频内容；如需一次处理多个合成或转码任务，可进一步查看批量渲染的部署与扩展方案。