O que são o ChatGPT e o Gemini e como eles funcionam com o Neural4D?

Eles podem gerar código a partir de instruções em linguagem natural. Forneça a referência atual da API de texto para 3D do Neural4D para ajudar a criar um script que gere um modelo, verifique o resultado e baixe o recurso. Revise e teste o script antes de usá-lo.

Como escrever o prompt perfeito para geração 3D?

Forneça à IA a referência atual da API de texto para 3D. Peça que ela use um token Bearer de uma variável de ambiente, envie uma solicitação de geração, armazene o UUID retornado, consulte o resultado, trate os erros e baixe o modelo de modelUrl.

Como criar apps 3D com ferramentas de IA e a API Neural4D

1. Criando automações e apps com ferramentas de IA

O que são o ChatGPT e o Gemini? Eles são ferramentas de IA que podem criar e explicar código a partir de instruções em linguagem natural. Forneça a referência atual da API Neural4D Text-to-3D para ajudar a criar um script em Python ou Node.js que gere um modelo. O guia de início rápido da API explica a autenticação e o fluxo assíncrono de resultados. Revise e teste todo código gerado antes de usá-lo.

Você pode adaptar esse fluxo para um aplicativo 3D personalizado, um bot do Discord ou um pipeline automatizado de conteúdo. Verifique se o recurso gerado atende aos requisitos do seu projeto antes de usá-lo em um produto final.

Está procurando desenvolvimento de frontend? Se preferir gerar modelos manualmente e usar o Gemini para escrever o código de exibição, como Three.js, confira nosso guia para criar sites 3D interativos ou assista ao tutorial em vídeo abaixo:

Precisa de integração direta com código? Para desenvolvedores que querem escrever manualmente os próprios scripts de backend sem ferramentas de IA, consulte nosso guia dedicado sobre como integrar a API Neural4D a fluxos de trabalho personalizados.

2. Como preparar sua chave da API Neural4D?

Antes de executar um script, você precisa de uma chave de API para autenticação Bearer. Para ver um passo a passo detalhado, confira nosso guia sobre como obter e gerenciar sua chave da API Neural4D.

Etapa 1	Faça login no Neural4D Studio.
Etapa 2	Clique no ícone API na parte inferior da barra lateral esquerda.
Etapa 3	Clique em Criar chave de API e insira um nome para a chave.
Etapa 4	Clique em Confirmar e armazene a chave com segurança.

Não compartilhe sua chave em chats com ferramentas de IA, repositórios públicos ou código do lado do cliente. O script abaixo a lerá de uma variável de ambiente local.

3. Como pedir a uma ferramenta de IA um script de geração 3D?

Forneça à ferramenta de IA a referência atual da API e o fluxo de solicitação abaixo. Copie este prompt exatamente como está escrito. Mantenha sua chave de API real no computador e nunca a cole no chat.

prompt

Write a Python script using requests to generate one 3D model with the Neural4D API.
Follow the current documentation:
https://docs.neural4d.com/en/api-reference/text-to-3d/generate-model-from-text
https://docs.neural4d.com/en/api-reference/model-management/retrieve-model

1. Read the API key from the NEURAL4D_API_KEY environment variable. If it is missing, show a clear error. Never print or hard-code the key.
2. Build the Authorization header as Bearer plus the key read from NEURAL4D_API_KEY. Send POST https://alb.neural4d.com:3000/api/generateModelWithText with Content-Type: application/json. Use JSON: {"prompt": "A futuristic sci-fi helmet", "modelCount": 1}.
3. Check the HTTP response and API errors. Save the first UUID from the response's "uuids" array.
4. Poll POST https://alb.neural4d.com:3000/api/retrieveModel with JSON {"uuid": saved_uuid} and the same headers. Use a configurable interval and a maximum wait time.
5. In the retrieval response, "codeStatus" 1 means generating and 0 means complete. Handle -1 (invalid or expired token), -2 (unknown UUID), and -3 (generation failed) as errors.
6. When complete, download the asset from "modelUrl" and preserve its file extension when available. Do not assume the result is an OBJ file.
7. Add request timeouts, helpful error messages, and comments explaining how to run the script.

Compare o script gerado com as páginas da API vinculadas antes de executá-lo. Se precisar de um arquivo OBJ, use a API de conversão de formato de modelo separada após a geração. A conversão de formato consome pontos.

4. Como testar o script gerado no terminal?

Depois que o ChatGPT ou o Gemini fornecer o script em Python, revise-o e siga estas etapas:

Salve o código fornecido em um arquivo chamado generate_3d.py no computador.
Abra o terminal (Prompt de Comando no Windows ou Terminal no macOS/Linux).
Instale a biblioteca requests com pip install requests.
Defina NEURAL4D_API_KEY localmente com sua chave de API. No PowerShell, use $env:NEURAL4D_API_KEY="your_key". No Prompt de Comando, use set NEURAL4D_API_KEY=your_key. No macOS ou Linux, use export NEURAL4D_API_KEY="your_key".
Execute python generate_3d.py. O script deve consultar o trabalho até que ele seja concluído, falhe ou atinja o tempo limite configurado.
Verifique o modelo baixado e seu formato de arquivo. A documentação atual da API mostra um resultado GLB; use a conversão de formato se o seu projeto exigir OBJ ou outro formato.

5. Quais são os erros comuns ao usar scripts gerados por IA?

Verifique a resposta HTTP e o corpo da resposta da API quando uma solicitação falhar:

401 ou codeStatus -1	Verifique se `NEURAL4D_API_KEY` está definido e se a chave é válida. Gere uma nova chave se a antiga tiver expirado ou sido revogada.
400 Bad Request	Confira os nomes e valores dos campos JSON na referência atual de texto para 3D.
402 ou 403	Verifique o saldo da sua conta, as permissões e quaisquer restrições da conta.
429 Too Many Requests	Aguarde antes de tentar novamente e reduza a frequência com que o script envia solicitações.
Resposta de moderação	Uma solicitação de geração pode retornar uma mensagem de moderação em vez de um array `uuids`. Leia a mensagem e revise o prompt.
codeStatus -2 ou -3	Confirme se o UUID veio da resposta de criação. O valor -2 significa que ele não foi encontrado; -3 significa que a geração falhou.
ModuleNotFoundError	Instale a biblioteca Python requests com `pip install requests`.
Tempo limite do script	A tarefa ainda pode estar em execução. Verifique o endpoint de progresso do trabalho ou tente novamente com um tempo máximo de espera maior. Não presuma um tempo fixo para a conclusão.

Como criar apps 3D com ferramentas de IA e a API Neural4D

1. Criando automações e apps com ferramentas de IA

2. Como preparar sua chave da API Neural4D?

3. Como pedir a uma ferramenta de IA um script de geração 3D?

4. Como testar o script gerado no terminal?

5. Quais são os erros comuns ao usar scripts gerados por IA?

PRODUTOS

FUNCIONALIDADES

EMPRESA

RECURSOS