Skip to main content
POST
3D图片生成接口
注意:目前仅 hunyuan-3dhunyuan-3d-prohunyuan-3d-pro-fastdoubao-seed3d-1.0 模型支持3D生成,其他模型不支持。

请求/响应参数明细

授权

Authorization
string
header
必填

API认证token

请求体

application/json
model
string
必填

3D模型

示例:

"hunyuan-3d"

prompt
string

文本提示

示例:

"画一只可爱的小猫"

image
string

基于图片生成3D,支持图片URL/Base64编码,如果包含多视角则该参数值为前视图,大小不超过8M

multi_view_images
object[]

多视角图片列表,仅混元3D和混元3D专业版支持该参数,支持图片URL/Base64编码。

result_format
enum<string>
默认值:OBJ

3D输出格式设置,仅混元3D支持该参数,豆包3D通过文本提示指令设置。

可用选项:
OBJ,GLB,STL,USDZ,FBX,MP4
enable_pbr
boolean
默认值:false

是否开启PBR材质,默认false,仅混元3D支持该参数。

face_count
integer
默认值:500000

3D模型面数,仅混元3D专业版支持该参数,默认500000,取值范围[40000,1500000]

extra_body
object

额外参数配置项,以适配不同3D模型的多样化配置,仅混元3D专业版支持该参数。

async
boolean
默认值:false

是否异步生成,默认false,即同步等待图片生成成功后返回生成结果,如果异步需要通过调用图片获取接口获取生成结果

retries
integer
默认值:0

自动重试次数,默认0,表示失败不重试

响应

成功响应

created
integer<unix-timestamp>
必填

创建时间戳

data
object[]
必填

生成的3D文件列表(仅在task_status=succeed时返回)

task_id
string<uuid>

任务ID

task_status
enum<string>

任务状态

可用选项:
pending,
running,
succeed,
failed
示例:

"running"