Avançar para o conteúdo

Hyper3D - Rodin V2.5 - Image to 3D

Integrar

ID do modelo hyper3d/rodin/v2.5
# 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/hyper3d/rodin/v2.5?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# 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"

Este pedido: 0,40 $ 400 créditos da API Executar nesta página

Obter chave de API
Hyper3D Imagem para 3D Saída em 4KRápido #image-to-3d

Imagem para 3D com Rodin V2.5, usando até 5 imagens de referência e níveis de qualidade à escolha

Hyper3D · 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.

0 / 1024

Oriente a geração com texto ou permita que o modelo derive automaticamente um prompt a partir das imagens, deixando este campo vazio no modo Image-to-3D.

Avançado images · geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · use_original_alpha · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · preview_render · enable_safety_checker · bbox_condition · addons
image_urls
Largue um ficheiro ou · até 5

URLs das imagens de origem, limitadas a 5 imagens e obrigatórias no modo Image-to-3D, para gerar o modelo.

geometry_file_format predefinição glb

Formato do ficheiro de geometria, selecionado entre glb, usdz, fbx, obj, stl; predefinido como glb.

material predefinição All

Seleção da saída de materiais: escolha None para geometria sem texturas ou All para receber ambas as variantes de materiais. Para iluminação realista com materiais baseados fisicamente, escolha PBR; para iluminação pré-calculada sem mapas PBR, escolha Shaded.

texture_mode

Escolha explicitamente a qualidade da textura ou deixe a escolha para a API, que utiliza uma predefinição adequada ao nível.

predefinição Gen-2.5-High

Nível de detalhe da malha; aumentar o nível adiciona detalhe, mas Gen-2.5-Minimum ativa automaticamente o modo mínimo e força 50K Triangle independentemente de quality_mesh_option. Consulte mais detalhes na [documentação](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

predefinição Auto

Topologia e qualidade da malha, com o número de faces disponível determinado pelo nível: Extreme-Low, Low e Medium permitem até 1M Triangle; High e Extreme-High suportam de 20K Triangle a 2M Triangle. Auto aplica estas definições recomendadas: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. Na seleção manual, Quad privilegia superfícies suaves e Triangle privilegia geometria detalhada; a API Hyper3D recebe a topologia como `mesh_mode` (Quad/Raw) e o número de faces como `quality_override`.

Seed de aleatoriedade opcional, entre 0–65535.

Limita o tamanho máximo do modelo gerado utilizando um ControlNet.

Seleção de complemento opcional, fornecida como lista ou, para um único complemento, como um valor individual.

POST /run/hyper3d/rodin/v2.5?wait=20 cotação → 0,40 $
# 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/hyper3d/rodin/v2.5?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# 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 Hyper3D - Rodin V2.5 - Image to 3D

Cria um modelo 3D a partir de uma a cinco imagens em `image_urls`, com um `prompt` opcional até 1024 caracteres. Os seis níveis vão de Gen-2.5-Minimum a Gen-2.5-Extreme-High, com predefinição High. As opções incluem formato de geometria (glb, usdz, fbx, obj, stl), `material`, tamanhos de malha quadrilateral ou triangular, `TAPose` para personagens compatíveis com rig e `hd_texture`.

Parâmetros

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

NomeTipo PredefiniçãoPermitido Descrição
promptopcional
Tipostring
Predefinição
≤ 1024 caracteres
Oriente a geração com texto ou permita que o modelo derive automaticamente um prompt a partir das imagens, deixando este campo vazio no modo Image-to-3D.
image_urlsopcional images
Tipourl[] · image
≤ 5 itens
URLs das imagens de origem, limitadas a 5 imagens e obrigatórias no modo Image-to-3D, para gerar o modelo.
tieropcional
Tipoenum
PredefiniçãoGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Nível de detalhe da malha; aumentar o nível adiciona detalhe, mas Gen-2.5-Minimum ativa automaticamente o modo mínimo e força 50K Triangle independentemente de quality_mesh_option. Consulte mais detalhes na [documentação](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
use_original_alphaopcional
Tipoboolean
Predefiniçãofalse
Controla a retenção dos canais de transparência da imagem de entrada ao gerar conteúdo 3D.
seedopcional
Tipointeger | null
0 – 65 535
Seed de aleatoriedade opcional, entre 0–65535.
geometry_file_formatopcional
Tipoenum
Predefiniçãoglb
glbusdzfbxobjstl
Formato do ficheiro de geometria, selecionado entre glb, usdz, fbx, obj, stl; predefinido como glb.
materialopcional
Tipoenum
PredefiniçãoAll
PBRShadedAllNone
Seleção da saída de materiais: escolha None para geometria sem texturas ou All para receber ambas as variantes de materiais. Para iluminação realista com materiais baseados fisicamente, escolha PBR; para iluminação pré-calculada sem mapas PBR, escolha Shaded.
quality_mesh_optionopcional
Tipoenum
PredefiniçãoAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Topologia e qualidade da malha, com o número de faces disponível determinado pelo nível: Extreme-Low, Low e Medium permitem até 1M Triangle; High e Extreme-High suportam de 20K Triangle a 2M Triangle. Auto aplica estas definições recomendadas: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. Na seleção manual, Quad privilegia superfícies suaves e Triangle privilegia geometria detalhada; a API Hyper3D recebe a topologia como `mesh_mode` (Quad/Raw) e o número de faces como `quality_override`.
texture_modeopcional
Tipoenum
legacyextreme-lowlowmediumhigh
Escolha explicitamente a qualidade da textura ou deixe a escolha para a API, que utiliza uma predefinição adequada ao nível.
enable_creative_modeopcional
Tipoboolean
Predefiniçãofalse
Modo de geração criativa, equivalente a `geometry_instruct_mode` definido como `creative` na API Hyper3D. Ativá-lo torna a geração mais robusta sem sacrificar a consistência da saída.
hd_textureopcional
Tipoboolean
Predefiniçãofalse
Controla o pós-processamento avançado das texturas para melhorar a fidelidade visual.
texture_delightopcional
Tipoboolean
Predefiniçãofalse
Remove a iluminação e os realces incorporados das texturas geradas.
is_microopcional
Tipoboolean
Predefiniçãofalse
Adiciona detalhes geométricos mais finos à escala microscópica; só tem efeito quando `tier="Gen-2.5-Extreme-High"`.
TAPoseopcional
Tipoboolean
Predefiniçãofalse
Definição da pose do personagem para facilitar o rigging e a animação em software 3D: ativá-la gera personagens em pose T ou pose A.
bbox_conditionopcional
Tipoobject
Limita o tamanho máximo do modelo gerado utilizando um ControlNet.
bbox_condition.widthopcional
Tipointeger
Predefinição0
1 – 2048
Largura da restrição da caixa delimitadora ao longo do eixo x.
bbox_condition.heightopcional
Tipointeger
Predefinição0
1 – 2048
Altura da restrição da caixa delimitadora ao longo do eixo y.
bbox_condition.lengthopcional
Tipointeger
Predefinição0
1 – 2048
Comprimento da restrição da caixa delimitadora ao longo do eixo z.
addonsopcional
Tipoobject
Seleção de complemento opcional, fornecida como lista ou, para um único complemento, como um valor individual.
addons.high_packopcional
Tipoboolean
Predefiniçãofalse
Melhoramento HighPack: a saída Quad tem aproximadamente 16 vezes o número de faces solicitado através do parâmetro de qualidade, e as texturas utilizam resolução 4K em vez da predefinição 2K.
preview_renderopcional
Tipoboolean
Predefiniçãofalse
Opção de pré-visualização que adiciona uma imagem do modelo 3D gerado aos ficheiros do modelo entregues.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
A filtragem pode ser flexibilizada definindo false, desde que o autor do pedido esteja autorizado.
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": "hyper3d/rodin/v2.5",
  "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": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": ""
  },
  "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
    },
    "model_meshes": [
      {
        "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,
    "textures": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "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_mesh
object {url, content_type, file_name, file_size}Ficheiro que contém o objeto 3D gerado.
model_meshes
array of object {url, content_type, file_name, file_size}Ficheiros de objetos 3D adicionais gerados pelo Hyper3D e devolvidos além de model_mesh.
seed
integerSeed aplicada durante a geração.
textures
array of object {url, content_type, file_name, file_size, width, height}Texturas produzidas para o objeto 3D.

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/hyper3d/rodin/v2.5.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt