Imagem para 3DSobre o Seed3D 2.0
Modelos 3D com texturas ricas a partir de uma imagem, ótimo para personagens.
Chame com o nome de modelo bytedance/seed3d-2.0/image-to-3d em POST /jobs/createTask, a partir de US$ 0,48.
Introdução
Seed3D 2.0 é o modelo de ativos 3D da equipe Seed da ByteDance, lançado em abril de 2026. Ele lê uma única imagem e constrói o objeto nela como uma malha 3D completa, com materiais, de modo que uma foto de produto ou um render de personagem vira algo que você pode girar, iluminar e posicionar em uma cena. A requisição recebe uma imagem (image_url) e uma chave opcional de densidade (mesh_detail); não há campos de prompt, seed nem estilo. O resultado é um arquivo glTF binário (.glb) com as texturas empacotadas dentro.
Principais recursos
Geometria e materiais a partir de uma imagem
O Seed3D 2.0 gera a forma e um material com base física ao mesmo tempo. Em nossos testes, cada modelo voltou com duas texturas de 4096×4096, um mapa de cor base e um mapa de metal-rugosidade, então o couro parecia gasto e fosco, enquanto os ilhoses de latão e a viseira de um capacete recebiam reflexos. Não há mapa de normais separado; o detalhe da superfície está na própria malha.
Uma malha densa e fechada
No nível medium padrão, os dois modelos de teste voltaram com uma malha e um material, pouco abaixo de 500 mil triângulos; no low, a mesma bota tinha 99 977 faces. Segundo os criadores, os níveis correspondem a cerca de 100 mil, 500 mil e 1 milhão de faces. Uma malha mais densa preserva melhor pequenos detalhes como cadarços, costuras e dedos; uma mais leve carrega mais rápido no navegador.
O que medimos
Enviamos uma foto de estúdio de 1024×1024 de uma bota de couro e um render de 682×1024 de um astronauta de brinquedo. Os dois retornaram arquivos GLB válidos: 37,2 MB e 28,6 MB, 499 998 e 499 992 triângulos, processados em 356 e 340 segundos. O astronauta manteve rosto, viseira, painel do peito e acabamentos laranja por todos os lados. A bota, enviada de frente, voltou com a metade de trás espelhada a partir da frente.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | A imagem de partida. |
mesh_detail | Não | Densidade da malha: low (cerca de 100 mil faces), medium (cerca de 500 mil) ou high (cerca de 1 milhão). As três custam o mesmo; níveis maiores mantêm mais detalhes e geram arquivos maiores. low · medium · high · Padrão: medium |
Preços
Os preços são em USD. A API usa um saldo separado em dólares americanos. Os créditos do site não podem ser usados na API nem convertidos em saldo de API, e o saldo de API não pode ser convertido em créditos do site. Ao aceitar uma tarefa, reservamos o valor máximo do orçamento no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.
| Opção | USD por geração |
|---|---|
| Padrão | US$ 0,48 |
Antes de executar, envie o mesmo corpo de requisição para POST /jobs/quote para ver o custo estimado e o máximo em USD. O orçamento não executa tarefas nem debita seu saldo.
Casos de uso
E-commerce e visualizadores de produto
Uma foto de packshot vira um modelo interativo para a página do produto ou uma prévia em AR. Fotografe ou renderize o produto em três quartos, sobre fundo liso, mantenha o objeto inteiro no quadro e use o nível medium para equilibrar detalhe e tamanho do download.
Personagens, brinquedos e colecionáveis
Renders de personagens e fotos de miniaturas convertem bem porque suas formas são simples e as cores são fortes. A textura carrega detalhes pintados, como rostos, distintivos e listras; a parte de trás é inferida, então escolha uma pose em que a maior parte do personagem fique visível.
Guia de prompts e dicas avançadas
Prepare a imagem
Um único sujeito, centralizado, com alguma margem e nada encostando na borda do quadro. Um fundo claro e liso separa bem o objeto. Aceitamos JPEG, PNG ou WebP de até 10 MB, e a imagem deve ficar entre cerca de 2:5 e 5:2 de proporção.
Escolha o ângulo com intenção
O modelo só vê um lado. Uma vista frontal reta de um sapato ou carro deixa o comprimento do objeto desconhecido, e a metade oculta pode ser preenchida como espelho da frente. Uma vista em três quartos que mostre a frente e um lado dá um resultado muito mais confiável.
Escolha o nível de detalhe conforme o uso
Use low para prévias no celular e cenas com muitos objetos, medium para a maioria dos visualizadores web e high quando o modelo for examinado de perto ou impresso em 3D.
Confira o resultado antes de publicar
Abra o GLB em um visualizador, gire-o por completo e observe o lado que você não mostrou. Se a parte de trás parecer errada, teste outra foto com outro ângulo em vez de outro nível de detalhe.
Início rápido da API
Chame a API do Seed3D 2.0 em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow-. As chamadas usam seu saldo separado em dólares americanos.
- Envie a requisição. Faça POST /jobs/createTask com model bytedance/seed3d-2.0/image-to-3d e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seed3d-2.0/image-to-3d",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"mesh_detail": "medium"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do Seed3D 2.0
Quanto custa a API do Seed3D 2.0?
O Seed3D 2.0 custa US$ 0,48 por geração. A API usa um saldo separado em dólares americanos. Os créditos do site não podem ser usados na API nem convertidos em saldo de API, e o saldo de API não pode ser convertido em créditos do site. Ao aceitar uma tarefa, reservamos o valor máximo da cotação no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.
Qual é o nome de modelo do Seed3D 2.0 na API?
Coloque bytedance/seed3d-2.0/image-to-3d para Imagem para 3D no campo model de POST /jobs/createTask.
O que eu recebo?
Um arquivo .glb (glTF 2.0 binário) com as texturas embutidas: um mapa de cor base e um de metal-rugosidade, os dois em PNG 4096×4096 nos nossos testes. Blender, three.js, model-viewer, Unity e Unreal importam direto.
Precisa de prompt?
Não. A única entrada obrigatória é a imagem. mesh_detail é opcional e só muda a densidade da malha.
Qual imagem funciona melhor?
Um único tema, inteiro no quadro, em fundo liso, visto em três quartos. Cenas cheias, objetos cortados e vistas de frente fazem o modelo adivinhar o que não vê.
Quais são os limites da API do Seed3D 2.0?
Maior upload: 10 MB. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o Seed3D 2.0 sem escrever código?
Execute Seed3D 2.0 no Playground com seu saldo de API em USD, sem chave de API. Cada execução aparece no histórico de desenvolvedor com o código correspondente.