Avançar para o conteúdo

Hi3D Image to 3D · v3.0

Integrar

ID do modelo hitem3d/hi3d/v3.0/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/hitem3d/hi3d/v3.0/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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"

Ficheiros como o exemplo: 2,10 $ 2100 créditos da API · ≈ 225,67 ₽ os seus ficheiros são medidos antes da execução Executar nesta página

Obter chave de API
Hitem3D Imagem para 3D #image-to-3d#3d#mesh

Hi3D v3.0 de imagem única para 3D, com qualidade 2048 ou resolução master e controlo de remoção de sombreamento

Hitem3D · 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 image_url
Largue um ficheiro ou

Forneça a imagem de entrada por URL como ficheiro PNG, JPEG ou WebP com no máximo 20 MB.

resolution predefinição 2048quality

Seletor de resolução de geração com compromisso entre qualidade e velocidade: escolha 2048master para a qualidade máxima ou a predefinição 2048quality para uma geração mais rápida.

Avançado export_format · model · face_count · shading · enable_safety_checker
export_format predefinição glb

Formato utilizado para guardar o modelo gerado.

predefinição hi3dv3.0

Versão do modelo Hi3D v3.0 para este endpoint.

Número de faces pretendido, com recomendações do fornecedor de 2,000,000 ao utilizar 2048quality e 5,000,000 ao utilizar 2048master.

predefinição 0.5

Intensidade da remoção de sombreamento.

POST /run/hitem3d/hi3d/v3.0/image-to-3d?wait=20 cotação → 2,10 $
# 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/hitem3d/hi3d/v3.0/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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 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 Hi3D Image to 3D · v3.0

Gera um modelo 3D a partir de uma imagem de até 20MB. `resolution` é 2048quality ou 2048master, sendo esta última para a qualidade máxima. `face_count` pode atingir 5,000,000 e `shading` (0 a 1) define a intensidade da remoção de sombreamento. Estão disponíveis opções de textura e PBR, com exportação glb, obj, stl, fbx ou usdz.

Parâmetros

Envie o nome canónico ou o nome nativo, não ambos. Nomes canónicos

NomeTipo PredefiniçãoPermitido Descrição
modelopcional
Tipostring
Predefiniçãohi3dv3.0
Versão do modelo Hi3D v3.0 para este endpoint.
resolutionopcional
Tipoenum
Predefinição2048quality
2048quality2048master
Seletor de resolução de geração com compromisso entre qualidade e velocidade: escolha 2048master para a qualidade máxima ou a predefinição 2048quality para uma geração mais rápida.
enable_textureopcional
Tipoboolean
Predefiniçãotrue
Controla se as texturas são geradas juntamente com a geometria.
enable_pbropcional
Tipoboolean
Predefiniçãotrue
Controla se os mapas de materiais PBR são criados juntamente com a textura.
face_countopcional
Tipointeger | null
100 000 – 5 000 000
Número de faces pretendido, com recomendações do fornecedor de 2,000,000 ao utilizar 2048quality e 5,000,000 ao utilizar 2048master.
export_formatopcional
Tipoenum
Predefiniçãoglb
glbobjstlfbxusdz
Formato utilizado para guardar o modelo gerado.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
Opção de verificação de segurança das imagens de entrada: true requer uma verificação antes do início do processamento.
image_urlobrigatório image
Tipourl · image
Forneça a imagem de entrada por URL como ficheiro PNG, JPEG ou WebP com no máximo 20 MB.
shadingopcional
Tiponumber
Predefinição0.5
0 – 1
Intensidade da remoção de sombreamento.
obrigatório Nome canónico, também aceite

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": "hitem3d/hi3d/v3.0/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": 2100,
    "usd": "2.10",
    "charged": 2100,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_mesh": {
      "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
    }
  },
  "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"
  }
}
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_mesh
object {url, content_type, file_name, file_size}Ficheiro que contém o modelo 3D gerado.
thumbnail
object {url, content_type, file_name, file_size} | nullImagem de pré-visualização do modelo, fornecida quando disponível.

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/hitem3d/hi3d/v3.0/image-to-3d.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt