
从注册到生成第一个3D 模型,完整流程约 10 分钟。以腾讯混元生3D 为例。
在 混元3D 官网 直接输入文字描述,点击生成,90秒内获得3D 模型。
pip install tencentcloud-sdk-pythonimport json, time
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.ai3d.v20250513 import ai3d_client, models
SecretId = "你的SecretId"
SecretKey = "你的SecretKey"
Region = "ap-guangzhou"
cred = credential.Credential(SecretId, SecretKey)
httpProfile = HttpProfile()
httpProfile.endpoint = "ai3d.tencentcloudapi.com"
clientProfile = ClientProfile()
clientProfile.httpProfile = httpProfile
client = ai3d_client.Ai3dClient(cred, Region, clientProfile)
req = models.SubmitHunyuanTo3DProJobRequest()
req.from_json_string(json.dumps({"Prompt": "一只熊猫"}))
resp = client.SubmitHunyuanTo3DProJob(req)
job_id = resp.JobId
while True:
q = models.QueryHunyuanTo3DProJobRequest()
q.from_json_string(json.dumps({"JobId": job_id}))
r = client.QueryHunyuanTo3DProJob(q)
if r.Status == "DONE":
for f in r.ResultFile3Ds:
print(f"格式: {f.Type}, URL: {f.Url}")
break
elif r.Status == "FAIL":
print(f"失败: {r.ErrorMessage}")
break
time.sleep(5)参数 | 作用 | 积分 |
|---|---|---|
Prompt | 文本描述 | - |
ImageUrl | 图片URL | - |
GenerateType | Normal/LowPoly/Geometry/Sketch | 15-25 |
EnablePBR | 生成PBR贴图 | +10 |
FaceCount | 自定义面数 | +10 |
默认返回 OBJ 和 GLB。需要其他格式调用 Convert3DFormat 接口:
目标格式 | 用途 | 积分 |
|---|---|---|
FBX | Unity/Unreal | 5 |
STL | 3D 打印 | 5 |
USDZ | Apple AR | 5 |
GIF | 电商预览 | 5 |
100 免费积分的花法:极速版(15)+ Normal(20)+ Geometry(15)+ 智能拓扑(50)= 100积分,跑完4次就能判断生成质量是否满足需求。
不想写代码也可以用 API Explorer 在线调试。
参考来源:腾讯混元生3D 快速入门、API 概览
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。