Ir para o conteúdo

Meshy V7 Text to 3D

Integrar

ID do modelo meshy/v7/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/v7/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"

Arquivos como o exemplo: $ 1,20 1.200 créditos de API · ≈ ₽ 129,10 seus arquivos são medidos antes da execução Executar nesta página

Obter chave de API
Meshy Texto para 3D #stylized#transform

Texto para 3D com Meshy 7: modo de pré-visualização ou completo, geometria 2k e opções de PBR, rigging e animação

Meshy · 3D

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório 88 / 600

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

mode padrão full

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

geometry_resolution

Resolução da geometria da malha; as opções Meshy-7 compatíveis são standard e 2k.

Avançado texture_prompt · texture_image_url · 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_safety_checker · ultra_mode
0 / 600

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

Solte um arquivo ou

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

model_type padrão standard

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

topology padrão triangle

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

symmetry_mode padrão auto

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

pose_mode padrã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'.

padrão 30000

Meta de quantidade de polígonos, limitada a 15,000 quando model_type é 'smart-topology'. Omitir a meta nesse modo seleciona o valor padrão inferior do Meshy, 4,000.

padrão 1.7

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

padrão 92

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

Reutilize esta seed junto com um prompt inalterado para geralmente reproduzir um resultado anterior.

POST /run/meshy/v7/text-to-3d?wait=20 cotação → $ 1,20
# 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/v7/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 esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre Meshy V7 Text to 3D

Gera um modelo 3D a partir de um `prompt` de até 600 caracteres, com `enable_prompt_expansion` opcional. `mode` retorna geometria sem textura ou um modelo texturizado. Escolha standard, lowpoly ou smart-topology via `model_type`, defina `target_polycount` de 100 a 300000 e selecione `geometry_resolution` standard ou 2k. Rigging e predefinições de animação podem ser adicionados a personagens humanoides.

Parâmetros

NomeTipo PadrãoPermitido Descrição
promptobrigatório
Tipostring
≤ 600 caracteres
Descrição do objeto a representar como modelo 3D, limitada a 600 caracteres.
modeopcional
Tipoenum
Padrã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 junto com um prompt inalterado para geralmente reproduzir um resultado anterior.
model_typeopcional
Tipoenum
Padrãostandard
standardlowpolysmart-topology
Modo de malha 3D: escolha 'lowpoly' para um resultado low-poly otimizado para polígonos mais limpos; nesse modo, o Meshy ignora topology, target_polycount e should_remesh. Para um resultado convencional de alto detalhe, escolha 'standard', ou escolha 'smart-topology' para usar Meshy-T2 durante a etapa de geometria (preview) e obter partes limpas geradas separadamente desde o início.
topologyopcional
Tipoenum
Padrãotriangle
quadtriangle
Escolha da topologia do modelo entre Triangle, para detalhes geométricos, e Quad, para suavidade da superfície.
target_polycountopcional
Tipointeger
Padrão30000
100 – 300.000
Meta de quantidade de polígonos, limitada a 15,000 quando model_type é 'smart-topology'. Omitir a meta nesse modo seleciona o valor padrão inferior do Meshy, 4,000.
should_remeshopcional
Tipoboolean
Padrãotrue
Ignore a remalhagem e receba a malha triangular bruta definindo isto como false; caso contrário, ative a etapa de remalhagem.
symmetry_modeopcional
Tipoenum
Padrãoauto
offautoon
Configuração de simetria aplicada durante a geração do modelo.
enable_pbropcional
Tipoboolean
Padrãofalse
Controla a geração de mapas PBR metálico, rugosidade e normal juntamente com a cor base.
is_a_t_poseopcional
Tipoboolean
Padrãofalse
Opção de geração em pose T ativada por true; obsoleta e substituída por pose_mode.
pose_modeopcional
Tipoenum
Padrã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
Padrãofalse
Permite que um modelo de linguagem grande enriqueça o prompt com detalhes. Ativar essa expansão não altera o significado do prompt.
texture_promptopcional
Tipostring | null
≤ 600 caracteres
Oriente 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 somente no modo 'full'.
enable_riggingopcional
Tipoboolean
Padrã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
Padrão1.7
> 0
Forneça uma altura estimada do personagem em metros quando enable_rigging for true; caso contrário, esse valor não tem efeito.
enable_animationopcional
Tipoboolean
Padrãofalse
Indica se o modelo com rigging recebe uma animação predefinida, o que exige que enable_rigging seja true.
animation_action_idopcional
Tipointeger
Padrão92
ID de predefinição de animação da biblioteca Meshy, com ações disponíveis em https://docs.meshy.ai/en/api/animation-library. A validação e o uso aplicam-se somente quando enable_animation é true: valores fora de [0, 696] são rejeitados com 422, e "Idle" corresponde a `0`.
enable_safety_checkeropcional
Tipoboolean
Padrã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 para o processamento.
geometry_resolutionopcional
Tipoenum
standard2k
Resolução da geometria da malha; as opções Meshy-7 compatíveis são standard e 2k.
ultra_modeopcional
Tipoboolean
Padrãofalse
Opção obsoleta substituída por geometry_resolution, que prevalece se ambas forem fornecidas; use geometry_resolution='2k' em vez disso.
obrigatório

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
animation_glb
object {url, content_type, file_name, file_size} | nullResultado da animação contendo o modelo 3D como GLB; a resposta omite esse resultado, a menos que enable_animation seja true.
animation_fbx
object {url, content_type, file_name, file_size} | nullResultado da animação contendo o modelo 3D como FBX; a resposta omite esse resultado, a menos que enable_animation seja true.
model_glb
object {url, content_type, file_name, file_size}Arquivo GLB contendo o objeto 3D gerado.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatura mostrando uma prévia do modelo gerado.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Links para o modelo 3D em vários formatos.
texture_urls
array of object {base_color, metallic, normal, roughness}Arquivos de textura representados como um array de objetos.
seed
integer | nullValor de seed usado 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 prompt estava ativada.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullResultado do rigging entregue como arquivo de personagem GLB; ausente da resposta, a menos que enable_rigging seja true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullResultado do rigging entregue como arquivo de personagem FBX; ausente da resposta, a menos que enable_rigging seja 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 somente se enable_rigging for true.
rig_task_id
string | nullIdentificador da tarefa de rigging; incluído somente se enable_rigging for true.

Mais modelos: Texto para 3D

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