Ir al contenido

Tripo H3.1 Image to 3D

Integrar

Id del modelo tripo3d/h3.1/image-to-3d
# 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/tripo3d/h3.1/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

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

Archivos como el ejemplo: 0,30 $ 300 créditos de API · ≈ 32,27 ₽ tus archivos se miden antes de la ejecución Ejecutar en esta página

Obtener clave de API
Tripo Imagen a 3D #3d#image-to-3d#3d-generation#tripo

Generación 3D a partir de una sola imagen con materiales PBR, mallas cuadrangulares y control del número de caras

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

•obligatorio image_url
Suelta un archivo o

URL de la imagen de entrada utilizada para crear un modelo 3D.

texture_quality predeterminado standard

Configuración de calidad de la textura; elegir 'detailed' aumenta la resolución de la textura.

geometry_quality predeterminado standard

Configuración de calidad de la geometría.

Avanzado texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment predeterminado original_image

Referencia de alineación de la textura: usa 'geometry' para la geometría generada u 'original_image' para la imagen de entrada.

orientation predeterminado default

Orientación del modelo; 'align_image' lo gira automáticamente para que coincida con la imagen de entrada.

Objetivo explícito de cantidad de caras para la generación de la malla, que reemplaza la selección adaptativa de cantidad del modelo cuando se proporciona.

Semilla utilizada para hacer reproducible la generación de geometría.

Semilla utilizada para hacer reproducible la generación de texturas.

POST /run/tripo3d/h3.1/image-to-3d?wait=20 cotización → 0,30 $
# 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/tripo3d/h3.1/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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 Tripo H3.1 Image to 3D

Construye un modelo 3D a partir de una imagen en `image_url`. Las opciones incluyen `face_limit` (de 1,000 a 2,000,000), `texture`, `pbr`, `texture_quality` y `geometry_quality` estándar o detallada, topología `quad`, `auto_size` y `orientation`. El resultado incluye un renderizado de vista previa y un ID de tarea para el rigging posterior.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción
image_urlobligatorio image
Tipourl · image
URL de la imagen de entrada utilizada para crear un modelo 3D.
face_limitopcional
Tipointeger | null
1000 – 2.000.000
Objetivo explícito de cantidad de caras para la generación de la malla, que reemplaza la selección adaptativa de cantidad del modelo cuando se proporciona.
textureopcional
Tipoboolean
Predeterminadotrue
Controla si el modelo recibe texturas generadas.
pbropcional
Tipoboolean
Predeterminadotrue
Activa los materiales PBR (Physically Based Rendering), lo que también activa la generación de texturas cuando es true.
model_seedopcional
Tipointeger | null
Semilla utilizada para hacer reproducible la generación de geometría.
texture_seedopcional
Tipointeger | null
Semilla utilizada para hacer reproducible la generación de texturas.
texture_qualityopcional
Tipoenum
Predeterminadostandard
standarddetailed
Configuración de calidad de la textura; elegir 'detailed' aumenta la resolución de la textura.
geometry_qualityopcional
Tipoenum
Predeterminadostandard
standarddetailed
Configuración de calidad de la geometría.
texture_alignmentopcional
Tipoenum
Predeterminadooriginal_image
original_imagegeometry
Referencia de alineación de la textura: usa 'geometry' para la geometría generada u 'original_image' para la imagen de entrada.
auto_sizeopcional
Tipoboolean
Predeterminadofalse
Escalado automático para dar al modelo dimensiones del mundo real medidas en metros.
orientationopcional
Tipoenum
Predeterminadodefault
defaultalign_image
Orientación del modelo; 'align_image' lo gira automáticamente para que coincida con la imagen de entrada.
quadopcional
Tipoboolean
Predeterminadofalse
Elige entre caras triangulares y cuadriláteros de 4 lados activando la topología de cuadriláteros. Para resultados con cuadriláteros, se devuelve un archivo FBX siempre que Tripo proporcione los datos como bytes FBX.
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": "tripo3d/h3.1/image-to-3d",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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_urls": {
      "glb": {
        "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
      },
      "fbx": {
        "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
      },
      "base_model": {
        "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
      },
      "pbr_model": {
        "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
      }
    },
    "rendered_image": {
      "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
    },
    "task_id": "string"
  },
  "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 GLB o FBX que contiene el modelo 3D generado, con el formato determinado por lo que produzca Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL que apunta a versiones alternativas del modelo 3D.
rendered_image
object {url, content_type, file_name, file_size} | nullVista previa renderizada que muestra el modelo 3D generado.
task_id
string | nullID de tarea de Tripo reutilizable que identifica el modelo generado para rig o rig-check y permite realizar esas operaciones sin volver a subir el modelo.

Más modelos: Imagen a 3D

Para agentes de IA: esta página en Markdown está en https://doitong.com/es/developers/models/tripo3d/h3.1/image-to-3d.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt