Producer 下载视频 API 对接说明
内容提要
本文介绍Producer下载视频API的对接方法。该API仅需输入audio_id参数（歌曲唯一ID），通过POST请求发送至指定URL，并携带授权令牌。示例展示了请求格式和响应结果，其中data字段中的video_url即为视频下载链接。
延伸解读
接口设计简洁，但需注意鉴权
该API仅需一个audio_id参数，通过POST请求即可获取视频下载链接，设计上非常简洁。但请求头中必须携带authorization: Bearer {token}，开发者需提前获取有效的授权令牌。若令牌无效或过期，请求将失败，因此在实际对接时，应确保令牌的正确性和时效性，并做好错误处理。
响应结构清晰，但需关注任务状态
响应中除了data.video_url外，还包含task_id和trace_id。task_id可能用于追踪任务进度，trace_id则便于排查问题。虽然示例中直接返回了视频链接，但若视频生成需要时间，API可能采用异步模式，开发者需根据实际响应判断是否需要轮询任务状态，避免因未处理异步逻辑而获取不到最终链接。
视频链接有效期与存储策略
示例中的video_url指向CDN上的mp4文件，但未说明链接的有效期。通常此类临时链接可能有过期时间，开发者应在获取后及时下载或转存，避免链接失效。同时，若需长期使用，建议将视频存储到自己的服务器或对象存储中，以确保持久可用。
Q&A
Producer下载视频API需要哪些参数？
只需要一个参数audio_id，即歌曲的唯一ID。
如何调用Producer下载视频API？
使用POST请求发送到https://api.acedata.cloud/producer/videos，请求头需包含accept: application/json、authorization: Bearer {token}和content-type: application/json，请求体为JSON格式，包含audio_id字段。
Producer下载视频API的响应中如何获取视频下载链接？
响应中的data字段下的video_url字段即为视频下载链接。
Producer下载视频API需要认证吗？
需要，请求头中必须包含authorization: Bearer {token}，其中{token}需要替换为有效的授权令牌。
Producer下载视频API的请求方法是什么？
使用POST方法。
Producer下载视频API的请求体格式是什么？
请求体为JSON格式，包含audio_id字段，例如：{"audio_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f"}。
