Avançar para o conteúdo

Meshy 6 · Text to 3D

Integrar

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

Este pedido: 0,80 $ 800 créditos da API · ≈ 86,06 ₽ Executar nesta página

Obter chave de API
Meshy Texto para 3D #text-to-3d

Gerador de malhas de texto em 3D com modos de pré-visualização ou texturizado, PBR, rigging e animação opcionais

Meshy · 3D

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório 88 / 600

Descrição do objeto a representar como modelo 3D, limitada a 600 caracteres.

Avançado texture_prompt · texture_image_url · mode · model_type · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_rigging · enable_animation · enable_safety_checker
0 / 600

Orienta a texturização com um prompt de texto adicional no modo 'full'; os outros modos não o utilizam.

Largue um ficheiro ou

Imagem de referência 2D para geração de texturas, aplicada apenas no modo 'full'.

mode predefinição full

Modo de geração: 'preview' produz geometria sem texturas, enquanto 'full' produz um modelo texturizado combinando preview e refine.

model_type predefinição standard

Modo de malha 3D: escolha 'lowpoly' para um resultado low-poly otimizado para polígonos mais limpos; neste modo, o Meshy ignora topology, target_polycount e should_remesh. Para um resultado convencional de elevado detalhe, escolha 'standard', ou escolha 'smart-topology' para utilizar Meshy-T2 durante a etapa de geometria (preview) e obter partes limpas geradas separadamente desde o início.

topology predefinição triangle

Escolha da topologia do modelo entre Triangle, para detalhe geométrico, e Quad, para suavidade da superfície.

symmetry_mode predefinição auto

Definição de simetria aplicada durante a geração do modelo.

pose_mode predefinição

Deixe a string vazia para não especificar a pose do modelo gerado, ou solicite uma pose A com 'a-pose' ou uma pose T com 't-pose'.

predefinição 30000

Objetivo de contagem de polígonos, limitado a 15,000 quando model_type é 'smart-topology'. Omitir o objetivo nesse modo seleciona a predefinição inferior do Meshy, de 4,000.

predefinição 1.7

Forneça uma altura estimada da personagem em metros quando enable_rigging for true; caso contrário, este valor não tem efeito.

predefinição 92

ID da animação predefinida da biblioteca Meshy, com as ações disponíveis listadas em https://docs.meshy.ai/en/api/animation-library. A validação e utilização aplicam-se apenas quando enable_animation é true: valores fora de [0, 696] são rejeitados com um 422 e "Idle" corresponde a `0`.

Reutilize esta seed juntamente com um prompt inalterado para normalmente reproduzir um resultado anterior.

POST /run/meshy/v6/text-to-3d?wait=20 cotação → 0,80 $
# 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/meshy/v6/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre Meshy 6 · Text to 3D

Cria um modelo 3D a partir de um `prompt` de texto com até 600 caracteres. `mode` escolhe geometria sem texturas (`preview`) ou um resultado texturizado (`full`). `model_type` pode ser standard, lowpoly ou smart-topology, e `target_polycount` varia entre 100 e 300000, com a topologia inteligente limitada a 15000. Também pode adicionar mapas PBR, uma pose, rigging humanoide e uma predefinição de animação.

Parâmetros

NomeTipo PredefiniçãoPermitido Descrição
promptobrigatório
Tipostring
≤ 600 caracteres
Descrição do objeto a representar como modelo 3D, limitada a 600 caracteres.
modeopcional
Tipoenum
Predefiniçãofull
previewfull
Modo de geração: 'preview' produz geometria sem texturas, enquanto 'full' produz um modelo texturizado combinando preview e refine.
seedopcional
Tipointeger | null
Reutilize esta seed juntamente com um prompt inalterado para normalmente reproduzir um resultado anterior.
model_typeopcional
Tipoenum
Predefiniçãostandard
standardlowpolysmart-topology
Modo de malha 3D: escolha 'lowpoly' para um resultado low-poly otimizado para polígonos mais limpos; neste modo, o Meshy ignora topology, target_polycount e should_remesh. Para um resultado convencional de elevado detalhe, escolha 'standard', ou escolha 'smart-topology' para utilizar Meshy-T2 durante a etapa de geometria (preview) e obter partes limpas geradas separadamente desde o início.
topologyopcional
Tipoenum
Predefiniçãotriangle
quadtriangle
Escolha da topologia do modelo entre Triangle, para detalhe geométrico, e Quad, para suavidade da superfície.
target_polycountopcional
Tipointeger
Predefinição30000
100 – 300 000
Objetivo de contagem de polígonos, limitado a 15,000 quando model_type é 'smart-topology'. Omitir o objetivo nesse modo seleciona a predefinição inferior do Meshy, de 4,000.
should_remeshopcional
Tipoboolean
Predefiniçãotrue
Ignore a remalhagem e receba a malha triangular em bruto definindo isto como false; caso contrário, ative a fase de remalhagem.
symmetry_modeopcional
Tipoenum
Predefiniçãoauto
offautoon
Definição de simetria aplicada durante a geração do modelo.
enable_pbropcional
Tipoboolean
Predefiniçãofalse
Controla a geração de mapas PBR metálico, roughness e normal juntamente com a cor base.
is_a_t_poseopcional
Tipoboolean
Predefiniçãofalse
Opção de geração em pose T ativada por true; obsoleta e substituída por pose_mode.
pose_modeopcional
Tipoenum
Predefinição
a-poset-pose
Deixe a string vazia para não especificar a pose do modelo gerado, ou solicite uma pose A com 'a-pose' ou uma pose T com 't-pose'.
enable_prompt_expansionopcional
Tipoboolean
Predefiniçãofalse
Permite que um modelo de linguagem de grande escala enriqueça o prompt com detalhes. Ativar esta expansão não altera o significado do prompt.
texture_promptopcional
Tipostring | null
≤ 600 caracteres
Orienta a texturização com um prompt de texto adicional no modo 'full'; os outros modos não o utilizam.
texture_image_urlopcional
Tipourl · image
Imagem de referência 2D para geração de texturas, aplicada apenas no modo 'full'.
enable_riggingopcional
Tipoboolean
Predefiniçãofalse
Rigging humanoide automático, mais eficaz para modelos humanoides cujos membros sejam claramente distinguíveis. Ativá-lo aplica rigging ao modelo gerado e fornece animações básicas de caminhada e corrida.
rigging_height_metersopcional
Tiponumber
Predefinição1.7
> 0
Forneça uma altura estimada da personagem em metros quando enable_rigging for true; caso contrário, este valor não tem efeito.
enable_animationopcional
Tipoboolean
Predefiniçãofalse
Indica se o modelo com rigging recebe uma animação predefinida, o que exige que enable_rigging seja true.
animation_action_idopcional
Tipointeger
Predefinição92
ID da animação predefinida da biblioteca Meshy, com as ações disponíveis listadas em https://docs.meshy.ai/en/api/animation-library. A validação e utilização aplicam-se apenas quando enable_animation é true: valores fora de [0, 696] são rejeitados com um 422 e "Idle" corresponde a `0`.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
Opção de verificação de segurança do pré-processamento: true torna a verificação de segurança da entrada um pré-requisito do processamento.
obrigatório

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v6/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": 800,
    "usd": "0.80",
    "charged": 800,
    "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
animation_glb
object {url, content_type, file_name, file_size} | nullResultado da animação que contém o modelo 3D como GLB; a resposta omite este resultado, exceto quando enable_animation é true.
animation_fbx
object {url, content_type, file_name, file_size} | nullResultado da animação que contém o modelo 3D como FBX; a resposta omite este resultado, exceto quando enable_animation é true.
model_glb
object {url, content_type, file_name, file_size}Ficheiro GLB que contém o objeto 3D gerado.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatura que mostra uma pré-visualização do modelo gerado.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Ligações para o modelo 3D em vários formatos.
texture_urls
array of object {base_color, metallic, normal, roughness}Ficheiros de textura representados como um array de objetos.
seed
integer | nullValor de seed utilizado durante a geração.
prompt
stringPrompt de texto fornecido para a geração.
actual_prompt
string | nullPrompt efetivamente aplicado à geração quando a expansão de prompts estava ativada.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullResultado do rigging fornecido como ficheiro de personagem GLB; ausente da resposta, exceto quando enable_rigging é true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullResultado do rigging fornecido como ficheiro de personagem FBX; ausente da resposta, exceto quando enable_rigging é true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimações básicas de caminhada e corrida, incluídas apenas quando enable_rigging é true.
rig_task_id
string | nullIdentificador da tarefa de rigging; incluído apenas quando enable_rigging é true.

Mais modelos: Texto para 3D

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/meshy/v6/text-to-3d.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt