tencent cloud

快速入门
下载PDF
最后更新时间：2025-11-04 14:50:34
快速入门
最后更新时间： 2025-11-04 14:50:34
下载PDF

操作场景

本文将为您介绍如何使用 API 3.0 Explorer 在线调试腾讯混元生3D 相关接口。

准备工作

在使用腾讯混元生3D 服务前，您需要先注册腾讯云账号。如果没有账号，请参考 注册腾讯云 教程。

操作步骤

1. 开通腾讯混元大模型服务

注册并通过实名认证后，登录 腾讯混元大模型控制台，阅读和同意相关服务协议，并单击开通，即可开通服务。

2. 获取密钥信息

密钥是指：SecretId 和 SecretKey ，为降低密钥泄露的风险，自2023年11月30日起，对所有主账号、子账号的密钥，关闭查询 SecretKey 的功能，仅支持在创建时查看，请及时保存 SecretKey 。如果忘记 SecretKey ，可以删除密钥之后重新创建一个。
说明：
子账户调用需要主账户授权才可以使用，主账户登录之后点击用户列表，在对应的子账户后面选择授权，会弹出关联策略的弹窗，输入授权策略名称之后搜索，选择对应的策略点击确认。
地址：https://console.tencentcloud.com/cam
授权策略：QcloudAI3DFullAccess


3. 调用 API 接口（示例）

因为混元生3D 专业版接口是异步接口，需要调用提交混元生3D 专业版任务跟查询混元生3D 任务2个接口。
接口
说明
提交混元生3D 任务
输入 Prompt 或者图片之后提交请求，请求成功会返回一个 JobId。
查询混元生3D 专业版任务
通过提交混元生3D 专业版任务返回的 JobId 去查询结果信息。
任务状态说明：
WAIT ：等待中。
RUN ：执行中。
FAIL ：任务失败。
DONE ：任务成功。
QueryHunyuanTo3DProJob 接口提交查询的时候会返回 Status（任务状态），当 Status 为 FAIL 或者 DONE 的时候，表示任务已经处理完成。
如果 Status 为 DONE ：可以通过返回的 ResultFile3Ds 参数获取到结果文件。
如果 Status 为 FAIL ：可以通过返回的 ErrorCode 参数跟 ErrorMessage 参数获取报错原因。
如果 Status 为 WAIT 或者 RUN ：则表示没有拉取到结果信息，需要继续拉取。

通过 API Explorer 在线调用接口

说明：
对应参数说明可前往 API 接口文档 查看。
调用提交混元生3D 专业版任务接口：输入参数之后点击发起调用，会返回提交混元生3D 任务的结果信息。
请求成功会返回 JobId 跟 RequestId 。
请求失败会返回失败的 Code 和 Message 。
调用查询混元生3D 专业版任务接口：通过提交混元生3D 专业版任务成功的 JobId 获取结果信息。
任务状态说明：
WAIT ：等待中。
RUN ：执行中。
FAIL ：任务失败。
DONE ：任务成功。
提交查询的时候会返回 Status（任务状态），当 Status 为 DONE 、FAIL 的时候，表示任务已经处理完成。
如果 Status 为 DONE ：可以通过返回的 ResultFile3Ds 参数获取到结果信息。
如果 Status 为 FAIL ：可以通过返回的 ErrorCode 参数跟 ErrorMessage 参数获取报错原因。
如果 Status 为 WAIT 或者 RUN ：则表示没有拉取到结果信息，需要继续拉取。


本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈