V-API

任务：图片转3D模型

POST

/task/gi/image-to-3d

提示

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data

image

file

可选

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

num_inference_steps

number

可选

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

>= 2<= 50

默认值:

示例值:

octree_resolution

number

可选

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

>= 16<= 400

默认值:

128

示例值:

128

guidance_scale

number

可选

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

>= 1<= 20

默认值:

示例值:

type

string

输出格式

可选

示例值:

glb

seed

number

随机种子

可选

>= 0<= 10000000

默认值:

1234

示例值:

1234

texture

boolean

可选

是否生成纹理，注意传此参数会调用不同收费等级api

示例值:

false

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.gpt.ge/task/gi/image-to-3d' \
--form 'image=@""' \
--form 'num_inference_steps="5"' \
--form 'octree_resolution="128"' \
--form 'guidance_scale="5"' \
--form 'type="glb"' \
--form 'seed="1234"' \
--form 'texture="false"'

返回响应

🟢200成功

application/json

Body

string

必需

model

string

必需

results

array [object {3}]

必需

flagged

boolean

可选