Ir al contenido

Meshy 7.1 Text to 3D

Integrar

Id del modelo meshy/v7.1/text-to-3d
# 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/meshy/v7.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

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

Archivos como el ejemplo: 1,20 $ 1200 créditos de API tus archivos se miden antes de la ejecución Ejecutar en esta página

Obtener clave de API
Meshy Texto a 3D Salida 4K #3d#text-to-3d#textures#pbr

Conversión de texto a 3D de Meshy 7.1 con modos de previsualización o completo y resolución geométrica de hasta 4k

Meshy · 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 88 / 600

Descripción del objeto que se representará como modelo 3D, limitada a 600 caracteres.

mode predeterminado full

Modo de generación: 'preview' produce geometría sin texturas, mientras que 'full' produce un modelo texturizado combinando preview y refine.

Avanzado texture_prompt · texture_image_url · model_type · topology · symmetry_mode · pose_mode · geometry_resolution · target_polycount · rigging_height_meters · animation_action_id · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_safety_checker · ultra_mode
0 / 600

Guía el texturizado con un prompt de texto adicional en el modo 'full'; los demás modos no lo utilizan.

Suelta un archivo o

Imagen de referencia 2D para la generación de texturas, aplicada solo en el modo 'full'.

model_type predeterminado standard

Modo de malla 3D: elige 'lowpoly' para obtener un resultado de pocos polígonos optimizado para polígonos más limpios; en este modo Meshy ignora topology, target_polycount y should_remesh. Para un resultado convencional de gran detalle, elige 'standard', o elige 'smart-topology' para usar Meshy-T2 durante la etapa de geometría (preview) y obtener piezas limpias generadas por separado desde el principio.

topology predeterminado triangle

Elección de topología del modelo entre Triangle para el detalle geométrico y Quad para la suavidad de la superficie.

symmetry_mode predeterminado auto

Configuración de simetría aplicada durante la generación del modelo.

pose_mode predeterminado

Deja la cadena vacía para no especificar la pose del modelo generado, o solicita una pose A con 'a-pose' o una pose T con 't-pose'.

geometry_resolution

Resolución de la geometría; 4k requiere Meshy-7.1.

predeterminado 30000

Objetivo de cantidad de polígonos, limitado a 15,000 cuando model_type es 'smart-topology'. Omitir el objetivo en ese modo selecciona el valor predeterminado inferior de Meshy: 4,000.

predeterminado 1.7

Proporciona una altura estimada del personaje en metros cuando enable_rigging sea true; de lo contrario, este valor no tiene efecto.

predeterminado 92

ID de la animación preestablecida de la biblioteca de Meshy, con las acciones disponibles enumeradas en https://docs.meshy.ai/en/api/animation-library. La validación y el uso solo se aplican cuando enable_animation es true: los valores fuera de [0, 696] se rechazan con un 422 y "Idle" corresponde a `0`.

Reutiliza esta semilla junto con un prompt sin cambios para reproducir normalmente un resultado anterior.

POST /run/meshy/v7.1/text-to-3d?wait=20 cotización → 1,20 $
# 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/meshy/v7.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 Meshy 7.1 Text to 3D

Genera un modelo 3D a partir de un `prompt` de texto de hasta 600 caracteres. `mode` devuelve geometría sin texturas o un resultado texturizado, y `geometry_resolution` permite standard, 2k o 4k. Elige standard, lowpoly o smart-topology con `model_type`, establece `target_polycount` de 100 a 300000 y habilita opcionalmente PBR, expansión del prompt, rig y animación.

Parámetros

NombreTipo PredeterminadoPermitido Descripción
promptobligatorio
Tipostring
≤ 600 caracteres
Descripción del objeto que se representará como modelo 3D, limitada a 600 caracteres.
modeopcional
Tipoenum
Predeterminadofull
previewfull
Modo de generación: 'preview' produce geometría sin texturas, mientras que 'full' produce un modelo texturizado combinando preview y refine.
seedopcional
Tipointeger | null
Reutiliza esta semilla junto con un prompt sin cambios para reproducir normalmente un resultado anterior.
model_typeopcional
Tipoenum
Predeterminadostandard
standardlowpolysmart-topology
Modo de malla 3D: elige 'lowpoly' para obtener un resultado de pocos polígonos optimizado para polígonos más limpios; en este modo Meshy ignora topology, target_polycount y should_remesh. Para un resultado convencional de gran detalle, elige 'standard', o elige 'smart-topology' para usar Meshy-T2 durante la etapa de geometría (preview) y obtener piezas limpias generadas por separado desde el principio.
topologyopcional
Tipoenum
Predeterminadotriangle
quadtriangle
Elección de topología del modelo entre Triangle para el detalle geométrico y Quad para la suavidad de la superficie.
target_polycountopcional
Tipointeger
Predeterminado30000
100 – 300.000
Objetivo de cantidad de polígonos, limitado a 15,000 cuando model_type es 'smart-topology'. Omitir el objetivo en ese modo selecciona el valor predeterminado inferior de Meshy: 4,000.
should_remeshopcional
Tipoboolean
Predeterminadotrue
Omite el remallado y recibe la malla triangular sin procesar al establecerlo en false; de lo contrario, activa la fase de remallado.
symmetry_modeopcional
Tipoenum
Predeterminadoauto
offautoon
Configuración de simetría aplicada durante la generación del modelo.
enable_pbropcional
Tipoboolean
Predeterminadofalse
Controla la generación de mapas PBR metálico, rugosidad y normales junto al color base.
is_a_t_poseopcional
Tipoboolean
Predeterminadofalse
Interruptor de generación en pose T activado por true; obsoleto en favor de pose_mode.
pose_modeopcional
Tipoenum
Predeterminado
a-poset-pose
Deja la cadena vacía para no especificar la pose del modelo generado, o solicita una pose A con 'a-pose' o una pose T con 't-pose'.
enable_prompt_expansionopcional
Tipoboolean
Predeterminadofalse
Permite que un modelo de lenguaje grande enriquezca el prompt con detalles. Activar esta expansión no cambia el significado del prompt.
texture_promptopcional
Tipostring | null
≤ 600 caracteres
Guía el texturizado con un prompt de texto adicional en el modo 'full'; los demás modos no lo utilizan.
texture_image_urlopcional
Tipourl · image
Imagen de referencia 2D para la generación de texturas, aplicada solo en el modo 'full'.
enable_riggingopcional
Tipoboolean
Predeterminadofalse
Rigging humanoide automático, más eficaz para modelos humanoides cuyas extremidades se distinguen claramente. Al activarlo, aplica rigging al modelo generado y proporciona animaciones básicas de caminar y correr.
rigging_height_metersopcional
Tiponumber
Predeterminado1.7
> 0
Proporciona una altura estimada del personaje en metros cuando enable_rigging sea true; de lo contrario, este valor no tiene efecto.
enable_animationopcional
Tipoboolean
Predeterminadofalse
Indica si el modelo con rigging recibe una animación preestablecida, lo que requiere que enable_rigging sea true.
animation_action_idopcional
Tipointeger
Predeterminado92
ID de la animación preestablecida de la biblioteca de Meshy, con las acciones disponibles enumeradas en https://docs.meshy.ai/en/api/animation-library. La validación y el uso solo se aplican cuando enable_animation es true: los valores fuera de [0, 696] se rechazan con un 422 y "Idle" corresponde a `0`.
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
Interruptor de comprobación de seguridad del preprocesamiento: true hace que una comprobación de seguridad de la entrada sea un requisito previo al procesamiento.
geometry_resolutionopcional
Tipoenum
standard2k4k
Resolución de la geometría; 4k requiere Meshy-7.1.
ultra_modeopcional
Tipoboolean
Predeterminadofalse
Opción obsoleta reemplazada por geometry_resolution, que prevalece si se proporcionan ambas; usa geometry_resolution='2k' en su lugar.
obligatorio

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": "meshy/v7.1/text-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": 1200,
    "usd": "1.20",
    "charged": 1200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "animation_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
    },
    "animation_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
    },
    "model_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
    },
    "thumbnail": {
      "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
      },
      "obj": {
        "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
      },
      "usdz": {
        "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
      },
      "blend": {
        "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
      },
      "stl": {
        "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
      }
    },
    "texture_urls": [
      {
        "base_color": {
          "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
        },
        "metallic": {
          "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
        },
        "normal": {
          "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
        },
        "roughness": {
          "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,
    "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
    "actual_prompt": "string",
    "rigged_character_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
    },
    "rigged_character_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
    },
    "basic_animations": {
      "walking_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
      },
      "walking_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
      },
      "walking_armature_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
      },
      "running_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
      },
      "running_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
      },
      "running_armature_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
      }
    },
    "rig_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.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
animation_glb
object {url, content_type, file_name, file_size} | nullResultado de animación que contiene el modelo 3D como GLB; la respuesta omite este resultado a menos que enable_animation sea true.
animation_fbx
object {url, content_type, file_name, file_size} | nullResultado de animación que contiene el modelo 3D como FBX; la respuesta omite este resultado a menos que enable_animation sea true.
model_glb
object {url, content_type, file_name, file_size}Archivo GLB que contiene el objeto 3D generado.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatura que muestra una vista previa del modelo generado.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Enlaces al modelo 3D en varios formatos.
texture_urls
array of object {base_color, metallic, normal, roughness}Archivos de textura representados como un array de objetos.
seed
integer | nullValor de semilla utilizado durante la generación.
prompt
stringPrompt de texto proporcionado para la generación.
actual_prompt
string | nullPrompt aplicado realmente a la generación cuando se activó la expansión del prompt.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullResultado del rigging entregado como archivo de personaje GLB; ausente de la respuesta a menos que enable_rigging sea true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullResultado del rigging entregado como archivo de personaje FBX; ausente de la respuesta a menos que enable_rigging sea true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimaciones básicas de caminar y correr, incluidas solo si enable_rigging es true.
rig_task_id
string | nullIdentificador de la tarea de rigging; incluido solo si enable_rigging es true.

Más modelos: Texto a 3D

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