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 regular com alto nível de detalhes.
• lowpoly: Gera uma malha low-poly otimizada para polígonos mais limpos.

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

Controla se a fase de Remesh deve ser ativada. Quando definido como false, a API retornará diretamente a malha triangular de maior precisão.

Obsoleto (deprecated). 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: 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 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. Indica se o modelo deve ser gerado em uma pose A/T.

Não compatível com Meshy-6. Solicitações usando 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 prosseguirá para a geração.

O texto de prompt será verificado.

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 compatíveis 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 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 por IA para estimar automaticamente a altura real do objeto e redimensionar o modelo adequadamente. A origem será definida por padrão como bottom, a menos que origin_at seja definido explicitamente.

A solicitação era inaceitável. Causas comuns:

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

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

Créditos insuficientes para executar 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 pré-visualização correspondente.

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

Gere 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 ou latest.

Gere a textura de cor base em resolução 4K (4096×4096) para maior nível de 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 oferecemos suporte aos formatos .jpg, .jpeg e .png.

Há duas maneiras de fornecer a imagem:

• URL acessível publicamente: Uma URL acessível pela internet pública
• Data URI: Uma Data URI da imagem codificada em base64. Exemplo de uma 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, latest (Meshy 6).

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 prosseguirá 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 compatíveis 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 a retorna como alpha_thumbnail_url na resposta GET. O campo thumbnail_url existente permanece inalterado.

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

A solicitação 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 concluída com sucesso.
• 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 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.

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 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 em ordem crescente.
• -created_at: Ordenar por hora de criação em ordem decrescente.

Identificador exclusivo da tarefa de Texto para 3D a ser transmitida em stream.

Identificador exclusivo da tarefa. Embora usemos um UUID k-sortable para ids de tarefas como detalhe de implementação, você não deve fazer nenhuma suposição 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 etapa de pré-visualização e text-to-3d-refine para tarefas da etapa de refinamento.

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 com versões anteriores. 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 compatível com Meshy-6.

Mantido para compatibilidade com versões anteriores. Este campo não tem impacto funcional nos modelos gerados.

prompt de texto adicional fornecido para orientar o processo de texturização durante a etapa de refinamento.

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

URL para download da imagem de 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.

progress da tarefa. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0. Quando a tarefa for concluída com sucesso, isto se tornará 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 tiver sido concluída, esta propriedade será 0.

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

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

A contagem de tarefas anteriores.

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 (créditos são reembolsados em caso de falha).