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 regular de malha 3D de alta 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 usar. Os valores disponíveis dependem de model_type.

Geração padrão (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 — geometria mais limpa, partes separadas nativamente, saída em triângulo, e uma contagem de faces que pode ser definida com target_polycount.

Ativa a geração Ultra para uma geometria de alta fidelidade com maior detalhe de superfície. A geração demora mais tempo e consome 5 créditos.

Controla se deve habilitar a fase de Remesh. Para o modelo de mais alta qualidade, recomendamos definir should_remesh como false.

Número alvo de polígonos (faces) na saída. A contagem real pode desviar-se do alvo, dependendo da geometria.

target_polycount tem efeito em dois casos independentes:

• Remesh — com should_remesh: true num modelo standard. A malha é remeshed (decimada) para aproximadamente esta contagem. Intervalo de 100 a 300.000, padrão 30.000. Se decimation_mode for definido, ele tem prioridade e target_polycount é ignorado.
• Smart Topology — com model_type: smart-topology e ai_model: meshy-t2. O modelo é gerado diretamente nesta 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: 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 modo de pose para o modelo gerado.

Valores disponíveis:

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

Use pose_mode em vez disso. Indica se deve gerar o modelo numa pose A/T.

Não suportado por Meshy-6. As solicitações que usam 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 rastreado para conteúdo potencialmente prejudicial. Se for detectado conteúdo prejudicial, a tarefa não prosseguirá para geração.

O texto do prompt será rastreado.

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 de fundo transparente (RGBA) da pré-visualização e retorna-a como alpha_thumbnail_url na resposta GET. O campo thumbnail_url existente não é alterado.

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

O pedido era inaceitá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 muito longo: O prompt excede o limite de caracteres.

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

Créditos insuficientes para realizar esta tarefa.

Você 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 status da tarefa de pré-visualização fornecida deve ser SUCCEEDED.

Gere 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, 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 de textura de cor base. Uma de 2k (2048×2048), 4k (4096×4096), ou 8k (8192×8192). Resoluções mais altas capturam mais detalhes da superfície. Aplica-se apenas ao modo refine.

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

Forneça um texto prompt 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 formatos .jpg, .jpeg, e .png.

Existem duas maneiras de fornecer a imagem:

• URL acessível publicamente: Um URL 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,<your base64-encoded image data>

ID do modelo a usar 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 rastreado para conteúdo potencialmente prejudicial. Se for detectado conteúdo prejudicial, a tarefa não prosseguirá para geração.

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

Remove reflexos e sombras da textura da 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. 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 de fundo transparente (RGBA) da pré-visualização e retorna-a como alpha_thumbnail_url na resposta GET. O campo thumbnail_url existente não é alterado.

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

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.

Falha na autenticação. Verifique a 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 o seu limite de taxa.

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

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

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

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

Campo para ordenar.

Valores disponíveis:

• +created_at: Ordenar por data de criação em ordem ascendente.
• -created_at: Ordenar por data de criação em ordem descendente.

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

Identificador único para a tarefa. Embora usemos um UUID ordenável por K para IDs de tarefa como detalhe de implementação, você não deve fazer nenhuma suposição sobre o formato do ID.

Tipo de tarefa de Texto para 3D. Os valores possíveis são text-to-3d-preview para tarefas de etapa de visualização e text-to-3d-refine para tarefas de 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 suportado pela Meshy-6.

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

Texto prompt adicional fornecido para guiar o processo de texturização durante a etapa de refinamento.

Retorna o valor ultra_mode com a qual a tarefa de pré-visualização foi criada. Apenas presente para tarefas de visualização meshy-7 (ou latest) que definiram explicitamente ultra_mode; omitido caso contrário.

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

URL para download da miniatura do arquivo de modelo.

URL para download de uma versão de fundo transparente (RGBA) de thumbnail_url. Apenas presente 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. 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, 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 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 anteriores.

Detalhes de 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).