Sign in

v1

latestOpenAPI 3.1.02026-07-2634132204.7 KB
Image3d

3D图片生成接口

基于文本提示/参考图生成3D的接口，支持多种图片生成模型和参数配置

post/image3ds/generations

Request body

modelstring required

3D模型

promptstring

文本提示

imagestring

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

result_format'OBJ，GLB，STL，USDZ，FBX，MP4'

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

enable_pbrboolean

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

face_countinteger

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

asyncboolean

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

retriesinteger

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

Example request

{
  "model": "hunyuan-3d",
  "prompt": "画一只可爱的小猫",
  "multi_view_images": [
    {
      "view_type": "left"
    }
  ]
}

Response

成功响应

task_idstring uuid

任务ID

task_status'pending' | 'running' | 'succeed' | 'failed'

任务状态

createdinteger required

创建时间戳

Example response

{
  "task_status": "running"
}
All 34 operations