常见问题
接入前需要准备什么?
登录本站账户,激活试用积分包或购买积分包,并创建已启用的 API 密钥。购买前完成本站要求的邮箱或手机号绑定。
如何创建和管理 API 密钥?
前往 API 密钥。单账户最多 10 个。Secret Key 仅创建时显示一次;可编辑名称、启用或禁用。删除前先禁用,删除后不可恢复,依赖该密钥的调用会失效。
如何修改个人信息?
Platform 个人信息页只读展示已绑定邮箱及验证状态。暂不支持更换已绑定邮箱或手机号。首次使用时的必需绑定仍在 Platform 按提示完成。
提交成功后为什么还没有模型?
任务采用异步方式。保存返回的 task_id,继续查询 data.state;success 时读取结果链接。created、queueing、processing 均不是完成状态。详见 服务流程。
是否支持批量生成?
支持并行提交,基础并发额度为 50 个任务。
- 每次调用创建一个任务,分别保存并查询各自的
task_id。多视图用于生成同一个模型。 - 专属并发额度以控制台显示为准。超额提交按排队或限流规则处理,并发额度和请求速率分别计算。
多视图如何上传?
- 提供 2–4 张图片,必须包含正面图,每张不超过 20 MB。
- 按前、后、左、右的顺序上传提供的视图。
- 用
multi_images_bit标记视角。1的数量须等于图片数,例如1010表示前视图和左视图。
模型、分辨率和文件格式怎么选?
查看 Hi3D 概述 中的能力与模型列表,再按对应接口核对完整枚举、默认值、文件大小及条件参数。DepthMap 的 Base/Pro 是分辨率,接口仍传 model_type。
失败或超时会扣积分吗?
- 扣除与返还:任务提交成功即扣除积分,排队中和生成中均已扣除。任务失败后返还,实际扣退以任务记录为准。
- 参数校验失败:未创建任务时不消耗生成积分。
- 超时:服务端生成超时阈值为 60 分钟。客户端请求超时后,先用原
task_id查询状态。
结果链接有效多久?
结果文件和效果图的链接有效期为 1 小时,适用于图生3D、图生浮雕、图生刺绣、贴图、拆件和多色。
过期后,用原 task_id 重新查询获取有效链接。
如何排查错误?
检查网络、文件格式与大小、积分余额和模型参数;多视图须有正面图。队列繁忙时降低提交节奏或稍后重试。具体错误码见 错误处理。
如何按客户或项目对账?
使用不同 API 密钥区分项目,在任务记录中选择密钥和创建日期区间,导出全部筛选记录。导出保留模型、分辨率、任务类型、PBR 和实际消耗积分等计费字段。
如何获得技术或商务支持?
接口问题请联系 apicontact@hi3d.ai。提供任务 ID、错误码和必要的环境信息,不要发送 Secret Key。更大用量或定制服务请 联系销售。
图生刺绣如何接入?
- 提交一张图片(文件或 URL),指定宽度或长度,并填写颜色数量、针迹密度和输出格式。
- 查询任务状态,或接收账户级 Webhook 通知。
- 成功后下载 DST 或 TBF 文件及效果图。
如何按时区查询和导出任务?
在控制台任务记录中选择 UTC±X 时区。创建日期的起止边界、创建 / 完成时间、详情与导出文件使用同一选择;默认 UTC+0,并记忆选择。其他页面仍按其标注的 UTC+0 显示,原时间存储及生成时长不变。
超过 5 万条任务记录如何导出?
以实际导出日期范围、筛选条件和时区匹配的总记录数为准。以下为导出方式建议,并非记录数限制。
- 5 万条及以内:推荐直接下载 CSV。
- 超过 5 万条:推荐选择「大批量导出」并确认已验证邮箱。系统按提交时的筛选条件和时区生成完整 CSV,再作为邮件附件发送。
导出失败后可重试。导出不消耗生成积分。
技术支持:apicontact@hi3d.ai