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.

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

Valores disponíveis:

• standard: Geração regular de malha 3D de alto 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 utilizar. Os valores disponíveis dependem de model_type.

Geração standard (model_type: standard):

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (obsoleto): utilize meshy-7.1 em vez disso.

Geração Smart Topology (model_type: smart-topology):

• meshy-t2 (predefinição): o modelo Smart Topology — topology mais limpa, partes separadas nativamente, saída em triângulos, e uma contagem de faces que pode definir com target_polycount.

Passagem de geração de geometria. 2k executa a passagem Ultra a 2048³; 4k executa-a a 4096³ para o detalhe de superfície mais fino.

Valores disponíveis: standard, 2k, 4k

Utilize geometry_resolution em vez disso. ultra_mode: true é equivalente a geometry_resolution: "2k".

Controla se a fase de remesh deve ser ativada. Para o modelo de maior 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, 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; nenhum remesh é executado 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 a saída.

O campo symmetry_mode controla o comportamento da 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 mode 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.

Utilize pose_mode em vez disso. 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 em busca 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 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) 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 de IA para estimar automaticamente a altura real do objeto e redimensionar o modelo em conformidade. A origem terá como predefinição bottom, a menos que origin_at seja 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.
• Modelo não suportado para low poly: ai_model: "meshy-6-lite" não suporta model_type: "lowpoly".
• Modelo não suportado para Ultra: geometry_resolution requer meshy-7.1 ou latest.

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 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-6-lite, meshy-7.1 e latest não produzem um 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 disso — equivalente 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 800 caracteres.

Forneça uma imagem 2D para guiar 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 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 refine.

Valores disponíveis:

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (obsoleto): use meshy-7.1 em vez disso.

Omita este parâmetro para herdar o modelo usado 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 em busca 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 analisados.

Remove realces 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 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 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 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 em conformidade. A origem terá como valor predefinido bottom, a menos que origin_at seja definido explicitamente.

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 concluída com 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 é 100 itens.

Campo pelo qual 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 da tarefa Texto para 3D a transmitir.

Identificador único da tarefa. Embora utilizemos um UUID ordenável por k como detalhe de implementação para os ids das tarefas, 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 do estágio de preview e text-to-3d-refine para tarefas do estágio refine.

URL para descarregar o ficheiro do modelo 3D texturizado gerado pela Meshy. A propriedade de um formato será omitida se esse 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 qualquer 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 qualquer impacto funcional nos modelos gerados.

Prompt de texto adicional fornecido para orientar o processo de texturização durante o estágio refine.

Obsoleto; consulte antes geometry_resolution.

O nível Ultra em que a tarefa de preview foi executada (2k ou 4k); omitido para standard.

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

URL para descarregar a imagem em miniatura do ficheiro do modelo.

URL para descarregar 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 para descarregar 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.

Um array de objetos de URL de textura gerados pela tarefa. Normalmente, 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).