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.19 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, 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.

•obligatorio image_url
Suelta un archivo o

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

texture_quality predeterminado standard

Configuración de calidad de 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 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 coincidir 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 usada para hacer reproducible la generación de geometría.

Semilla usada 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 en 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 usada para crear un modelo 3D.
face_limitopcional
Tipointeger | null
1,000 – 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 usada para hacer reproducible la generación de geometría.
texture_seedopcional
Tipointeger | null
Semilla usada para hacer reproducible la generación de texturas.
texture_qualityopcional
Tipoenum
Predeterminadostandard
standarddetailed
Configuración de calidad de 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 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 coincidir 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 cuando Tripo proporciona los datos como bytes FBX.
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": "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: 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 GLB o FBX que contiene el modelo 3D generado, con el formato determinado por lo que produce Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL que apuntan 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 reutilizable de Tripo que identifica el modelo generado para rig o rig-check, lo que permite realizar esas operaciones sin volver a cargar un modelo.

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/tripo3d/h3.1/image-to-3d.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt