Corpo de avatar do Roblox
Ao vivoDescreva um personagem ou envie uma imagem. Receba um corpo de avatar completo em pose em T (FBX + GLB), pronto para o Avatar Setup do Roblox Studio. Pago por modelo com o seu saldo.
Corpo de avatar do Roblox
Entrada
Um corpo inteiro em pose T, dentro do limite de 10.742 triângulos do Roblox para corpos. Você finaliza no Avatar Setup do Roblox Studio (um passo a passo rápido) para adicionar o rig R15.
promptO que criar, em palavras.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 Corpo de avatar do Roblox 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:/- 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/roblox/models \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"kind":"body","prompt":"a cyberpunk ninja girl with a neon jacket"}' # 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.
Corpo de avatar do Roblox: perguntas
Quanto custa Corpo de avatar do Roblox?
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/roblox/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. Aponte seu agente para https://api.opennan.com/llms.txt: ele explica este endpoint e todos os outros.
O que acontece se uma execução falhar?
Uma execução com falha não é cobrada. Você paga só pelos resultados.
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.