Ir al contenido

Hyper3D - Rodin V2.5 - Image to 3D

Integrar

ID del 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 solicitud: $0.40 400 créditos de API Ejecutar en esta página

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

Imagen a 3D con Rodin V2.5 usando hasta 5 imágenes de referencia y una selección de niveles de calidad

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, donde se conservan 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 conforme los cambias.

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

URL de las imágenes de origen, limitadas a 5 imágenes y obligatorias en el modo Image-to-3D, para generar el modelo.

geometry_file_format predeterminado glb

Formato del archivo de geometría, seleccionado entre glb, usdz, fbx, obj, stl; predeterminado: glb.

material predeterminado All

Selección de salida de materiales: elige None para obtener geometría sin texturas o All para recibir ambas variantes de materiales. Para 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-High

Nivel de detalle de la malla; aumentarlo agrega detalles, pero Gen-2.5-Minimum activa automáticamente el modo mínimo y fuerza 50K Triangle sin importar quality_mesh_option. Hay más información en la [documentación](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

predeterminado Auto

Topología y calidad de la malla, con cantidades de caras determinadas por el nivel: Extreme-Low, Low y Medium permiten hasta 1M Triangle; High y Extreme-High admiten de 20K Triangle a 2M Triangle. Auto aplica estas configuraciones 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. Para la selección manual, Quad favorece las superficies suaves y Triangle favorece la geometría detallada; Hyper3D API recibe la topología como `mesh_mode` (Quad/Raw) y la cantidad de caras como `quality_override`.

Semilla de aleatorización opcional, con un rango de 0–65535.

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

Selección opcional de complementos, proporcionada como lista o, para un solo complemento, como valor individual.

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

Ejecutar esta solicitud

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

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

Construye un modelo 3D desde una a cinco imágenes en `image_urls`, con un `prompt` opcional de hasta 1024 caracteres. Hay seis niveles, de Gen-2.5-Minimum a Gen-2.5-Extreme-High, con High como valor predeterminado. Las opciones incluyen formato de geometría (glb, usdz, fbx, obj, stl), `material`, tamaños de malla cuadrangular o triangular, `TAPose` para personajes compatibles con rig y `hd_texture`.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción
promptopcional
Tipostring
Predeterminado
≤ 1,024 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.
image_urlsopcional images
Tipourl[] · image
≤ 5 elementos
URL de las imágenes de origen, limitadas a 5 imágenes y obligatorias en el modo Image-to-3D, para generar el modelo.
tieropcional
Tipoenum
PredeterminadoGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Nivel de detalle de la malla; aumentarlo agrega detalles, pero Gen-2.5-Minimum activa automáticamente el modo mínimo y fuerza 50K Triangle sin importar quality_mesh_option. Hay más información en la [documentación](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
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 aleatorización opcional, con un rango de 0–65535.
geometry_file_formatopcional
Tipoenum
Predeterminadoglb
glbusdzfbxobjstl
Formato del archivo de geometría, seleccionado entre glb, usdz, fbx, obj, stl; predeterminado: glb.
materialopcional
Tipoenum
PredeterminadoAll
PBRShadedAllNone
Selección de salida de materiales: elige None para obtener geometría sin texturas o All para recibir ambas variantes de materiales. Para iluminación realista con materiales basados físicamente, elige PBR; para iluminación precalculada sin mapas PBR, elige Shaded.
quality_mesh_optionopcional
Tipoenum
PredeterminadoAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Topología y calidad de la malla, con cantidades de caras determinadas por el nivel: Extreme-Low, Low y Medium permiten hasta 1M Triangle; High y Extreme-High admiten de 20K Triangle a 2M Triangle. Auto aplica estas configuraciones 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. Para la selección manual, Quad favorece las superficies suaves y Triangle favorece la geometría detallada; Hyper3D API recibe la topología como `mesh_mode` (Quad/Raw) y la cantidad de caras como `quality_override`.
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. Habilitarlo 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 de las texturas generadas la iluminación y los reflejos incorporados.
is_microopcional
Tipoboolean
Predeterminadofalse
Agrega detalles geométricos más finos a escala microscópica; solo tiene efecto cuando `tier="Gen-2.5-Extreme-High"`.
TAPoseopcional
Tipoboolean
Predeterminadofalse
Configuración de la pose del personaje para facilitar el rigging y la animación en software 3D: habilitarla genera personajes en pose T o pose A.
bbox_conditionopcional
Tipoobject
Limita el tamaño máximo del modelo generado mediante un ControlNet.
bbox_condition.widthopcional
Tipointeger
Predeterminado0
1 – 2,048
Ancho de la restricción de la caja delimitadora en el eje x.
bbox_condition.heightopcional
Tipointeger
Predeterminado0
1 – 2,048
Altura de la restricción de la caja delimitadora en el eje y.
bbox_condition.lengthopcional
Tipointeger
Predeterminado0
1 – 2,048
Longitud de la restricción de la caja delimitadora en el eje z.
addonsopcional
Tipoobject
Selección opcional de complementos, proporcionada como lista o, para un solo complemento, como valor individual.
addons.high_packopcional
Tipoboolean
Predeterminadofalse
Mejora HighPack: la salida Quad tiene aproximadamente 16 veces la cantidad de caras solicitada mediante el parámetro de calidad, y las texturas usan resolución 4K en lugar del valor predeterminado 2K.
preview_renderopcional
Tipoboolean
Predeterminadofalse
Alternador de renderizado de vista previa que agrega 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 la persona que llama esté autorizada.
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",
  "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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: se conserva para siempre (con cobro 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 video 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 adicionales de objetos 3D 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á disponible en https://doitong.com/es-MX/developers/models/hyper3d/rodin/v2.5.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt