01
hunyuan-3d/v3.1/pro/image-to-3d
Converte uma imagem frontal em asset 3D com PBR, geometria, contagem de faces e vistas extras.
hunyuan-3d/v3.1/pro/text-to-3d
Text to 3D
Image to 3D
Modelo:
A API Hunyuan 3D v3.1 suporta modelos Pro e Rapid text-to-3D e image-to-3D para jogos, visualizacao de produto, prototipagem e pipelines 3D.
Examples
Detalhes de preços
Preços transparentes, sem taxas ocultas. Pague conforme o uso.
hunyuan-3d/v3.1/pro/text-to-3dBase generation
Preço PoYo
$0.300/gen
60 créditos
Preço oficial
$0.375/gen
Official
Economia
20%
hunyuan-3d/v3.1/pro/image-to-3dBase generation
Preço PoYo
$0.300/gen
60 créditos
Preço oficial
$0.375/gen
Official
Economia
20%
hunyuan-3d/v3.1/rapid/text-to-3dBase generation
Preço PoYo
$0.180/gen
36 créditos
Preço oficial
$0.225/gen
Official
Economia
20%
hunyuan-3d/v3.1/rapid/image-to-3dBase generation
Preço PoYo
$0.180/gen
36 créditos
Preço oficial
$0.225/gen
Official
Economia
20%
hunyuan-3d/v3.1/pro/image-to-3dPBR add-on
Preço PoYo
$0.120
24 créditos
Preço oficial
$0.150
Official
Economia
20%
hunyuan-3d/v3.1/pro/image-to-3dMulti-view add-on
Preço PoYo
$0.120
24 créditos
Preço oficial
$0.150
Official
Economia
20%
hunyuan-3d/v3.1/pro/text-to-3dCustom face count add-on
Preço PoYo
$0.120
24 créditos
Preço oficial
$0.150
Official
Economia
20%
| Modelo | Especificação | Preço PoYo | Preço oficial | Economia |
|---|---|---|---|---|
| hunyuan-3d/v3.1/pro/text-to-3d | Base generation | $0.300/gen 60 créditos /gen | $0.375/gen Official | 20% |
Custom face count add-on | $0.120 24 créditos additional | $0.150 Official | 20% | |
| hunyuan-3d/v3.1/pro/image-to-3d | Base generation | $0.300/gen 60 créditos /gen | $0.375/gen Official | 20% |
PBR add-on | $0.120 24 créditos additional | $0.150 Official | 20% | |
Multi-view add-on | $0.120 24 créditos additional | $0.150 Official | 20% | |
| hunyuan-3d/v3.1/rapid/text-to-3d | Base generation | $0.180/gen 36 créditos /gen | $0.225/gen Official | 20% |
| hunyuan-3d/v3.1/rapid/image-to-3d | Base generation | $0.180/gen 36 créditos /gen | $0.225/gen Official | 20% |
* As taxas reais são baseadas na saída final.
Introdução
Guia completo para usar o Hunyuan 3D v3.1 API
Hunyuan 3D v3.1 API
PoYo.ai expoe quatro modelos Hunyuan 3D v3.1 com envio de tarefas, consulta de status, callback e arquivos 3D para download.
Modelos disponiveis
Obter chave API
02
hunyuan-3d/v3.1/pro/text-to-3d
Gera 3D a partir de prompts mais detalhados com opcoes Pro.
03
hunyuan-3d/v3.1/rapid/text-to-3d
Cria rascunhos 3D rapidos a partir de prompts curtos.
04
hunyuan-3d/v3.1/rapid/image-to-3d
Transforma uma imagem de objeto em modelo 3D rapidamente.
Principais recursos da API Hunyuan 3D v3.1
Escolha Pro ou Rapid para geracao text-to-3D e image-to-3D com os controles disponiveis no PoYo.
01
Pro image-to-3D com referencia de vistas
Envie uma imagem frontal do objeto e adicione vistas laterais, traseira, superior, inferior ou anguladas quando houver mais referencia. O modelo Pro image-to-3D tambem pode usar PBR, modo de geometria e contagem de faces personalizada.
- Imagem frontal enviada via PoYo image_urls
- Campos opcionais de multiplas vistas no Pro image-to-3D
- Controles de PBR e contagem de faces quando necessario
02
Pro text-to-3D para prompts detalhados
Use Pro text-to-3D quando a forma, o material e o conceito do asset vierem principalmente de uma descricao escrita. O PoYo mantem o mesmo fluxo assincrono para status e callback.
- Prompts mais longos
- PBR, geometria e contagem de faces opcionais
- Consulta de status e arquivos unificada
03
Rapid text-to-3D para rascunhos rapidos
Rapid text-to-3D e indicado para ideias iniciais, exploracao de objetos e rascunhos de menor custo. Prompts curtos ajudam a comparar direcoes rapidamente.
- Custo base menor que Pro
- PBR disponivel quando geometria nao esta ativa
- Bom para iteracao de assets
04
Rapid image-to-3D com uma referencia
Use Rapid image-to-3D quando ja houver uma referencia de produto, prop, esboco ou objeto e voce precisar de um resultado 3D rapido.
- Uma imagem como entrada
- Opcoes PBR ou geometria quando suportadas
- Miniaturas e arquivos de modelo no resultado
Casos de uso
01
Ideacao de props para jogos
Gere conceitos iniciais a partir de prompts ou referencias antes da modelagem manual.
02
Visualizacao de produtos e objetos
Converta referencias frontais ou multiplas vistas em saidas 3D para revisao e download.
03
Exploracao de assets 3D
Compare Pro e Rapid com o mesmo formato de API, status e recuperacao de arquivos.
04
Pipeline 3D assincrono
Envie tarefas Hunyuan 3D com callback ou polling e encaminhe arquivos finalizados para ferramentas de producao.
Hunyuan 3D v3.1 Pro vs Rapid
Comparacao dos quatro modelos Hunyuan 3D v3.1 disponiveis no PoYo.
| Recurso | Pro | Rapid |
|---|---|---|
| Modelos de entrada | Text-to-3D e image-to-3D | Text-to-3D e image-to-3D |
| Melhor uso | Tarefas com mais controle: PBR, geometria, faces ou multiplas vistas | Rascunhos de menor custo a partir de prompt ou uma imagem |
| Tamanho do prompt | Ate 1024 caracteres | Ate 200 caracteres |
| Controles de imagem | Imagem frontal mais URLs opcionais de vistas no Pro image | Uma imagem frontal |
| Padrao de preco | Geracao base mais opcionais | Geracao base mais PBR opcional |
As saidas exatas dependem do modelo selecionado e dos arquivos retornados.
Como usar a API Hunyuan 3D v3.1 no PoYo
Etapa 1: crie uma chave API
Cadastre-se no PoYo e crie uma chave API no painel.
Criar chave API ->
Etapa 2: escolha um modelo Hunyuan 3D v3.1
Selecione Pro image, Pro text, Rapid text ou Rapid image.
Etapa 3: envie entradas PoYo
Use prompt para modelos de texto ou image_urls para modelos de imagem. Adicione PBR, geometria, faces ou multiplas vistas apenas quando o modelo suportar.
Etapa 4: recupere os assets
Consulte o status ou informe callback URL e baixe GLB, OBJ, MTL, texturas, miniaturas ou URLs de modelo quando disponiveis.
Ver documentacao ->
Precos da API Hunyuan 3D v3.1
Hunyuan 3D v3.1 no PoYo e cobrado por geracao, com custos adicionais para recursos opcionais.
Modelos Pro e Rapid usam precos base diferentes. PBR, multiplas vistas e contagem de faces personalizada adicionam custo quando suportados e ativados.
Adicione creditos e teste Hunyuan 3D v3.1 no PoYo. Adicionar creditos ->
FAQ
Qual modelo Hunyuan 3D v3.1 devo escolher?
Use Pro para PBR, geometria, contagem de faces ou multiplas vistas. Use Rapid para rascunhos rapidos de menor custo.
Como funcionam as entradas de imagem no PoYo?
Modelos de imagem usam image_urls com exatamente uma URL de imagem frontal. O formato e consistente nos modelos Hunyuan 3D de imagem.
Posso usar imagens de multiplas vistas?
Sim, apenas com hunyuan-3d/v3.1/pro/image-to-3d. Campos opcionais incluem traseira, esquerda, direita, topo, baixo, esquerda-frente e direita-frente.
Quais arquivos a API pode retornar?
Dependendo do modelo, os resultados podem incluir GLB, OBJ, MTL, texturas, miniaturas e colecoes de URLs de modelo.
Por que usar PoYo.ai
01
Uma API 3D assincrona
Os quatro modelos Hunyuan 3D v3.1 usam o mesmo padrao de envio, status, callback e arquivos.
02
Preco transparente em creditos
Veja a estimativa de geracao base e adicionais antes de enviar.
03
Controles especificos por modelo
O playground mostra apenas os controles suportados pelo modelo Pro ou Rapid selecionado.
04
Arquivos de saida normalizados
O PoYo organiza modelos, texturas e miniaturas em um resultado de tarefa consistente.