Avançar para o conteúdo

Hunyuan3d V3 · Sketch to 3D

Integrar

ID do modelo hunyuan3d-v3/sketch-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/hunyuan3d-v3/sketch-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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/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 que transforma um esboço ou desenho linear e um prompt de texto num modelo 3D

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 88 / 1024

Especifique atributos do conteúdo 3D num prompt de texto — por exemplo, o material, a cor ou a categoria.

•obrigatório
Largue um ficheiro ou

URL de um esboço ou de uma imagem de line art para conversão num modelo 3D. As dimensões de imagem suportadas vão de 128 × 128 a 5000 × 5000 pixels.

predefinição 500000

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

Avançado enable_safety_checker
POST /run/hunyuan3d-v3/sketch-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://vit.doitong.com/api/v1/run/hunyuan3d-v3/sketch-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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/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 · Sketch to 3D

Requer uma imagem de esboço ou desenho linear (`input_image_url`, 128x128 a 5000x5000 pixels) e um `prompt` até 1024 caracteres que descreva a cor, a categoria e o material. `enable_pbr` ativa os materiais PBR e `face_count` define o número de polígonos pretendido entre 40000 e 1500000. Devolve um ficheiro GLB, URLs para outros formatos e uma miniatura.

Parâmetros

NomeTipo PredefiniçãoPermitido Descrição
input_image_urlobrigatório
Tipourl · image
URL de um esboço ou de uma imagem de line art para conversão num modelo 3D. As dimensões de imagem suportadas vão de 128 × 128 a 5000 × 5000 pixels.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
A filtragem pode ser flexibilizada definindo false, desde que o autor do pedido esteja autorizado.
promptobrigatório
Tipostring
≤ 1024 caracteres
Especifique atributos do conteúdo 3D num prompt de texto — por exemplo, o material, a cor ou a categoria.
enable_pbropcional
Tipoboolean
Predefiniçãofalse
Opção para ativar ou desativar a geração de materiais PBR.
face_countopcional
Tipointeger
Predefinição500000
40 000 – 1 500 000
Número pretendido de faces, entre 40,000 e 1,500,000.
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/sketch-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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/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/sketch-to-3d.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt