Ir 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Arquivos como o exemplo: $ 0,375 375 créditos de API · ≈ ₽ 40,24 seus arquivos 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 opcionais e modos PBR e low-poly

Tencent · 3D

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório
Solte um arquivo ou

URL da imagem usada para geração de modelo 3D.

Solte um arquivo ou

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

Solte um arquivo ou

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

Solte um arquivo ou

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

generate_type padrão Normal

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

padrão 500000

Número desejado de faces, variando de 40,000 a 1,500,000.

Avançado polygon_type · enable_safety_checker
polygon_type padrão triangle

Tipo de polígono, aplicado somente 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar 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 textura), e `polygon_type` escolhe triangle ou quadrilateral para LowPoly. `enable_pbr` adiciona materiais PBR e `face_count` varia de 40000 a 1500000. Retorna um GLB, URLs de outros formatos e uma miniatura.

Parâmetros

NomeTipo PadrãoPermitido Descrição
input_image_urlobrigatório
Tipourl · image
URL da imagem usada para geração de modelo 3D.
enable_safety_checkeropcional
Tipoboolean
Padrãotrue
A filtragem pode ser relaxada definindo false, desde que o chamador 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
Padrãofalse
Gera materiais PBR, exceto quando generate_type é Geometry; nesse caso, esta configuração não tem efeito.
face_countopcional
Tipointeger
Padrão500000
40.000 – 1.500.000
Número desejado de faces, variando de 40,000 a 1,500,000.
generate_typeopcional
Tipoenum
PadrãoNormal
NormalLowPolyGeometry
Modo de geração: `Normal` produz um modelo com textura; `LowPoly` reduz os polígonos; `Geometry` produz um modelo branco sem textura.
polygon_typeopcional
Tipoenum
Padrãotriangle
trianglequadrilateral
Tipo de polígono, aplicado somente quando `GenerateType` é `LowPoly`.
obrigatório

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
model_glb
object {url, content_type, file_name, file_size}Arquivo GLB contendo o objeto 3D gerado.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatura mostrando uma prévia do modelo gerado.
model_urls
object {glb, fbx, obj, usdz}Links para o modelo 3D em vários formatos.
seed
integer | nullValor de seed usado durante a geração.

Mais modelos: Imagem para 3D

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