跳转到主要内容
POST
图片生成模型

授权

Authorization
string
header
默认值:YOUR_TOKEN
必填

使用 Neural4D 网站提供的 Bearer token。

请求体

multipart/form-data
mesh_quality
enum<string>
默认值:high
必填

网格质量等级。支持 standard、high 和 extra_high。

可用选项:
standard
image
file
必填

必填输入文件。multipart 文件部分必须使用 image/* Content-Type,且不得超过 50 MB。

faceNum
integer

目标面数。standard 支持 100000 到 500000,默认 500000;high 和 extra_high 支持 500000 到 1000000,默认 1000000。

必填范围: 100000 <= x <= 500000
modelCount
integer
默认值:4

生成模型的数量。

必填范围: 1 <= x <= 4
disablePbr
enum<integer>
默认值:0

PBR 开关。使用 0 开启 PBR,使用 1 关闭 PBR。

可用选项:
0,
1
onlyGenerateMesh
boolean
默认值:false

是否仅生成网格,不生成纹理或 PBR 输出。

响应

生成任务已接受,或请求未通过内容审核。

type
enum<string>
必填

响应来源或类型标记。

可用选项:
sys
示例:

"sys"

message
enum<string>
必填

生成状态消息。

可用选项:
Generating
uuids
string<uuid>[]
必填

可用于查询生成模型的 UUID 列表。

Required array length: 1 - 4 elements
uploadedImageUrl
string<uri> | null
必填

上传源图片的签名访问地址;无法生成地址时为 null。

pointsDeducted
integer | null

可用时返回本次请求扣除的点数。

generationConfig
object | null

本次生成请求实际采用的标准化面数配置。