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

Esta solicitação: $ 0,40 400 créditos de 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 escolha de níveis de qualidade

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

0 / 1024

Oriente a geração com texto ou deixe o modelo derivar um prompt automaticamente 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
Solte um arquivo 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 padrão glb

Formato do arquivo de geometria, selecionado entre glb, usdz, fbx, obj, stl; o padrão é glb.

material padrão All

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

texture_mode

Escolha explicitamente a qualidade da textura ou deixe a escolha para a API, que usa um padrão adequado à categoria.

padrão Gen-2.5-High

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

padrão Auto

Topologia e qualidade da malha, com quantidades de faces disponíveis determinadas pela categoria: Extreme-Low, Low e Medium permitem até 1M Triangle; High e Extreme-High são compatíveis com 20K Triangle até 2M Triangle. Auto aplica estas configuraçõ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 favorece superfícies suaves e Triangle favorece geometria detalhada; a Hyper3D API recebe a topologia como `mesh_mode` (Quad/Raw) e a quantidade de faces como `quality_override`.

Seed de aleatoriedade opcional, com intervalo de 0–65535.

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

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

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 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 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 de até 1024 caracteres. Os seis níveis variam de Gen-2.5-Minimum a Gen-2.5-Extreme-High, com High como padrão. As opções incluem formato de geometria (glb, usdz, fbx, obj, stl), `material`, tamanhos de malha quad ou triangle, `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 PadrãoPermitido Descrição
promptopcional
Tipostring
Padrão
≤ 1.024 caracteres
Oriente a geração com texto ou deixe o modelo derivar um prompt automaticamente 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
Padrã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
Categoria de detalhe da malha; aumentar a categoria adiciona detalhes, mas Gen-2.5-Minimum ativa automaticamente o modo mínimo e força 50K Triangle, independentemente de quality_mesh_option. Mais detalhes estão 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
Padrãofalse
Controla a retenção dos canais de transparência das imagens de entrada ao gerar conteúdo 3D.
seedopcional
Tipointeger | null
0 – 65.535
Seed de aleatoriedade opcional, com intervalo de 0–65535.
geometry_file_formatopcional
Tipoenum
Padrãoglb
glbusdzfbxobjstl
Formato do arquivo de geometria, selecionado entre glb, usdz, fbx, obj, stl; o padrão é glb.
materialopcional
Tipoenum
PadrãoAll
PBRShadedAllNone
Seleção da saída de materiais: escolha None para geometria sem texturas ou All para receber ambas as variantes de material. Para iluminação realista com materiais fisicamente baseados, escolha PBR; para iluminação pré-renderizada sem mapas PBR, escolha Shaded.
quality_mesh_optionopcional
Tipoenum
PadrãoAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Topologia e qualidade da malha, com quantidades de faces disponíveis determinadas pela categoria: Extreme-Low, Low e Medium permitem até 1M Triangle; High e Extreme-High são compatíveis com 20K Triangle até 2M Triangle. Auto aplica estas configuraçõ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 favorece superfícies suaves e Triangle favorece geometria detalhada; a Hyper3D API recebe a topologia como `mesh_mode` (Quad/Raw) e a quantidade de faces como `quality_override`.
texture_modeopcional
Tipoenum
legacyextreme-lowlowmediumhigh
Escolha explicitamente a qualidade da textura ou deixe a escolha para a API, que usa um padrão adequado à categoria.
enable_creative_modeopcional
Tipoboolean
Padrãofalse
Modo de geração criativa, equivalente a `geometry_instruct_mode` definido como `creative` na Hyper3D API. Ativá-lo torna a geração mais robusta sem sacrificar a consistência da saída.
hd_textureopcional
Tipoboolean
Padrãofalse
Controla o pós-processamento avançado de texturas para melhorar a fidelidade visual.
texture_delightopcional
Tipoboolean
Padrãofalse
Remove a iluminação e os realces incorporados das texturas geradas.
is_microopcional
Tipoboolean
Padrãofalse
Adiciona detalhes geométricos mais finos em escala microscópica; só tem efeito quando `tier="Gen-2.5-Extreme-High"`.
TAPoseopcional
Tipoboolean
Padrãofalse
Configuração da pose do personagem para facilitar rigging e animação em software 3D: ativá-la gera personagens em pose T ou A.
bbox_conditionopcional
Tipoobject
Limita o tamanho máximo do modelo gerado usando um ControlNet.
bbox_condition.widthopcional
Tipointeger
Padrão0
1 – 2.048
Largura da restrição da caixa delimitadora ao longo do eixo x.
bbox_condition.heightopcional
Tipointeger
Padrão0
1 – 2.048
Altura da restrição da caixa delimitadora ao longo do eixo y.
bbox_condition.lengthopcional
Tipointeger
Padrão0
1 – 2.048
Comprimento da restrição da caixa delimitadora ao longo do eixo z.
addonsopcional
Tipoobject
Seleção de complemento opcional, fornecida como uma lista ou, para apenas um complemento, como um único valor.
addons.high_packopcional
Tipoboolean
Padrãofalse
Aprimoramento HighPack: a saída Quad tem aproximadamente 16 vezes a quantidade de faces solicitada pelo parâmetro de qualidade, e as texturas usam resolução 4K em vez do padrão 2K.
preview_renderopcional
Tipoboolean
Padrãofalse
Alternância de renderização de prévia que adiciona uma imagem mostrando o modelo 3D gerado aos arquivos de modelo entregues.
enable_safety_checkeropcional
Tipoboolean
Padrãotrue
A filtragem pode ser relaxada definindo false, desde que o chamador esteja autorizado.
obrigatório Nome canônico, também aceito

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": "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"
  }
}
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_mesh
object {url, content_type, file_name, file_size}Arquivo contendo o objeto 3D gerado.
model_meshes
array of object {url, content_type, file_name, file_size}Arquivos de objetos 3D extras gerados pelo Hyper3D e retornados 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á em https://doitong.com/pt-BR/developers/models/hyper3d/rodin/v2.5.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt