01
hunyuan-3d/v3.1/pro/image-to-3d
Converte uma imagem frontal de um objeto num asset 3D, com controlos Pro de PBR, modo de geometria, número de faces personalizado e imagens de vistas adicionais opcionais.
hunyuan-3d/v3.1/pro/text-to-3d
Modelo:
A API Hunyuan 3D v3.1 suporta geração Pro e Rapid de texto para 3D e de imagem para 3D para jogos, visualização de produtos, prototipagem e pipelines de assets 3D.
Examples
Detalhes dos preços
Paga conforme utilizas. Sem subscrição, sem custos escondidos.
| Nível | Texto para 3D | Imagem para 3D |
|---|---|---|
| Pro | $0.300/geração 60 créditos/geração $0.375/geraçãoPoupa 20% | $0.300/geração 60 créditos/geração $0.375/geraçãoPoupa 20% |
| Rapid | $0.180/geração 36 créditos/geração $0.225/geraçãoPoupa 20% | $0.180/geração 36 créditos/geração $0.225/geraçãoPoupa 20% |
Custo de exemplo (Rapid · Texto para 3D · Geração base): 10 gerações: $1.80
Extras
| Nível | Preço PoYo | Original / desconto |
|---|---|---|
| Pro · Imagem para 3D · Materiais PBR | +$0.120 24 créditos | +$0.150Poupa 20% Oficial |
| Pro · Imagem para 3D · Entrada multivista | +$0.120 24 créditos | +$0.150Poupa 20% Oficial |
| Pro · Texto para 3D · Número de faces personalizado | +$0.120 24 créditos | +$0.150Poupa 20% Oficial |
Como é faturado: Preço fixo por geração. Os extras são faturados além do preço base.
Os custos baseiam-se no resultado final.
Introdução
Guia completo para utilizar API Hunyuan 3D v3.1
API Hunyuan 3D v3.1
O Hunyuan 3D v3.1 no PoYo.ai disponibiliza quatro modelos com submissão unificada de tarefas, consulta de estado, suporte de callbacks e resultados 3D transferíveis quando a geração termina.
Modelos disponíveis
Obter chave de API
02
hunyuan-3d/v3.1/pro/text-to-3d
Parte de um prompt de texto mais longo e utiliza opções Pro, como PBR, modo de geometria e número de faces personalizado, para uma geração de assets mais controlada.
03
hunyuan-3d/v3.1/rapid/text-to-3d
Gera rascunhos 3D rápidos a partir de prompts mais curtos, com os preços do Rapid e controlos opcionais de PBR ou de saída centrada na geometria.
04
hunyuan-3d/v3.1/rapid/image-to-3d
Transforma uma única imagem de um objeto num modelo 3D com o modelo de imagem Rapid, de custo mais baixo, e definições opcionais de PBR ou de geometria.
Principais funcionalidades da API Hunyuan 3D v3.1
Escolhe os modelos Hunyuan 3D v3.1 Pro ou Rapid para gerar 3D a partir de texto e de imagem, com os controlos disponibilizados pelo PoYo e acesso através de uma API assíncrona.
01
Imagem para 3D Pro com orientação por vistas
Carrega uma imagem frontal de um objeto e acrescenta, se tiveres mais cobertura de referência, vistas laterais, traseira, superior, inferior ou em ângulo. O modelo de imagem Pro também pode utilizar PBR, modo de geometria e número de faces personalizado.
- Imagem frontal enviada como image_urls do PoYo
- Campos de imagens multivista opcionais nas tarefas de imagem Pro
- Controlos de PBR e de número de faces personalizado quando necessário
02
Texto para 3D Pro para prompts detalhados
Utiliza o texto para 3D Pro quando uma descrição escrita do objeto deve determinar a forma, a direção dos materiais e o conceito geral do asset. O PoYo mantém o fluxo da API assíncrono, pelo que a consulta de estado e os callbacks funcionam como nos outros modelos 3D.
- Prompt até ao limite do modelo Pro
- PBR, modo de geometria e número de faces opcionais
- Estado e obtenção de ficheiros unificados
03
Texto para 3D Rapid para rascunhos mais rápidos
O texto para 3D Rapid é útil para as primeiras ideias, para explorar objetos e para rascunhos de assets a menor custo. Utiliza-o quando prompts curtos chegam e a equipa precisa de comparar depressa antes de escolher a direção final.
- Custo base em créditos inferior ao do Pro
- PBR opcional quando o modo de geometria não está selecionado
- Indicado para exploração e iteração de assets
04
Imagem para 3D Rapid a partir de uma única referência
Utiliza o modelo de imagem Rapid quando já tens uma referência de produto, adereço, esboço ou objeto e queres um resultado 3D rápido. O PoYo aceita uma entrada image_urls simples e devolve resultados de tarefas normalizados.
- Uma só imagem de origem para o modelo Rapid
- Opções de PBR ou de geometria, quando suportadas
- Miniaturas e ficheiros de modelo devolvidos e normalizados pelo PoYo
Casos de utilização
01
Ideação de adereços para jogos
Gera os primeiros conceitos de adereços a partir de prompts ou de referências de objetos antes de dedicares tempo à modelação manual.
02
Visualização de produtos e objetos
Transforma referências de vista frontal ou multivista em resultados 3D para revisão, prototipagem e pipelines de assets a jusante.
03
Exploração de assets 3D em batch
Compara resultados Pro e Rapid num único formato de API, mantendo consistentes os preços, o estado das tarefas e a obtenção de ficheiros.
04
Pipelines 3D assíncronos
Submete tarefas Hunyuan 3D com callbacks ou consulta de estado e encaminha os ficheiros de modelo concluídos para as tuas ferramentas de produção.
Hunyuan 3D v3.1 Pro vs Rapid
Comparação geral dos quatro modelos Hunyuan 3D v3.1 disponibilizados no PoYo.
| Funcionalidade | Pro | Rapid |
|---|---|---|
| Modelos de entrada | Texto para 3D e imagem para 3D | Texto para 3D e imagem para 3D |
| Ideal para | Tarefas com mais controlo, que precisam de PBR, modo de geometria, número de faces ou orientação multivista | Rascunhos de menor custo e iteração mais rápida a partir de prompts ou de uma imagem |
| Comprimento do prompt | Até 1024 carateres | Até 200 carateres |
| Controlos de imagem | Imagem frontal mais URLs de vistas adicionais opcionais nas tarefas de imagem Pro | Entrada de uma única imagem frontal |
| Modelo de preços | 60 créditos de base, com extras opcionais | 36 créditos de base, com extra opcional de PBR |
Os resultados disponíveis dependem do modelo selecionado e dos ficheiros devolvidos.
Como utilizar a API Hunyuan 3D v3.1 no PoYo
Passo 1: cria uma chave de API
Cria conta no PoYo e gera uma chave de API no teu dashboard.
Criar chave de API ->
Passo 2: escolhe um modelo Hunyuan 3D v3.1
Seleciona um dos quatro IDs públicos de modelo: imagem Pro, texto Pro, texto Rapid ou imagem Rapid.
Passo 3: envia as entradas do PoYo
Utiliza prompt nos modelos de texto ou image_urls nos modelos de imagem. Acrescenta campos de PBR, geometria, número de faces ou multivista apenas quando o modelo selecionado os suportar.
Passo 4: obtém os assets gerados
Consulta o endpoint de estado da tarefa ou indica um URL de callback e transfere depois os ficheiros GLB, OBJ, MTL, de textura, miniatura ou URL do modelo devolvidos, quando disponíveis.
Ver documentação ->
Preços da API Hunyuan 3D v3.1
O Hunyuan 3D v3.1 no PoYo tem preço por geração, com extras opcionais.
Os modelos Pro começam em 60 créditos ($0.30) por geração. Os modelos Rapid começam em 36 créditos ($0.18) por geração.
Cada extra suportado custa 24 créditos ($0.12). Os extras incluem PBR, quando aplicável, entradas multivista nas tarefas de imagem Pro e número de faces personalizado nas tarefas Pro.
Adiciona créditos e começa a testar o Hunyuan 3D v3.1 no PoYo. Recarregar créditos ->
Perguntas frequentes
Que modelo Hunyuan 3D v3.1 devo escolher?
Utiliza o Pro quando precisares de controlos adicionais, como PBR, modo de geometria, número de faces personalizado ou orientação por imagens multivista. Utiliza o Rapid para rascunhos de menor custo a partir de texto ou de uma imagem.
Como funcionam as entradas de imagem no PoYo?
Envia os modelos de imagem com image_urls a conter o URL de uma imagem frontal. O PoYo mantém o formato de entrada visível para o utilizador consistente em todos os modelos de imagem do Hunyuan 3D.
Posso utilizar imagens multivista?
Sim, mas apenas com hunyuan-3d/v3.1/pro/image-to-3d. Os campos de vista opcionais incluem URLs de imagens traseira, esquerda, direita, superior, inferior, frontal-esquerda e frontal-direita.
Que ficheiros pode devolver a API?
Os resultados podem incluir ficheiros GLB, OBJ, MTL, de textura, miniaturas e coleções de URLs de modelos, consoante o modelo Hunyuan 3D v3.1 selecionado.
Porquê utilizar o PoYo.ai
01
Uma única API 3D assíncrona
Utiliza o mesmo padrão de submissão, estado, callback e obtenção de ficheiros nos quatro modelos Hunyuan 3D v3.1.
02
Preços em créditos transparentes
Vê com clareza os créditos base de geração e os custos dos extras antes de submeteres uma tarefa.
03
Controlos específicos de cada modelo
O playground apresenta apenas os controlos suportados pelo modelo Pro ou Rapid selecionado.
04
Ficheiros de saída normalizados
O PoYo reúne os ficheiros de modelo, textura e miniatura devolvidos num formato de resultado de tarefa consistente.