Ir al contenido

Hyper3D - Rodin V2.5 - Image to 3D - Fast

Integrar

Id del modelo hyper3d/rodin/v2.5/fast
# 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/fast?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 solicitud: 0,10 $ 100 créditos de API Ejecutar en esta página

Obtener clave de API
Hyper3D Imagen a 3D Salida 4KRápido #image-to-3d

Conversión más rápida de imagen a 3D con Rodin V2.5, limitada a los tres niveles más bajos para prototipado rápido

Hyper3D · 3D

Tu primer resultado aparecerá aquí

Crea una solicitud abajo y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

0 / 1024

Guía la generación con texto, o permite que el modelo derive automáticamente un prompt de las imágenes al dejarlo vacío en el modo Image-to-3D.

Avanzado 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
image_urls
Suelta un archivo o · hasta 5

URL de las imágenes de origen, con un límite de 5 imágenes y obligatorias en el modo Image-to-3D para generar el modelo.

geometry_file_format predeterminado glb

Formato de archivo de geometría, seleccionado entre glb, usdz, fbx, obj y stl; el valor predeterminado es glb.

material predeterminado Shaded

Selección de salida de materiales: elige None para obtener geometría sin texturas o All para recibir ambas variantes de material. Para una iluminación realista con materiales basados físicamente, elige PBR; para iluminación precalculada sin mapas PBR, elige Shaded.

texture_mode

Elige explícitamente la calidad de las texturas o deja la elección en manos de la API, que utiliza un valor predeterminado adecuado para el nivel.

predeterminado Gen-2.5-Extreme-Low

Nivel de generación; Gen-2.5-Minimum fuerza el modo mínimo y una malla 50K Triangle independientemente de `quality_mesh_option`. Los detalles del nivel están disponibles en la [documentación de Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

predeterminado Auto

Elige la calidad junto con la topología de la malla: Quad favorece las superficies suaves, mientras que Triangle favorece el detalle geométrico. El endpoint rápido está pensado principalmente para pruebas y prototipos, con un límite de 20K; usa el endpoint estándar para mallas de mayor calidad, donde Minimum, Extreme-Low y Low admiten hasta 1M Triangle, con cantidades de caras disponibles según el nivel. En Hyper3D API, `quality_override` especifica la cantidad de caras, mientras que `mesh_mode` especifica Quad/Raw. Auto selecciona los ajustes recomendados: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Semilla de aleatoriedad opcional, con un rango de 0–65535.

Limita el tamaño máximo del modelo generado mediante un ControlNet.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 cotización → 0,10 $
# 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/fast?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"

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y se guarda (localStorage) únicamente si marcas Recordar. Obtener una clave de API

Acerca de Hyper3D - Rodin V2.5 - Image to 3D - Fast

Crea un modelo 3D a partir de una a cinco imágenes en `image_urls`, con un `prompt` opcional. `tier` está limitado a Minimum, Extreme-Low (predeterminado) y Low, y las opciones de malla llegan hasta 20K caras. El material predeterminado es Shaded. Los formatos de salida son glb, usdz, fbx, obj o stl.

Parámetros

Envía el nombre canónico o el nombre nativo, no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
image_urlsopcional images
Tipourl[] · image
≤ 5 elementos
URL de las imágenes de origen, con un límite de 5 imágenes y obligatorias en el modo Image-to-3D para generar el modelo.
tieropcional
Tipoenum
PredeterminadoGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Nivel de generación; Gen-2.5-Minimum fuerza el modo mínimo y una malla 50K Triangle independientemente de `quality_mesh_option`. Los detalles del nivel están disponibles en la [documentación de Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptopcional
Tipostring
Predeterminado
≤ 1024 caracteres
Guía la generación con texto, o permite que el modelo derive automáticamente un prompt de las imágenes al dejarlo vacío en el modo Image-to-3D.
use_original_alphaopcional
Tipoboolean
Predeterminadofalse
Controla la conservación de los canales de transparencia de las imágenes de entrada al generar contenido 3D.
seedopcional
Tipointeger | null
0 – 65.535
Semilla de aleatoriedad opcional, con un rango de 0–65535.
geometry_file_formatopcional
Tipoenum
Predeterminadoglb
glbusdzfbxobjstl
Formato de archivo de geometría, seleccionado entre glb, usdz, fbx, obj y stl; el valor predeterminado es glb.
materialopcional
Tipoenum
PredeterminadoShaded
PBRShadedAllNone
Selección de salida de materiales: elige None para obtener geometría sin texturas o All para recibir ambas variantes de material. Para una iluminación realista con materiales basados físicamente, elige PBR; para iluminación precalculada sin mapas PBR, elige Shaded.
quality_mesh_optionopcional
Tipoenum
PredeterminadoAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Elige la calidad junto con la topología de la malla: Quad favorece las superficies suaves, mientras que Triangle favorece el detalle geométrico. El endpoint rápido está pensado principalmente para pruebas y prototipos, con un límite de 20K; usa el endpoint estándar para mallas de mayor calidad, donde Minimum, Extreme-Low y Low admiten hasta 1M Triangle, con cantidades de caras disponibles según el nivel. En Hyper3D API, `quality_override` especifica la cantidad de caras, mientras que `mesh_mode` especifica Quad/Raw. Auto selecciona los ajustes recomendados: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modeopcional
Tipoenum
legacyextreme-lowlowmediumhigh
Elige explícitamente la calidad de las texturas o deja la elección en manos de la API, que utiliza un valor predeterminado adecuado para el nivel.
enable_creative_modeopcional
Tipoboolean
Predeterminadofalse
Modo de generación creativa, equivalente a `geometry_instruct_mode` establecido en `creative` en Hyper3D API. Activarlo hace que la generación sea más robusta sin sacrificar la coherencia de la salida.
hd_textureopcional
Tipoboolean
Predeterminadofalse
Controla el posprocesamiento avanzado de texturas para mejorar la fidelidad visual.
texture_delightopcional
Tipoboolean
Predeterminadofalse
Elimina la iluminación y los reflejos precalculados de las texturas generadas.
is_microopcional
Tipoboolean
Predeterminadofalse
Añade detalles geométricos más finos a escala microscópica; solo tiene efecto cuando `tier="Gen-2.5-Extreme-High"`.
TAPoseopcional
Tipoboolean
Predeterminadofalse
Ajuste de pose del personaje para facilitar el rigging y la animación en software 3D: al activarlo, los personajes se generan en pose T o A.
bbox_conditionopcional
Tipoobject
Limita el tamaño máximo del modelo generado mediante un ControlNet.
bbox_condition.widthopcional
Tipointeger
Predeterminado0
1 – 2048
Anchura de la restricción del cuadro delimitador a lo largo del eje x.
bbox_condition.heightopcional
Tipointeger
Predeterminado0
1 – 2048
Altura de la restricción del cuadro delimitador a lo largo del eje y.
bbox_condition.lengthopcional
Tipointeger
Predeterminado0
1 – 2048
Longitud de la restricción del cuadro delimitador a lo largo del eje z.
preview_renderopcional
Tipoboolean
Predeterminadofalse
Interruptor de renderizado de vista previa que añade una imagen del modelo 3D generado a los archivos del modelo entregados.
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
La moderación puede relajarse estableciendo false, siempre que el autor de la llamada esté autorizado.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una carga. Archivos

Salida

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/fast",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (se cobra por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
model_mesh
object {url, content_type, file_name, file_size}Archivo que contiene el objeto 3D generado.
model_meshes
array of object {url, content_type, file_name, file_size}Archivos de objetos 3D adicionales generados por Hyper3D y devueltos además de model_mesh.
seed
integerSemilla aplicada durante la generación.
textures
array of object {url, content_type, file_name, file_size, width, height}Texturas producidas para el objeto 3D.

Más modelos: Imagen a 3D

Para agentes de IA: esta página en Markdown está en https://doitong.com/es/developers/models/hyper3d/rodin/v2.5/fast.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt