产品概述
产品优势
应用场景
腾讯混元生3D 快速入门
操作场景
本文将为您介绍如何使用 API 3.0 Explorer 在线调试腾讯混元生3D 相关接口。
准备工作
操作步骤
1. 开通腾讯混元大模型服务
2. 获取密钥信息
密钥是指：SecretId 和 SecretKey ，为降低密钥泄露的风险，自2023年11月30日起，对所有主账号、子账号的密钥，关闭查询 SecretKey 的功能，仅支持在创建时查看，请及时保存 SecretKey 。如果忘记 SecretKey ，可以删除后重新创建一个。
说明：
子账户调用需要主账户授权才可以使用，主账户登录之后点击用户列表，在对应的子账户后面选择授权，会弹出关联策略的弹窗，输入授权策略名称之后搜索，选择对应的策略点击确认。
授权策略：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 在线调用接口
说明：
调用提交混元生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 ：则表示没有拉取到结果信息，需要继续拉取。
文档反馈