使用Model Derivative API转换RVT为SVF格式报错求助

1. "Invalid 'design' parameter" 是否由URN导致？ #

大概率是URN参数错误导致的，这个错误提示里的design参数对应请求中的URN，当URN格式不正确、未关联已上传的文件，或者编码错误时，就会触发这个报错。

2. URN参数应填写什么内容？ #

URN是已上传到Forge OSS（对象存储服务）的文件的唯一标识，获取并生成正确URN的步骤：

• 先通过Forge OSS API创建一个存储桶（如果没有现成的）
• 调用OSS的文件上传接口，将本地RVT文件上传到存储桶中，拿到返回的objectId
• 对objectId进行URL安全的Base64编码：把标准Base64编码里的+替换成-，/替换成_，并去掉末尾的=符号，得到的结果就是要使用的URN

举个例子：如果objectId是abc123-def456，标准Base64编码后是YWJjMTIzLWRlZjQ1Ng==，URL安全编码后就是YWJjMTIzLWRlZjQ1Ng，这就是你要填的URN。

3. 如何获取SVF压缩包？ #

Model Derivative API不会直接生成SVF压缩包，但可以通过以下步骤获取所有SVF相关文件并自行打包：

• 当文件转换完成后，调用GET /modelderivative/v2/designdata/{urn}/manifest接口，在返回的清单中找到类型为application/autodesk-svf的衍生资源，记录它的derivativeUrn
• 调用GET /modelderivative/v2/designdata/{urn}/manifest/{derivativeUrn}接口，获取该SVF包含的所有文件列表（如.svf、.bin、.png等）
• 逐个调用文件下载接口（每个文件的url字段会提供下载地址），下载所有文件后手动打包成压缩包

另外，你也可以使用Forge官方提供的下载工具（如Forge CLI的download命令）来批量下载这些文件，简化操作。

新手额外提示 #

• 所有Forge API调用都需要先获取OAuth2的访问令牌（access token），请求头中要携带Authorization: Bearer <你的token>
• 确保上传的RVT文件版本在Forge支持的范围内，避免因文件版本不兼容导致转换失败

内容的提问来源于stack exchange，提问作者oğuzhan kömcü