跳转到主要内容

快速开始

3D 生成是异步操作,整个流程分为三步:
最简示例

接口概览

Base URL:https://aihubmix.com 认证方式:Bearer Token
与视频接口不同,3D 接口没有 /content 下载端点和 DELETE 删除端点:产物通过查询响应 output[] 中的 content_url 直接下载。

支持的模型

生成类型(generate_type

API 详细说明

请求头

创建 3D 生成任务

请求体

参数校验规则
  • promptinput_references 互斥(只能传其一),仅 generate_type: "Sketch" 允许两者同传(草图 + 文字描述)。
  • input_references 每项中 image_urlimage_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:modelpromptimage_urlimage_base64generate_typeenable_pbrface_countresult_formatmulti_view_images(多视角图)暂不支持。

响应示例

状态值说明

查询任务状态

轮询此接口检查任务是否完成。建议每 10~15 秒 查询一次。查询不计费。

响应示例(生成完成)

output[] 字段说明
content_urlpreview_url临时链接,会在一段时间后过期,请在任务完成后尽快下载并转存到自己的存储。任务 ID 自创建起 24 小时内可查询(expires_at 字段即查询截止时刻),过期后查询将返回错误。临时链接仅支持 GET 请求,HEAD 请求会返回 403。

使用示例

完整调用示例

计费说明

  • 计费:价格由 模型 × generate_type × 是否启用 PBR × 是否指定面数 × 是否指定格式 的组合决定,具体价格见模型广场
  • 计费发生在任务创建成功时;查询任务状态与下载产物不计费。
  • 未配置价格的参数组合会在创建时直接返回 400,不会产生扣费。

FAQ

3D 生成需要多长时间?

通常需要数分钟,具体取决于模型、生成类型与面数设置。建议以 10~15 秒的间隔轮询查询接口。

产物链接和任务的有效期是多久?

  • 任务 ID 自创建起 24 小时内可查询,响应中的 expires_at 字段即查询截止时刻。
  • content_url / preview_url 为上游临时链接,会在一段时间后过期,请在任务完成后尽快下载转存

可以同时传 prompt 和参考图吗?

不可以,两者互斥——唯一例外是 generate_type: "Sketch"(草图生 3D),允许同时传入草图图片与文字描述。

generate_type 各类型有什么区别?

任务失败怎么处理?

statusfailed 时,响应中的 error 字段包含错误信息:
常见失败原因包括:内容不合规、图片格式不支持、参考图无法访问等。请根据错误信息调整后重试。
更新时间:2026-07-17