Pose em T automática
Ao vivoTransforme a imagem de um personagem numa pose em T frontal limpa, a pose de que as ferramentas 3D precisam. Uma imagem que já está em pose em T custa só a verificação.
Pose em T automática
Entrada
imageUm link https público para a imagem do personagem.
knight-input-990bde6e.webp
prompt_hintOpcional: algumas palavras sobre o personagem que ajudam a mantê-lo igual.Toda execução paga a verificação ($0.01341). A edição ($0.03941) só é somada quando a imagem ainda não está em pose em T.
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 Pose em T automática 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
/Imagem ou prompt para um modelo com textura.v1/ 3d/ models - 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/tpose \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"image":"https://example.com/character.png"}' # 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_tpose_image
- Argumentos de exemplo
{ "image": "https://example.com/character.png" }
Pose em T automática: perguntas
Quanto custa Pose em T automática?
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/tpose 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_tpose_image, 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.