跳转到主要内容
POST
文本生成模型

授权

Authorization
string
header
默认值:YOUR_TOKEN
必填

使用 Neural4D 网站提供的 Bearer token。

请求体

application/json
mesh_quality
enum<string>
默认值:high
必填

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

可用选项:
standard
prompt
string
必填

用于生成 3D 模型的文本提示词。

Minimum string length: 1
示例:

"people"

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
示例:

"Generating"

uuids
string<uuid>[]
必填

可在后续查询模型时使用的 UUID 列表。

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

纯文本生成时始终为 null。

pointsDeducted
integer | null

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

generationConfig
object | null

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