Texto para 3D API

Este campo deve ser definido como "preview" ao criar uma tarefa de preview.

Descreva que tipo de objeto o modelo 3D representa. Máximo de 800 caracteres.

Especifica o tipo de geração de malha 3D.

Valores disponíveis:

• standard: Geração de malha 3D regular de alto detalhe.
• smart-topology: Escolha o modelo Smart Topology com ai_model (meshy-t2).
• lowpoly (obsoleto): Gera malha low-poly otimizada para polígonos mais limpos. Recomendamos usar smart-topology em vez disso.

ID do modelo a ser usado. Os valores disponíveis dependem de model_type.

Geração standard (model_type: standard):

• meshy-5, meshy-6, meshy-7, latest (Meshy 7)

Geração Smart Topology (model_type: smart-topology):

• meshy-t2 (padrão): o modelo Smart Topology — topology mais limpa, partes naturalmente separadas, saída em triângulos e uma contagem de faces que você pode definir com target_polycount.

Habilita a geração Ultra para geometria de maior fidelidade com detalhes de superfície mais refinados. A geração leva mais tempo e adiciona 5 créditos.

Controla se a fase de remesh deve ser habilitada. Para o modelo de maior qualidade, recomendamos definir should_remesh como false.

Número desejado de polígonos (faces) na saída. A contagem real pode variar em relação ao valor desejado, dependendo da geometria.

target_polycount tem efeito em dois casos independentes:

• Remesh — com should_remesh: true em um modelo standard. A malha é remeshada (decimada) para aproximadamente essa contagem. Intervalo de 100 a 300.000, padrão 30.000. Se decimation_mode estiver definido, ele tem prioridade e target_polycount é ignorado.
• Smart Topology — com model_type: smart-topology e ai_model: meshy-t2. O modelo é gerado diretamente com essa contagem de faces; nenhum remesh é executado e should_remesh não é necessário. Intervalo de 100 a 15.000, padrão 4.000.

Obsoleto. Este parâmetro não afeta mais a saída.

O campo symmetry_mode controla o comportamento de simetria durante o processo de geração do modelo.

Os valores válidos são:

• off: Desabilita a simetria.
• auto: Determina e aplica automaticamente a simetria com base na geometria de entrada.
• on: Impõe simetria durante a geração.

Especifica o pose mode para o modelo gerado.

Valores disponíveis:

• a-pose: Gera o modelo em uma pose A.
• t-pose: Gera o modelo em uma pose T.
• "" (string vazia): Nenhuma pose específica aplicada.

Use pose_mode em vez disso. Define se o modelo deve ser gerado em pose A/T.

Não suportado pelo Meshy-6. Solicitações usando o Meshy-6 ignorarão art_style, e algumas combinações podem causar erros. Valores disponíveis: realistic, sculpture.

Quando definido como true, o conteúdo de entrada será automaticamente verificado quanto a conteúdo potencialmente prejudicial. Se conteúdo prejudicial for detectado, a tarefa não avançará para a geração.

O texto de prompt será verificado.

Especifica quais formatos de arquivo 3D incluir na saída. Apenas os formatos solicitados serão gerados e retornados, o que pode reduzir o tempo de conclusão da tarefa. Quando omitido, todos os formatos suportados são incluídos.

Valores disponíveis: glb, obj, fbx, stl, usdz, 3mf

Quando definido como true, a tarefa renderiza adicionalmente uma versão com fundo transparente (RGBA) do preview e a retorna como alpha_thumbnail_url na resposta do GET. O campo thumbnail_url existente permanece inalterado.

Quando definido como true, o serviço usa visão computacional de IA para estimar automaticamente a altura real do objeto no mundo físico e redimensionar o modelo de acordo. A origem usará bottom como padrão, a menos que origin_at seja explicitamente definido.

A requisição foi rejeitada. Causas comuns:

• Parâmetro ausente: Um parâmetro obrigatório (ex.: prompt, mode) está ausente.
• Parâmetro inválido: art_style não é um dos valores permitidos.
• Prompt muito longo: O prompt excede o limite de caracteres.

A autenticação falhou. Verifique sua chave de API.

Créditos insuficientes para realizar esta tarefa.

Você excedeu seu limite de taxa.

Este campo deve ser definido como "refine" ao criar uma tarefa de refinamento.

O id da tarefa de preview correspondente.

O status da tarefa de preview fornecida deve ser SUCCEEDED.

Gera mapas PBR (metálico, rugosidade, normal) além da cor base. Um mapa de emissão também é incluído quando ai_model é meshy-6, exceto em texture_resolution: 8k (nenhum mapa de emissão é produzido). meshy-7 (e latest) não produz um mapa de emissão.

Resolução da textura de cor base. Uma das opções 2k (2048×2048), 4k (4096×4096) ou 8k (8192×8192). Resoluções mais altas capturam mais detalhes de superfície. Aplica-se apenas ao mode refine.

Use texture_resolution em vez disso — equivalente a texture_resolution: "4k". Quando ambos são definidos, texture_resolution tem precedência.

Forneça um prompt de texto adicional para guiar o processo de texturização. Máximo de 800 caracteres.

Forneça uma imagem 2d para guiar o processo de texturização. Atualmente, oferecemos suporte aos formatos .jpg, .jpeg e .png.

Há duas maneiras de fornecer a imagem:

• URL publicamente acessível: Uma URL que é acessível a partir da internet pública
• Data URI: Um data URI da imagem codificado em base64. Exemplo de um data URI: data:image/jpeg;base64,<your base64-encoded image data>

ID do modelo a ser usado para o refinamento. Valores disponíveis: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

Quando definido como true, o conteúdo de entrada será automaticamente verificado quanto a possível conteúdo prejudicial. Se conteúdo prejudicial for detectado, a tarefa não avançará para a geração.

Tanto o texto de texture_prompt quanto a imagem de texture_image_url serão verificados.

Remove realces e sombras da textura de cor base, produzindo um resultado mais limpo que funciona melhor sob configurações de iluminação personalizadas.

Especifica quais formatos de arquivo 3D incluir na saída. Somente os formatos solicitados serão gerados e retornados, o que pode reduzir o tempo de conclusão da tarefa. Quando omitido, todos os formatos suportados são incluídos.

Valores disponíveis: glb, obj, fbx, stl, usdz, 3mf

Quando definido como true, a tarefa renderiza adicionalmente uma versão com fundo transparente (RGBA) do preview e a retorna como alpha_thumbnail_url na resposta GET. O campo existente thumbnail_url permanece inalterado.

Quando definido como true, o serviço usa visão de IA para estimar automaticamente a altura real do objeto e redimensionar o modelo de acordo. A origem terá como padrão bottom, a menos que origin_at seja explicitamente definido.

A solicitação foi rejeitada. Causas comuns:

• ID de tarefa inválido: O preview_task_id é inválido ou não existe.
• Tarefa não pronta: A tarefa de preview ainda não foi concluída com sucesso.
• Incompatibilidade de modelo: O modelo de IA da tarefa de preview é incompatível com o modelo de refinamento solicitado.

Falha na autenticação. Verifique sua chave de API.

Créditos insuficientes para realizar esta tarefa.

A tarefa de preview especificada por preview_task_id não foi encontrada.

Você excedeu seu limite de taxa.

Identificador único da tarefa de Texto para 3D a ser recuperada.

O ID da tarefa de Texto para 3D a ser excluída.

Número da página para paginação.

Limite de itens por página. O máximo permitido é 50 itens.

Campo pelo qual ordenar.

Valores disponíveis:

• +created_at: Ordenar pelo horário de criação em ordem crescente.
• -created_at: Ordenar pelo horário de criação em ordem decrescente.

Identificador único da tarefa de Texto para 3D a ser transmitida.

Identificador único da tarefa. Embora usemos um UUID k-sortable para os ids de tarefa como detalhe de implementação, você não deve fazer suposições sobre o formato do id.

Tipo da tarefa de Texto para 3D. Os valores possíveis são text-to-3d-preview para tarefas do estágio preview e text-to-3d-refine para tarefas do estágio refine.

URL para download do arquivo de modelo 3D texturizado gerado pela Meshy. A propriedade de um formato será omitida se o formato não for gerado, em vez de retornar uma string vazia.

Este é o prompt não modificado que foi usado para criar a tarefa.

Mantido para compatibilidade retroativa. Este campo não tem impacto funcional nos modelos gerados.

O art_style não modificado que foi usado para criar a tarefa de preview. Não suportado pelo Meshy-6.

Mantido para compatibilidade retroativa. Este campo não tem impacto funcional nos modelos gerados.

Prompt de texto adicional fornecido para orientar o processo de texturização durante o estágio refine.

Reflete o valor de ultra_mode com o qual a tarefa de preview foi criada. Presente apenas para tarefas de preview do meshy-7 (ou latest) que definiram explicitamente ultra_mode; omitido caso contrário.

URL para download da imagem de textura que foi usada para orientar o processo de texturização.

URL para download da imagem em miniatura do arquivo de modelo.

URL para download de uma versão com fundo transparente (RGBA) de thumbnail_url. Presente apenas quando a tarefa foi criada com alpha_thumbnail: true e a pré-visualização transparente foi renderizada com sucesso; caso contrário, este campo é omitido.

URL para download do vídeo de pré-visualização. Será removido em uma versão futura.

Progresso da tarefa. Se a tarefa ainda não foi iniciada, esta propriedade será 0. Assim que a tarefa for concluída com sucesso, ela se tornará 100.

Carimbo de data/hora de quando a tarefa foi iniciada, em milissegundos. Se a tarefa ainda não foi iniciada, esta propriedade será 0.

Carimbo de data/hora de quando a tarefa foi criada, em milissegundos.

Carimbo de data/hora de quando a tarefa foi concluída, em milissegundos. Se a tarefa ainda não foi concluída, esta propriedade será 0.

Status da tarefa. Os valores possíveis são PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Um array de objetos de URL de textura gerados a partir da tarefa. Normalmente isso contém apenas um objeto de URL de textura. Cada URL de textura possui as seguintes propriedades:

A contagem de tarefas precedentes.

Detalhes do erro para tarefas com falha. Consulte Erros para a referência completa do objeto task_error.

O número de créditos consumidos por esta tarefa. Presente quando o status da tarefa é PENDING, IN_PROGRESS ou SUCCEEDED. Retorna 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).