Skip to main content

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
只能使用提交任务时的用户和 API Key 查询。建议每 10 秒查询一次。 客户端停止查询不会取消任务。任务记录保留 7 天。

任务状态

响应头 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 计费说明。

常见错误