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 800 caracteres.

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

Valores disponíveis:

• standard: Geração de malha 3D regular de alta definição.
• 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 utilizar smart-topology em alternativa.

ID do modelo a utilizar. 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 (predefinição): o modelo Smart Topology — topology mais limpa, partes separadas nativamente, resultado em triângulos e uma contagem de faces que pode definir com target_polycount.

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

Controla se a fase de remesh é ativada. Para o modelo de mais alta qualidade, recomendamos definir should_remesh como false.

Número alvo de polígonos (faces) no resultado. A contagem real pode divergir do alvo dependendo da geometria.

target_polycount produz efeito em dois casos independentes:

• Remesh — com should_remesh: true num modelo standard. A malha é submetida a remesh (decimada) para aproximadamente esta contagem. Intervalo de 100 a 300 000, predefinição 30 000. Se decimation_mode estiver definido, tem prioridade e target_polycount é ignorado.
• Smart Topology — com model_type: smart-topology e ai_model: meshy-t2. O modelo é gerado diretamente com esta contagem de faces; não é executado nenhum remesh e should_remesh não é necessário. Intervalo de 100 a 15 000, predefinição 4 000.

Obsoleto. 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.

Especifica 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): Não é aplicada nenhuma pose específica.

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

Não suportado pelo Meshy-6. Os pedidos que utilizem o 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 à procura de conteúdo potencialmente prejudicial. Se for detetado conteúdo prejudicial, a tarefa não avançará 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 também renderiza uma versão com fundo transparente (RGBA) da pré-visualização e devolve-a como alpha_thumbnail_url na resposta GET. O campo existente thumbnail_url 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 assumirá bottom por predefinição, exceto se origin_at for explicitamente definido.

O pedido foi inaceitável. Causas comuns:

• Parâmetro em falta: Falta um parâmetro obrigatório (por exemplo, prompt, mode).
• 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 realizar 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 indicada deve ser SUCCEEDED.

Gera mapas PBR (metallic, roughness, normal) além da cor base. Um emission map também é incluído quando ai_model é meshy-6, exceto em texture_resolution: 8k (não é produzido nenhum emission map). O meshy-7 (e latest) não produz um emission map.

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

Utilize texture_resolution em vez disto — equivalente a texture_resolution: "4k". Quando ambos estão definidos, texture_resolution tem prioridade.

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

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 publicamente acessível: Um URL 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 utilizar 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 à procura de 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 rastreados.

Remove reflexos 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 ficheiro 3D 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 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á, por defeito, bottom, a menos que origin_at seja explicitamente definido.

O pedido foi 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 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.

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 é 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 único da tarefa de Texto para 3D a transmitir.

Identificador único da tarefa. Embora utilizemos um UUID ordenável por k (k-sortable) para os ids de tarefa como detalhe de implementação, não deve fazer nenhuma suposição sobre o formato do id.

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

URL transferível para o ficheiro do 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 utilizado para criar a tarefa.

Mantido por motivos de compatibilidade retroativa. Este campo não tem qualquer impacto funcional nos modelos gerados.

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

Mantido por motivos de compatibilidade retroativa. Este campo não tem qualquer impacto funcional nos modelos gerados.

Prompt de texto adicional fornecido para orientar o processo de texturização durante a etapa refine.

Reflete o valor de ultra_mode com que a tarefa preview foi criada. Apenas presente para tarefas preview do meshy-7 (ou latest) que definam explicitamente ultra_mode; caso contrário, é omitido.

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

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

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

Progresso da tarefa. Se a tarefa ainda não tiver começado, esta propriedade será 0. Assim que a tarefa for concluída com sucesso, passará a ser 100.

Carimbo de data/hora de quando a tarefa foi iniciada, em milissegundos. Se a tarefa ainda não tiver começado, 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 terminado, esta propriedade será 0.

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

Uma matriz de objetos de URL de textura gerados a partir da tarefa. Normalmente, esta 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).