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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esta solicitud: 0,40 $ 400 créditos de API · ≈ 42,19 ₽ Ejecutar en esta página

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

Conversión de imagen a 3D con Rodin V2.5 usando hasta 5 imágenes de referencia y varios 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, 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 · addons
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 All

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-High

Nivel de detalle de la malla; aumentarlo añade detalle, pero Gen-2.5-Minimum activa automáticamente el modo mínimo y fuerza 50K Triangle independientemente de quality_mesh_option. Hay más detalles 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 disponibles 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 estos ajustes recomendados: 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 aleatoriedad opcional, con un rango de 0–65535.

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

Selección de complementos opcionales, proporcionada como lista o, para un solo complemento, como valor único.

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.ru/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.ru/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

Crea un modelo 3D a partir de una a cinco imágenes en `image_urls`, con un `prompt` opcional de hasta 1024 caracteres. Los seis niveles van de Gen-2.5-Minimum a Gen-2.5-Extreme-High, con High como valor predeterminado. Las opciones incluyen el formato de geometría (glb, usdz, fbx, obj, stl), `material`, tamaños de malla cuadrangular o triangular, `TAPose` para personajes compatibles con rigging 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
≤ 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.
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-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 añade detalle, pero Gen-2.5-Minimum activa automáticamente el modo mínimo y fuerza 50K Triangle independientemente de quality_mesh_option. Hay más detalles 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 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
PredeterminadoAll
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
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 disponibles 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 estos ajustes recomendados: 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. 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.
addonsopcional
Tipoobject
Selección de complementos opcionales, proporcionada como lista o, para un solo complemento, como valor único.
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 utilizan una resolución 4K en lugar del valor predeterminado 2K.
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",
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt