文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯混元生3D>快速入门

快速入门

最近更新时间：2025-11-11 18:01:21

我的收藏

本页目录：

操作场景

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

准备工作

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

操作步骤

1. 开通腾讯混元生3D 服务

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

2. 获取密钥信息

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

调用提交混元生3D 专业版任务接口：输入参数之后点击发起调用，会返回提交混元生3D 专业版任务的结果信息。
说明：
对应参数说明可前往 API 接口文档 查看。
成功结果参考：请求成功会返回 JobId 跟 RequestId 。

失败结果参考：请求失败会返回失败的 Code 和 Message 。
{
  "Response": {
    "Error": {
      "Code": "FailedOperation.DownloadError",
      "Message": "文件下载失败。"
    },
    "RequestId": "da95773b-b659-4555-b94e-c6000c283730"
  }
}

调用查询混元生3D 专业版任务接口：通过提交混元生3D 专业版任务成功的 JobId 获取结果信息。
任务状态说明：
WAIT ：等待中。
RUN ：执行中。
FAIL ：任务失败。
DONE ：任务成功。
提交查询的时候会返回 Status（任务状态），当 Status 为 DONE 、FAIL 的时候，表示任务已经处理完成。
如果 Status 为 DONE ：可以通过返回的 ResultFile3Ds 参数获取到结果信息。
如果 Status 为 FAIL ：可以通过返回的 ErrorCode 参数跟 ErrorMessage 参数获取报错原因。
如果 Status 为 WAIT 或者 RUN ：则表示没有拉取到结果信息，需要继续拉取。
返回成功结果：
{
  "Response": {
    "ErrorCode": "",
    "ErrorMessage": "",
    "RequestId": "626734da-d939-4a81-bea5-7df7bc4a0f43",
    "ResultFile3Ds": [
      {
        "PreviewImageUrl": "https://hunyuan-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3d/output/***/preview_525ba498-c8d9-40eb-a33c-62b979cd21ca_0.png?***e827ab0aa9cdf",
        "Type": "OBJ",
        "Url": "https://hunyuan-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3d/output/***/525ba498-c8d9-40eb-a33c-62b979cd21ca_0.zip?***b7b87570"
      },
      {
        "PreviewImageUrl": "https://hunyuan-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3d/output/***/preview_525ba498-c8d9-40eb-a33c-62b979cd21ca_0.png?***27ab0aa9cdf",
        "Type": "GLB",
        "Url": "https://hunyuan-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3d/output/**/525ba498-c8d9-40eb-a33c-62b979cd21ca_0.glb?q-sign-algorithm=***aa2e7c0bb967512d5"
      }
    ],
    "Status": "DONE"
  }
}


方式二：安装 SDK 调用接口

点击代码示例，可以查询到目前可以安装 SDK 的开发语言，选择安装对应版本的 SDK 进行调用，如下图：


中国站
目录