POST
/
image3ds
/
generations
3D图片生成接口
curl --request POST \
  --url https://geekai.co/api/v1/image3ds/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "hunyuan-3d",
  "prompt": "画一只可爱的小猫",
  "image": "<string>",
  "multi_view_images": [
    {
      "view_type": "left",
      "view_image_url": "<string>"
    }
  ],
  "result_format": "OBJ",
  "enable_pbr": false,
  "async": false,
  "retries": 0
}'
{
  "task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "task_status": "running",
  "created": 123,
  "data": [
    {
      "type": "OBJ,GLB,STL,USDZ,FBX,MP4",
      "url": "<string>",
      "preview_url": "<string>"
    }
  ]
}
注意:目前仅 hunyuan-3d 模型支持文/图生3D,其他模型不支持。

请求/响应参数明细

Authorizations

Authorization
string
header
required

JWT认证token

Body

application/json
model
string
required

3D模型

Example:

"hunyuan-3d"

prompt
string

文本提示

Example:

"画一只可爱的小猫"

image
string

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

multi_view_images
object[]

多视角图片列表

result_format
enum<string>
default:OBJ

3D输出格式设置

Available options:
OBJ,GLB,STL,USDZ,FBX,MP4
enable_pbr
boolean
default:false

是否开启PBR材质,默认false

async
boolean
default:false

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

retries
integer
default:0

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

Response

成功响应

created
integer
required

创建时间戳

data
object[]
required

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

task_id
string<uuid>

任务ID

task_status
enum<string>

任务状态

Available options:
pending,
running,
succeed,
failed
Example:

"running"