HY-3D 生成
HY-3D 使用异步接口:先提交任务,再通过平台任务 ID 查询结果。支持返回多种模型文件和预览图。请使用平台域名、平台 API Key 和模型广场展示的模型名称。
本文中的模型名为配置示例;可先通过
GET /v1/models 确认当前账号可用的模型。模型与生成模式
Normal:默认模式,生成带纹理模型。Geometry:生成不带纹理的白模。Sketch:草图或线稿生成,可同时提供文字和图片。LowPoly:智能拓扑,支持三角面或四边面混合网格,仅 3.0 可用。
快速开始
下面生成白模。Python 示例包含提交、轮询和下载,依赖requests,运行前设置环境变量 API_KEY。
输入示例
单图生成
image_url 与 image_base64 二选一。除 Sketch 模式外,不要同时传文字与图片。
多视图生成
提供主图和辅助视图,每个视角最多一张图片:草图生成
低面数模型与附加格式
LowPoly 仅支持 3.0。result_format 每次只能指定一种附加格式:
请求参数
multi_view_images
主图支持 JPG、PNG、JPEG、WebP,图片单边尺寸为 128–5000 像素;URL 图片不超过 8 MB。
辅助多视图支持 JPG、PNG,单张小于 8 MB,总大小小于 100 MB,单边尺寸需大于 128 且小于 5000。
图片必须可以被服务读取,尺寸与格式由生成服务检查。
HY-3D 使用自己的输入参数,不接受 Tripo 的
input、inputs、texture、pbr、face_limit。
参数能力见 HY-3D 调用指南。
查询任务
使用提交响应中的平台任务id 查询;查询时只需传 id:
cURL
任务状态
响应头
X-Task-ID 也会提供平台任务 ID。请求超时或提交返回 5xx 时,
如已获取任务 ID,应先查询该任务,避免重复提交产生额外费用。
成功响应
data 保留返回的所有格式;实际格式取决于生成模式与 result_format。
所有结果文件就绪后返回 completed,下载链接有效期为 1 天,重新查询可获取新链接。
计费说明
HY-3D 根据生成模式与附加参数计算目录金额,按 1 积分 = ¥0.12 换算。 查询接口可能不返回credits_consumed,调用方不应把该字段缺失视为免费。
多视图、有效 PBR、自定义面数各加 10 积分(¥1.20),附加格式加 5 积分(¥0.60)。
默认面数 500000 不加价;
Geometry 的 PBR 和 LowPoly 的面数参数不生效且不加价。
例如,Geometry 且未附加其他计费项时,目录金额为 ¥1.80。
预付费调用提交时预扣,成功后核对,明确失败的生成任务退款;后付费调用成功后扣款。
最终销售费用取决于模型价格倍率和用户折扣,以调用时模型广场价格及结算结果为准。
文件转存重试不会重新生成或重复扣费。
厂商规则见 TokenHub 模型价格与
混元生 3D 计费说明。

