快速开始
3D 生成是异步操作,整个流程分为三步:接口概览
Base URL:
https://aihubmix.com
认证方式:Bearer Token
与视频接口不同,3D 接口没有
/content 下载端点和 DELETE 删除端点:产物通过查询响应 output[] 中的 content_url 直接下载。支持的模型
生成类型(
generate_type)
API 详细说明
请求头
创建 3D 生成任务
请求体
参数校验规则
prompt与input_references互斥(只能传其一),仅generate_type: "Sketch"允许两者同传(草图 + 文字描述)。input_references每项中image_url与image_base64必须恰好传一个:image_url仅支持http(s)公网 URL,不支持 data URL(请改用image_base64);image_base64解码后不超过 6MB。
hy-3d-3.1不支持LowPoly生成类型。- 请求体总大小不超过 10MB。
extra_body 使用说明:上游原生参数(如 polygon_type)可放入 extra_body 顶层透传。以下参数必须使用顶层字段传入,出现在 extra_body 中会返回 400:model、prompt、image_url、image_base64、generate_type、enable_pbr、face_count、result_format;multi_view_images(多视角图)暂不支持。响应示例
状态值说明
查询任务状态
响应示例(生成完成)
output[] 字段说明
使用示例
完整调用示例
计费说明
- 按次计费:价格由
模型 × generate_type × 是否启用 PBR × 是否指定面数 × 是否指定格式的组合决定,具体价格见模型广场。 - 计费发生在任务创建成功时;查询任务状态与下载产物不计费。
- 未配置价格的参数组合会在创建时直接返回 400,不会产生扣费。
FAQ
3D 生成需要多长时间?
通常需要数分钟,具体取决于模型、生成类型与面数设置。建议以 10~15 秒的间隔轮询查询接口。产物链接和任务的有效期是多久?
- 任务 ID 自创建起 24 小时内可查询,响应中的
expires_at字段即查询截止时刻。 content_url/preview_url为上游临时链接,会在一段时间后过期,请在任务完成后尽快下载转存。
可以同时传 prompt 和参考图吗?
不可以,两者互斥——唯一例外是 generate_type: "Sketch"(草图生 3D),允许同时传入草图图片与文字描述。
generate_type 各类型有什么区别?
任务失败怎么处理?
当status 为 failed 时,响应中的 error 字段包含错误信息:
更新时间:2026-07-17