跳转到主要内容
POST

授权

string
默认值:"Bearer ${YOUR_API_KEY}"
必填
使用 Bearer 方式发送的 Neural4D API 密钥。

请求体 application/json

enum<string>
必填
公开模型标识。可选值:dreamtech/neural4d-2.5。
string
必填
描述待生成模型的文本提示词。不能为空,最多 500 个字符。
boolean
默认值:false
是否生成纹理。设为 false 时仅生成网格。
boolean
默认值:false
是否生成 PBR 材质。为 true 时,with_texture 必须为 true。
enum<string>
默认值:"standard"
网格质量:standard、high 或 extra_high。
enum<string>
默认值:"triangle"
网格拓扑:triangle 或 quad。
integer
默认值:500000
目标面数。三角面 standard 为 100,000–500,000,默认 500,000;三角面 high、extra_high 为 500,000–1,000,000,默认 1,000,000;四边面为 1,000–100,000,默认 50,000。三角面以 1,000 递增,四边面以 100 递增。
enum<string>
默认值:"auto"
角色姿态:auto、A-pose 或 T-pose。
integer
默认值:1
生成的模型数量,范围为 1–4。

响应

请通过 error.code 判断错误原因。
成功请求返回 202 Accepted、批次任务 ID 和生成结果子项。批量图片请求会为每张图片创建一个子任务;例如传入 2 张图片,data 中返回 2 个子项。
string
必填
本次生成请求的批次任务 ID,可用于查询任务状态。
enum<string>
必填
批次任务状态。可选值:queued、processing、succeeded、failed。
integer<int64>
必填
批次任务创建时间的 Unix 时间戳,单位为秒。
enum<string>
必填
生成模式。可选值:text_to_3d(文生)、image_to_3d(单图生)、batch_image_to_3d(批量图生)、multi_view_to_3d(多视图生)。
string
必填
本次生成使用的公开模型标识。
object[]
必填
本次请求创建的生成结果子项。
object
可用时返回本次请求的计费信息,包含扣除的点数 credits。