Item 3D do Roblox
Ao vivoDescreva ou envie uma imagem. Receba um item 3D no tamanho do Roblox (FBX + GLB) para importar no Roblox Studio. Pago por modelo com o seu saldo.
Item 3D do Roblox
Entrada
Chapéus, pets, armas e objetos, dentro do limite de 4.000 triângulos do Roblox para acessórios.
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 Item 3D 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":"item","prompt":"a wooden treasure chest with gold trim"}' # 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.
Item 3D do Roblox: perguntas
Quanto custa Item 3D 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.