任务：图片转3D模型

POST

/task/gi/image-to-3d

提示

极速体验，仅需数秒～十多秒即可转换完成。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data

model

string

必需

支持模型 Hunyuan3D-2、Hi3DGen、Step1X-3D

示例:

Hunyuan3D-2

image

file

必需

图片File对象，请上传png背景透明的图片。可下载该图再上传测试。

texture

boolean

是否生成纹理

可选

默认值:

false

示例:

false

num_inference_steps

number

可选

生成结果时模型执行迭代的次数。数值越大，生成的质量会更高

>= 2<= 50

默认值:

示例:

octree_resolution

number

可选

影响 3D 渲染/体素划分精度，越高3D 细节越丰富

>= 16<= 400

默认值:

128

示例:

128

guidance_scale

number

可选

调节模型在生成结果时对输入提示的遵从程度，数值越大，遵从越严格

>= 1<= 20

默认值:

示例:

file_format

enum<string>

可选

输出格式，Hunyuan3D-2不支持该参数。

枚举值:

glbstl

默认值:

glb

示例:

glb

type

string

可选

输出格式，仅 Hunyuan3D-2支持该参数。

示例:

glb

seed

number

随机种子

可选

>= 0<= 10000000

默认值:

1234

示例:

1234

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.pawmaas.com/task/gi/image-to-3d' \
--header 'Authorization: Bearer <token>' \
--form 'model="Hunyuan3D-2"' \
--form 'image=@""' \
--form 'texture="false"' \
--form 'num_inference_steps="5"' \
--form 'octree_resolution="128"' \
--form 'guidance_scale="5"' \
--form 'file_format="glb"' \
--form 'type="glb"' \
--form 'seed="1234"'

返回响应

🟢200成功

application/json

Body

string

必需

model

string

必需

results

array [object]

必需

flagged

boolean

可选