Imagem para modelo 3D
Ao vivoEntra uma imagem ou um prompt, sai um modelo 3D com textura: GLB, FBX e uma miniatura. Crie um personagem pronto para rig ou um objeto.
Imagem para modelo 3D
Entrada
promptO que criar, em palavras.kindcharacter ou prop.Um objeto como uma arma, um chapéu ou um móvel. Sem rig.qualityPadrão ou alto detalhe.engineQual motor 3D faz o trabalho (enviado só quando há mais de um).3D padrão × Objeto3D padrão × Objeto
Como funciona o pipeline 3D
As mesmas etapas que usamos para criar personagens para os nossos próprios jogos.
- 01Verificação da pose em TUma olhada rápida na sua imagem. Se não for uma pose em T frontal estrita, com a boca fechada e neutra num fundo liso, ela é redesenhada assim, com o mesmo personagem. Braços abertos deixam as mãos limpas.
- 02Modelo 3DUma malha com textura, pronta para jogos, feita a partir da imagem em pose em T, com materiais PBR e sem a iluminação embutida. Personagens e objetos têm seu próprio limite de triângulos.
- 03RigUm esqueleto ajustado ao personagem para que ele possa se mover, com clipes de andar e correr se você pedir. Você recebe FBX para motores de jogo e GLB para a web.
Rode as três etapas numa só chamada:Personagens 3D
Chame Imagem para modelo 3D pelo seu código
Cada ferramenta 3D é um endpoint próprio. Cada chamada retorna uma tarefa: consulte até terminar. Uma execução que falha não é cobrada.
https:/- POST
/Imagem ou prompt para um personagem com rig.v1/ 3d/ characters - POST
/Qualquer imagem de personagem para uma pose em T frontal.v1/ 3d/ tpose - POST
/Modelo humanoide para FBX e GLB com rig.v1/ 3d/ rig - GET
/Progresso e arquivos de saída.v1/ tasks/ {id} - GET
/Motores 3D e níveis de qualidade, com preçosv1/ models? category= 3d
Pegue uma chave de API
Crie uma chave no console. Ela usa o mesmo saldo do playground.
Criar uma chaveEnvie sua primeira requisição
A mesma requisição que o playground envia. Defina OPENNAN_KEY com sua chave.
curl https://api.opennan.com/v1/3d/models \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"a wooden treasure chest with gold trim","kind":"prop","quality":"standard","engine":"opennan-3d-studio"}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"Consulte a tarefa
A chamada responde na hora com um id de tarefa. Consulte a tarefa até ela terminar:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- Esperando um worker
- running
- Em produção
- succeeded
- Pronto: outputs[].url traz os arquivos
- failed
- Falhou: nada é cobrado
Erros e como resolver
401Chave ausente ou errada
Envie o cabeçalho Authorization: Bearer com uma chave do console.
402Saldo insuficiente
Adicione crédito em Faturamento e envie a mesma chamada de novo.
400Um valor não é aceito
Leia error.message: ele indica o campo. Use um valor da tabela de parâmetros.
429Requisições demais
Aguarde alguns segundos e tente de novo, esperando mais após cada 429.
Adicione a Opennan ao seu app de IA
Uma instalação dá à sua IA todas as ferramentas da Opennan: vídeo, imagens, chat, voz, música, efeitos sonoros, 3D, legendas e dublagem. Escolha seu app e siga os passos.
https:/Funciona no Codex CLI, no app do Codex e na extensão do Codex para IDE: todos usam ~/.codex/config.toml. Se o app ou a IDE não enxergar OPENNAN_KEY, use a opção config.toml com sua chave. O Codex pede aprovação antes de cada ferramenta: aprove para seguir.
Pegue uma chave de API
Crie uma chave no console. Ela começa com sk- e usa o mesmo saldo do site.
Criar uma chaveSalve sua chave como OPENNAN_KEY
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Instale o plugin da Opennan: o servidor e uma skill que ensina sua IA a escolher modelos, confirmar preços e esperar os resultados
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanOu adicione só o servidor
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYOu adicione isto a ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Confira se opennan aparece na lista
codex mcp listReinicie o Codex e peça o que quiser
“Faça um vídeo de 5 segundos de chuva numa rua de neon, uma música para acompanhar e uma imagem de pôster.”
Troque sk-... pela sua chave e mantenha-a em segredo: quem tiver a chave pode gastar seu saldo. Seu app lista as ferramentas sem chave; para criar algo, você precisa de uma.
Use a partir de um agente de IA
Adicione o servidor MCP da Opennan ao seu agente e chame esta ferramenta.
- Ferramenta
- generate_3d_model
- Argumentos de exemplo
{ "prompt": "a wooden treasure chest with gold trim", "kind": "prop", "quality": "standard", "engine": "opennan-3d-studio" }
Imagem para modelo 3D: perguntas
Quanto custa Imagem para modelo 3D?
Você paga por execução, pelo preço mostrado antes de começar.
Como chamo pelo meu código?
Envie POST https://api.opennan.com/v1/3d/models com sua chave de API. A resposta é um id de tarefa: consulte https://api.opennan.com/v1/tasks/{id} até a tarefa concluir ou falhar.
Meu agente de IA pode usar?
Sim. Adicione o servidor MCP https://api.opennan.com/v1/mcp e chame a ferramenta generate_3d_model, ou aponte seu agente para https://api.opennan.com/llms.txt.
O que acontece se uma execução falhar?
Uma execução com falha não é cobrada. Você paga só pelos resultados.
Por que a imagem precisa estar em pose em T?
Braços esticados afastam as mãos do corpo, então o modelo ganha mãos limpas e o rig dobra nas articulações certas. Com os braços para baixo ou em pose em A, as mãos costumam se fundir com a roupa, e um sorriso fica pintado na textura. Por isso uma imagem que não está em pose em T é redesenhada primeiro, com o mesmo personagem.
Quais arquivos eu recebo?
GLB para a web, motores de jogo e apps 3D, FBX para Roblox Studio, Unity, Unreal e Blender, e uma miniatura. Execuções com rig incluem clipes de andar e correr.