大模型服务平台 TokenHub HY-3D 调用指南

这篇档适用范围：hy-3d-3.0，hy-3d-3.1

一、简介

混元生3d 接口，基于混元大模型，根据输入的文本描述/图片智能生成3d。

二、1. 获取 API Key

1. 进入 API Key 管理 页面，单击创建 API Key。操作详情请参见 创建 API Key。

2. 创建完成后，请你务必复制并妥善保管 API Key，在后续配置到工具的流程中将会使用该信息。

注意：说明：

注意：每个账户的密钥都只能当前账户查询，主账户的密钥信息子账户是看不到，子账户如果需要调用接口，需要使用账户自行创建密钥信息。

注意：如果子账户没有办法创建，可能是没有权限创建密钥，需要主账户授权，主账户登录之后点击用户列表，在对应的子账户后面选择授权，会弹出关联策略的弹窗，输入授权策略名称之后搜索，选择对应的策略点击确认。

注意：授权策略：QcloudTokenhubFullAccess

三、2. 并发额度

默认提供3个并发，代表最多能同时处理3个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。

并发任务数：表示在调用对应服务的时段内最大可运行的任务数，该任务未完成时，无法提交下一个任务，该任务完成后，可提交下一个任务。

四、提交混元生3d 专业版任务

输入参数

输出参数

五、查询混元生3d 专业版任务

输入参数

输出参数

六、提交混元生3d 专业版任务

输入示例

curl -X POST 'https://tokenhub.tencentmaas.com/v1/api/3d/submit' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "hy-3d-3.1", "prompt": "一只小狗" }'

输出示例

{ "id": "14721*****320", "request_id": "11f64379-bb0b-46b2-b89f-17d75fc12365", "object": "3d_job", "created_at": 1784885898, "status": "queued"}

七、查询混元生3d 专业版任务

输入示例

curl -X POST 'https://tokenhub.tencentmaas.com/v1/api/3d/query' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "hy-3d-3.1", "id": "14721*****320" }'

输出示例

{"request_id":"ab3beaeb-b4aa-4387-b5aa-e2ec1bba4ef0","object":"3d_job","created_at":1784884760,"completed_at":1784884760,"status":"completed","data":[{"type":"obj","url":"https://hunyuan-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3d/output/1254418*****d3272_0.zip","preview_image_url":"https://hunyuan-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3d/output/12544*****2-89ec2ff1967a_0.png"},{"type":"glb","url":"https://hunyuan-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3d/output/125441************ec2ff1967a_0.glb","preview_image_url":"https://hunyuan-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/3d/output/125441*******-bbe2-89ec2ff1967a_0.png"}]}

八、data

生成结果对象。

九、view_image

多视角输入图片对象。