Avançar para o conteúdo

Hunyuan3d V3 · Image to 3D

Integrar

ID do modelo hunyuan3d-v3/image-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ficheiros como o exemplo: 0,375 $ 375 créditos da API os seus ficheiros são medidos antes da execução Executar nesta página

Obter chave de API
Tencent Imagem para 3D

Hunyuan3D V3 de imagem para 3D, com vistas traseira/esquerda/direita, PBR e modos low-poly opcionais

Tencent · 3D

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório
Largue um ficheiro ou

URL da imagem utilizada para a geração do modelo 3D.

Largue um ficheiro ou

URL da imagem da vista traseira, fornecida opcionalmente para melhorar a reconstrução 3D.

Largue um ficheiro ou

URL da imagem da vista esquerda, fornecida opcionalmente para melhorar a reconstrução 3D.

Largue um ficheiro ou

URL da imagem da vista direita, fornecida opcionalmente para melhorar a reconstrução 3D.

generate_type predefinição Normal

Modo de geração: `Normal` produz um modelo texturizado; `LowPoly` reduz os polígonos; `Geometry` produz um modelo branco sem textura.

predefinição 500000

Número pretendido de faces, entre 40,000 e 1,500,000.

Avançado polygon_type · enable_safety_checker
polygon_type predefinição triangle

Tipo de polígono, aplicado apenas quando `GenerateType` é `LowPoly`.

POST /run/hunyuan3d-v3/image-to-3d?wait=20 cotação → 0,375 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre Hunyuan3d V3 · Image to 3D

Cria um modelo 3D a partir de `input_image_url`, com `back_image_url`, `left_image_url` e `right_image_url` opcionais para melhorar a reconstrução. `generate_type` seleciona Normal, LowPoly ou Geometry (sem texturas) e `polygon_type` escolhe triangle ou quadrilateral para LowPoly. `enable_pbr` adiciona materiais PBR e `face_count` varia entre 40000 e 1500000. Devolve um GLB, URLs para outros formatos e uma miniatura.

Parâmetros

NomeTipo PredefiniçãoPermitido Descrição
input_image_urlobrigatório
Tipourl · image
URL da imagem utilizada para a geração do modelo 3D.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
A filtragem pode ser flexibilizada definindo false, desde que o autor do pedido esteja autorizado.
back_image_urlopcional
Tipourl · image
URL da imagem da vista traseira, fornecida opcionalmente para melhorar a reconstrução 3D.
left_image_urlopcional
Tipourl · image
URL da imagem da vista esquerda, fornecida opcionalmente para melhorar a reconstrução 3D.
right_image_urlopcional
Tipourl · image
URL da imagem da vista direita, fornecida opcionalmente para melhorar a reconstrução 3D.
enable_pbropcional
Tipoboolean
Predefiniçãofalse
Gera materiais PBR, exceto quando generate_type é Geometry; nesse caso, esta definição não tem efeito.
face_countopcional
Tipointeger
Predefinição500000
40 000 – 1 500 000
Número pretendido de faces, entre 40,000 e 1,500,000.
generate_typeopcional
Tipoenum
PredefiniçãoNormal
NormalLowPolyGeometry
Modo de geração: `Normal` produz um modelo texturizado; `LowPoly` reduz os polígonos; `Geometry` produz um modelo branco sem textura.
polygon_typeopcional
Tipoenum
Predefiniçãotriangle
trianglequadrilateral
Tipo de polígono, aplicado apenas quando `GenerateType` é `LowPoly`.
obrigatório

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/image-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 375,
    "usd": "0.375",
    "charged": 375,
    "refunded": 0
  },
  "input": {
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "thumbnail": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "obj": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "usdz": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
model_glb
object {url, content_type, file_name, file_size}Ficheiro GLB que contém o objeto 3D gerado.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatura que mostra uma pré-visualização do modelo gerado.
model_urls
object {glb, fbx, obj, usdz}Ligações para o modelo 3D em vários formatos.
seed
integer | nullValor de seed utilizado durante a geração.

Mais modelos: Imagem para 3D

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/hunyuan3d-v3/image-to-3d.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt