API de Texto para 3D

Este campo deve ser definido como "preview" ao criar uma tarefa de pré-visualização.

Descreva que tipo de objeto é o modelo 3D. Máximo de 600 caracteres.

Especifique o tipo de Geração de malha 3D.

Valores disponíveis:

• standard: Geração de malha 3D normal de elevado detalhe.
• lowpoly: Gera uma malha low-poly otimizada para polígonos mais limpos.

ID do modelo a utilizar. Valores disponíveis: meshy-5, meshy-6, latest (Meshy 6).

Controla se a fase de Remesh é ativada. Quando definido como false, a API devolve diretamente a malha triangular de maior precisão.

Obsoleto (deprecated). Este parâmetro já não afeta o resultado.

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

Os valores válidos são:

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

Especifique o pose_mode para o modelo gerado.

Valores disponíveis:

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

Utilize pose_mode em vez disso. Se deve gerar o modelo numa pose A/T.

Não suportado pelo Meshy-6. Os pedidos que utilizem Meshy-6 irão ignorar 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 analisado quanto a conteúdo potencialmente prejudicial. Se for detetado conteúdo prejudicial, a tarefa não prosseguirá para a geração.

O texto de prompt será analisado.

Especifica quais os formatos de ficheiro 3D a incluir no resultado. Apenas os formatos solicitados serão gerados e devolvidos, 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) da pré-visualização e devolve-a como alpha_thumbnail_url na resposta GET. O campo thumbnail_url existente permanece inalterado.

Quando definido como true, o serviço utiliza visão por IA para estimar automaticamente a altura real do objeto e redimensionar o modelo em conformidade. A origem será predefinida como bottom, exceto se origin_at for definido explicitamente.

O pedido não era aceitável. Causas comuns:

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

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

Créditos insuficientes para executar esta tarefa.

Excedeu o seu limite de taxa.

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

O id da tarefa de pré-visualização correspondente.

O estado da tarefa de pré-visualização fornecida deve ser SUCCEEDED.

Gera mapas PBR (metálico, rugosidade, normal) além da cor base. Também é incluído um mapa de emissão quando ai_model é meshy-6 ou latest.

Gera a textura de cor base em resolução 4K (4096×4096) para maior detalhe.

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

Forneça uma imagem 2D para orientar o processo de texturização. Atualmente, suportamos os formatos .jpg, .jpeg e .png.

Existem duas formas de fornecer a imagem:

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

ID do modelo a utilizar para refinar. Valores disponíveis: meshy-5, meshy-6, latest (Meshy 6).

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

Tanto o texto de texture_prompt como a imagem de texture_image_url serão analisados.

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

Especifica quais os formatos de ficheiro 3D a incluir na saída. Apenas os formatos solicitados serão gerados e devolvidos, 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 da pré-visualização com fundo transparente (RGBA) e devolve-a como alpha_thumbnail_url na resposta GET. O campo thumbnail_url existente permanece inalterado.

Quando definido como true, o serviço utiliza visão por IA para estimar automaticamente a altura real do objeto e redimensionar o modelo em conformidade. A origem será predefinida como bottom, a menos que origin_at seja definido explicitamente.

O pedido era inaceitável. Causas comuns:

• ID de tarefa inválido: O preview_task_id é inválido ou não existe.
• Tarefa não pronta: A tarefa de pré-visualização ainda não foi bem-sucedida.
• Incompatibilidade de modelo: O modelo de IA da tarefa de pré-visualização é incompatível com o modelo de refinamento solicitado.

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

Créditos insuficientes para executar esta tarefa.

A tarefa de pré-visualização especificada por preview_task_id não foi encontrada.

Excedeu o seu limite de taxa.

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

O ID da tarefa de Texto para 3D a eliminar.

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

Limite do tamanho da página. O máximo permitido é de 50 itens.

Campo pelo qual ordenar.

Valores disponíveis:

• +created_at: Ordenar por hora de criação por ordem crescente.
• -created_at: Ordenar por hora de criação por ordem decrescente.

Identificador único da tarefa de Texto para 3D a transmitir em streaming.

Identificador único da tarefa. Embora usemos um UUID ordenável por k para os ids das tarefas como detalhe de implementação, não deve fazer quaisquer 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 da fase de pré-visualização e text-to-3d-refine para tarefas da fase de aperfeiçoamento.

URL transferível para o ficheiro de modelo 3D texturizado gerado pela Meshy. A propriedade de um formato será omitida se o formato não for gerado, em vez de devolver uma string vazia.

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

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

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

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

prompt de texto adicional fornecido para orientar o processo de texturização durante a fase de aperfeiçoamento.

URL transferível para a imagem de textura que foi usada para orientar o processo de texturização.

URL transferível para a imagem de miniatura do ficheiro de modelo.

URL transferível para 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 transferível para o vídeo de pré-visualização. Será removido numa versão futura.

progress da tarefa. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0. Assim que a tarefa for concluída com sucesso, passará a 100.

Carimbo de data/hora de quando a tarefa foi iniciada, em milissegundos. Se a tarefa ainda não tiver sido 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 estiver concluída, esta propriedade será 0.

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

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

A contagem de tarefas precedentes.

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

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