API de Texto para 3D

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

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 normal de alta qualidade.
• 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 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 naturalmente separadas, saída 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) na saída. A contagem real pode divergir do alvo consoante a geometria.

target_polycount tem efeito em dois casos independentes:

• Remesh — com should_remesh: true num modelo standard. A malha é reprocessada (decimada) para aproximadamente esta contagem. Intervalo entre 100 e 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 entre 100 e 15.000, predefinição 4.000.

Obsoleto. Este parâmetro já não afeta 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.

Especifica o pose_mode para o modelo gerado.

Valores disponíveis:

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

Use pose_mode em vez deste. Se deve gerar o modelo numa pose A/T.

Não suportado pelo Meshy-6. Pedidos que usem 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 nocivo. Se for detetado conteúdo nocivo, 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 na saída. Apenas os formatos pedidos 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) do preview 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 no mundo real e redimensionar o modelo em conformidade. A origem assumirá por predefinição bottom, a menos que origin_at seja definido explicitamente.

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

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 mapa de emissão também é incluído quando ai_model é meshy-6, exceto em texture_resolution: 8k (não é produzido nenhum mapa de emissão). meshy-7 (e latest) não produz mapa de emissão.

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

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

Forneça um prompt de texto adicional para orientar o processo de texturização. Máximo de 800 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 publicamente acessível: um URL acessível a partir da internet pública
• Data URI: um URI de dados em base64 da imagem. Exemplo de um data URI: data:image/jpeg;base64,<your base64-encoded image data>

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

Omita este parâmetro para herdar o modelo utilizado pela tarefa de pré-visualização, o que mantém uma pré-visualização e o seu refine no mesmo modelo do início ao fim. Passe um valor explícito para substituir essa herança.

Quando definido como true, o conteúdo de entrada será automaticamente analisado quanto a conteúdo potencialmente nocivo. Se for detetado conteúdo nocivo, 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 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 assumirá bottom por predefinição, 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 teve sucesso.
• Incompatibilidade de modelo: o modelo de IA da tarefa de pré-visualização é incompatível com o modelo de refine solicitado.

A autenticação falhou. Por favor, 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 pela hora de criação em ordem ascendente.
• -created_at: Ordenar pela hora de criação em ordem descendente.

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

Identificador único da tarefa. Embora utilizemos um UUID ordenável (k-sortable) 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 preview e text-to-3d-refine para tarefas da fase 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 para compatibilidade com versões anteriores. Este campo não tem impacto funcional nos modelos gerados.

O art_style não modificado que foi utilizado para criar a tarefa de preview. Não suportado pelo 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 fase refine.

Reflete o valor de ultra_mode com que a tarefa de preview foi criada. Apenas presente em tarefas de preview meshy-7 (ou latest) que tenham definido explicitamente ultra_mode; omitido caso contrário.

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 sido iniciada, 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 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.

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