O que é a API de geração 3D Neural4D?

A API Neural4D permite que desenvolvedores gerem modelos 3D estanques de forma programática. Ela é impulsionada pelo mecanismo Direct3D-S2, utilizando Spatial Sparse Attention (SSA) para geração de alto desempenho com resolução de até 2048³.

Como a API lida com a geração de malhas e texturas?

O processo de geração é dividido em duas fases: uma malha base (sem texturas) é gerada em aproximadamente 90 segundos, seguida pela geração separada de mapas de textura PBR. O tempo total para um modelo texturizado completo é de pouco mais de 2 minutos.

Quais linguagens de programação e fluxos de trabalho são compatíveis?

A API pode ser integrada a qualquer plataforma usando solicitações HTTP padrão. Fornecemos guias de integração em Python e JavaScript, facilitando a conexão com agentes de IA, fluxos de automação e conjuntos de ferramentas de pipelines gráficos personalizados.

Como integrar a API Neural4D em fluxos de trabalho personalizados

O que é a API de geração 3D da Neural4D?

A API Neural4D oferece aos desenvolvedores acesso programático ao motor Direct3D-S2 (NeurIPS 2025). Este motor gera malhas watertight diretamente a partir de prompts de texto ou imagem, dispensando os fluxos de trabalho tradicionais de escultura poligonal. O algoritmo central usa um mecanismo de Spatial Sparse Attention (SSA) para alcançar alta fidelidade geométrica, produzindo malhas limpas predominantemente quadriláteras com resolução de voxel de até 2048³.

Como conectar via API REST (exemplo em Python)

A API Neural4D é uma interface REST independente de linguagem, o que significa que pode ser integrada a quaisquer aplicações de software automatizadas por meio de requisições HTTP (Node.js, C#, Python etc.). Antes de começar, certifique-se de obter sua chave de API Neural4D. A API separa a geração da malha base do cálculo do mapa de textura. A criação da malha base leva aproximadamente 90 segundos. Você pode explorar como implementar isso em uma API Python para geração de modelos 3D ou em uma integração genérica de API de texto para 3D . Veja abaixo um exemplo de integração usando 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)

Como estender o pipeline para geração de imagens e vídeos?

O mesmo token Bearer também libera endpoints de geração de mídia. Tarefas de imagem e vídeo aceitam um prompt de texto com até seis imagens de referência, enviam de um a quatro jobs por requisição e usam multipart/form-data para uploads em vez de application/json. Você consulta o resultado com o endpoint queryGenerationResult , que retorna uma URL de download assim que a tarefa atinge o status completed .

Endpoint	Finalidade	Parâmetros principais
/api/createNormalPicture	Gerar imagens a partir de um prompt de texto com imagens de referência opcionais	prompt, images (até 6), modelKey (padrão image-2), aspectRatio (1:1, 16:9, 9:16, 4:3, 3:4), jobNum (1 a 4)
/api/createNormalVideo	Gerar vídeos a partir de um prompt de texto com imagens de referência opcionais	prompt, images (até 6), aspectRatio (padrão 16:9), duration (4 a 15 s, padrão 5), resolution (480p, 720p, 1080p, padrão 720p), jobNum (1 a 4)
/api/queryGenerationResult	Consultar o resultado de uma tarefa de imagem ou vídeo por UUID	uuid; retorna data.status (completed, queued, processing, failed), data.resultType (image, video), data.resultUrl

Consulte queryGenerationResult com o UUID retornado pelo endpoint de criação até que data.status se torne completed, depois baixe o recurso em data.resultUrl. Ao contrário da geração, esta consulta não consome pontos.

Quais parâmetros de consulta otimizam os resultados de malha e textura?

Use os parâmetros de consulta abaixo para personalizar os resultados de geração de malha e textura. Para configurações avançadas e detalhes dos endpoints, consulte a referência oficial da API generateModelWithText.

Parâmetro	Tipo	Descrição e intervalo
prompt	String	A descrição do modelo 3D. Seja específico sobre as características geométricas (por exemplo, estanque, predominantemente quadrangular).
modelCount	Integer	O número de modelos planeados para geração. O valor predefinido é 4.
disablePbr	Integer	Alternância do recurso PBR. 0 = PBR ativado, 1 = PBR desativado. O valor predefinido é 0.
onlyGenerateMesh	Boolean	Gera apenas uma malha base, sem texturas PBR. O valor predefinido é false.
mesh_quality	String	Objetivo de densidade da malha: standard, high ou extra_high. O valor predefinido é high.
faceNum	Integer	Contagem de faces alvo. Para qualidade standard, de 100.000 a 500.000 (predefinição 500.000). Para high e extra_high, de 500.000 a 1.000.000 (predefinição 1.000.000).

Que fluxos de trabalho industriais e de programação beneficiam da API?

Integrar a API de geração 3D em pipelines de programação apoia várias indústrias. Pode saber mais sobre o seu impacto no nosso artigo sobre por que o seu próximo projeto precisa de uma API de imagem para 3D:

Pipelines de desenvolvimento de jogos: a geração automatizada de rascunhos de assets preenche diretamente contentores de cena durante a execução ou em sessões do editor.
Prototipagem industrial: os resultados de geração de malhas estanques podem ser enviados para software de fatiamento para testes imediatos de impressão 3D.
Aplicações WebAR: a entrega rápida de ficheiros GLB otimizados permite a pré-visualização de assets 3D em tempo real em browsers móveis.

Diagrama do fluxo de integração da API Neural4D mostrando as solicitações do código cliente Python para o mecanismo Direct3D-S2 na nuvem e o retorno de modelos 3D estanques

Precisa de mais ajuda? Se tiver dúvidas ou encontrar problemas durante a integração, pode enviar feedback online em Feedback Neural4D ou contactar a nossa equipa técnica por email em support@neural4d.com.

Como integrar a API Neural4D em fluxos de trabalho personalizados

O que é a API de geração 3D da Neural4D?

Como conectar via API REST (exemplo em Python)

Como estender o pipeline para geração de imagens e vídeos?

Quais parâmetros de consulta otimizam os resultados de malha e textura?

Que fluxos de trabalho industriais e de programação beneficiam da API?

PRODUTOS

FUNCIONALIDADES

EMPRESA

RECURSOS