API de Texto para 3D

Este campo deve ser configurado 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 de alta precisão regular.
• lowpoly: Gera 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. Para o modelo de mais alta qualidade, recomendamos configurar should_remesh para false.

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: Desativa a simetria.
• auto: Determina e aplica automaticamente a simetria com base na geometria de entrada.
• on: Impõe a simetria durante a geração.

Especifique o modo de pose 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. Se deve gerar o modelo em uma pose A/T.

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

Quando configurado como true, o conteúdo de entrada será automaticamente filtrado para detectar potencialmente conteúdo nocivo. Se conteúdo nocivo for detectado, a tarefa não prosseguirá para a geração.

O texto do prompt será filtrado.

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 configurada 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 configurada como true, o serviço usa visão AI para estimar automaticamente a altura real do objeto e redimensiona o modelo de acordo. A origem será padrão para bottom a menos que origin_at seja configurado explicitamente.

A solicitação foi 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 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 configurado 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.

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

Resolução da textura de cor base. Um de 2k (2048×2048), 4k (4096×4096) ou 8k (8192×8192). Resoluções mais altas capturam mais detalhes de superfície. Só se aplica ao modo refine.

Use texture_resolution em vez disso — equivale 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 600 caracteres.

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

Existem duas maneiras de fornecer a imagem:

• URL acessível publicamente: Um URL que é acessível na internet pública
• Data URI: Um Data URI codificado em base64 da imagem. Exemplo de um Data URI: data:image/jpeg;base64,<seus dados de imagem codificados em base64>

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

Quando configurado como true, o conteúdo de entrada será automaticamente filtrado para detectar potencialmente conteúdo nocivo. Se conteúdo nocivo 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 filtrados.

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

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 configurada 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 configurada como true, o serviço usa visão AI para estimar automaticamente a altura real do objeto e redimensiona o modelo de acordo. A origem será padrão para bottom a menos que origin_at seja configurado explicitamente.

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

• ID da tarefa inválido: O preview_task_id é inválido ou não existe.
• Tarefa não está pronta: A tarefa de pré-visualização ainda não foi bem-sucedida.
• Incompatibilidade de modelo: O AI model 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 realizar 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 para a 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 é 50 itens.

Campo para ordenar por.

Valores disponíveis:

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

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

Identificador único para a tarefa. Enquanto usamos um UUID k-sortable para IDs de tarefa como o detalhe de implementação, você não deve fazer suposições sobre o formato do ID.

Tipo da tarefa de Texto para 3D. Valores possíveis são text-to-3d-preview para tarefas de estágio de pré-visualização e text-to-3d-refine para tarefas de estágio de refinamento.

URL para download do arquivo de modelo 3D texturizado gerado pelo Meshy. A propriedade para 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 pré-visualização. 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 guiar o processo de texturização durante a etapa de refinamento.

URL para download da imagem de textura que foi usada para guiar 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, essa propriedade será 0. Uma vez que a tarefa tenha sido bem-sucedida, isso se tornará 100.

Carimbo de data/hora de quando a tarefa foi iniciada, em milissegundos. Se a tarefa ainda não foi iniciada, essa 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 finalizada, essa propriedade será 0.

Status da tarefa. Valores possíveis são um dos PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

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

A contagem de tarefas precedentes.

Detalhes do erro para tarefas falhadas. Veja 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).