Neural4D 3D 生成 API 是什么？

Neural4D API 允许开发者以编程方式生成水密 3D 模型。它由 Direct3D-S2 引擎驱动，利用空间稀疏注意力（SSA）实现高性能生成，分辨率最高可达 2048³。

API 如何处理网格和纹理生成？

生成流程分为两个阶段：首先在约 90 秒内生成基础网格（不含纹理），随后单独生成 PBR 纹理贴图。完成一个带纹理模型的总耗时略高于 2 分钟。

支持哪些编程语言和工作流？

该 API 可通过标准 HTTP 请求集成到任何平台。我们提供 Python 和 JavaScript 集成指南，便于连接 AI 智能体、自动化工作流和自定义图形管线工具链。

如何将 Neural4D API 集成到自定义工作流中

什么是 Neural4D 3D 生成 API？

该 Neural4D API 为开发者提供对 Direct3D-S2 引擎（NeurIPS 2025）的程序化访问。该引擎可直接根据文本或图像提示词生成封闭网格，绕过传统的多边形雕刻工作流。其核心算法采用空间稀疏注意力（SSA）机制，以实现高几何保真度，并在最高 2048³ 体素分辨率下生成干净、以四边面为主的网格。

如何通过 REST API 连接（Python 示例）

Neural4D API 是一个与语言无关的 REST 接口，这意味着它可以通过 HTTP 请求集成到任何自动化软件应用中（Node.js、C#、Python 等）。开始之前，请确保你获取你的 Neural4D API 密钥。该 API 将基础网格生成与纹理贴图计算分开处理。基础网格创建大约需要 90 秒。你可以在 Python 3D 模型生成 API 或通用的 Text to 3D API 集成中查看如何实现。下面是一个使用 Python 的集成示例：

python

import requests
import time

API_KEY = "your_api_key_here"
GENERATE_URL = "https://alb.neural4d.com:3000/api/generateModelWithText"
RETRIEVE_URL = "https://alb.neural4d.com:3000/api/retrieveModel"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json;charset=utf-8"
}

# Generate a watertight mesh with clean topology
payload = {
    "prompt": "mechanical gear, industrial grade, quad-dominant",
    "modelCount": 1,
    "disablePbr": 0
}

response = requests.post(GENERATE_URL, json=payload, headers=headers)
data = response.json()
uuids = data.get("uuids", [])

if not uuids:
    print("Failed to start generation.")
else:
    target_uuid = uuids[0]
    print(f"Task created with UUID: {target_uuid}. Processing mesh generation...")
    
    # Polling for task status (Base mesh: ~90s, Textures: ~30s additional)
    while True:
        status_resp = requests.post(RETRIEVE_URL, json={"uuid": target_uuid}, headers=headers)
        result = status_resp.json()
        code_status = result.get("codeStatus")
        
        if code_status == 0:
            print(f"Generation successful. Download GLB at: {result.get('modelUrl')}")
            break
        elif code_status in [-1, -2, -3]:
            print(f"Generation failed. Status Code: {code_status}")
            break
            
        time.sleep(10)

如何将流程扩展到图像和视频生成？

同一个 Bearer 令牌也可用于解锁媒体生成端点。图片和视频任务接受最多六张参考图像的文本提示词，每个请求可提交一到四个任务，并且上传时使用 multipart/form-data，而不是 application/json。你可以通过 queryGenerationResult 端点轮询结果，该端点会在任务达到 completed 状态后返回下载 URL。

端点	用途	关键参数
/api/createNormalPicture	根据文本提示词生成图片，可选参考图像	prompt, images（最多 6 张）, modelKey（默认 image-2）, aspectRatio（1:1、16:9、9:16、4:3、3:4）, jobNum（1 到 4）
/api/createNormalVideo	根据文本提示词生成视频，可选参考图像	prompt, images（最多 6 张）, aspectRatio（默认 16:9）, duration（4 到 15 秒，默认 5）, resolution（480p、720p、1080p，默认 720p）, jobNum（1 到 4）
/api/queryGenerationResult	通过 UUID 轮询图片或视频任务结果	uuid；返回 data.status（completed、queued、processing、failed）、data.resultType（image、video）、data.resultUrl

使用 queryGenerationResult 通过 create 端点返回的 UUID 轮询 data.status 变为 completed，然后从 data.resultUrl下载资源。与生成不同，这个查询不会消耗点数。

哪些查询参数可以优化网格和纹理输出？

使用下面的查询参数来自定义网格和纹理生成输出。有关高级配置和端点详情，请参阅官方 generateModelWithText API 参考文档.

参数	类型	说明与取值范围
prompt	String	3D 模型描述。请具体说明几何特征（例如：水密、以四边面为主）。
modelCount	Integer	计划生成的模型数量。默认值为 4。
disablePbr	Integer	PBR 功能开关。0 = 启用 PBR，1 = 禁用 PBR。默认值为 0。
onlyGenerateMesh	Boolean	仅生成基础网格，不包含 PBR 贴图。默认值为 false。
mesh_quality	String	网格密度目标：standard、high 或 extra_high。默认值为 high。
faceNum	Integer	目标面数。standard 质量为 100,000 至 500,000（默认 500,000）。high 和 extra_high 为 500,000 至 1,000,000（默认 1,000,000）。

哪些工业和开发者工作流适合使用该 API？

将 3D 生成 API 集成到开发者流水线，可支持多个行业场景。你可以在我们关于为什么下一个项目需要 Image to 3D API的文章中了解更多影响：

游戏开发流水线：自动生成资产草稿，并在运行时或编辑器会话中直接填充到场景容器。
工业原型制作：生成的水密网格可发送到切片软件，用于即时 3D 打印测试。
WebAR 应用：快速交付优化后的 GLB 文件，支持在移动浏览器中实时预览 3D 资产。

Neural4D API 集成工作流图，展示请求从 Python 客户端代码流向云端 Direct3D-S2 引擎，并返回水密 3D 模型

需要更多帮助？如果你在集成过程中有任何问题或遇到故障，可以在 Neural4D Feedback 在线提交反馈，或通过电子邮件联系我们的技术团队： support@neural4d.com。