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 representa. 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 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 ser usado. 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): use meshy-7.1 em vez disso.

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

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

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

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

Use 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 mais alta qualidade, recomendamos definir should_remesh como false.

Número desejado de polígonos (faces) na saída. A contagem real pode divergir do valor desejado dependendo da geometria.

target_polycount tem efeito em dois casos independentes:

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

Especifica o pose mode 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. Define se o modelo deve ser gerado 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 definido como true, o conteúdo de entrada será automaticamente verificado quanto a conteúdo potencialmente prejudicial. Se conteúdo prejudicial for detectado, a tarefa não avançará para a geração.

O texto de prompt será verificado.

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 também renderiza uma versão com fundo transparente (RGBA) do preview e a retorna como alpha_thumbnail_url na resposta do GET. O campo thumbnail_url existente permanece inalterado.

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

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

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

Créditos insuficientes para realizar esta tarefa.

Você excedeu seu limite de taxa.

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

O id da tarefa de preview correspondente.

O status da tarefa de preview informada 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 (nenhum mapa de emissão é produzido). meshy-6-lite, meshy-7.1 e latest não produzem mapa de emissão.

Resolução da textura de cor base. Uma entre 2k (2048×2048), 4k (4096×4096) ou 8k (8192×8192). Resoluções mais altas capturam mais detalhes 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 orientar o processo de texturização. Máximo de 800 caracteres.

Forneça uma imagem 2d para orientar o processo de texturização. No momento, oferecemos suporte aos formatos .jpg, .jpeg e .png.

Há duas maneiras de fornecer a imagem:

• URL publicamente acessível: uma URL que pode ser acessada pela 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 ser usado 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 preview, o que mantém um preview e 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 verificado em busca de conteúdo potencialmente prejudicial. Se conteúdo prejudicial 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 verificados.

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 arquivo 3D incluir na saída. Somente 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 com fundo transparente (RGBA) do preview e a retorna como alpha_thumbnail_url na resposta GET. O campo thumbnail_url existente permanece inalterado.

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

A solicitação 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 preview ainda não foi concluída com sucesso.
• Incompatibilidade de modelo: o modelo de IA da tarefa de preview é incompatível com o modelo de refine solicitado.

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

Créditos insuficientes para realizar esta tarefa.

A tarefa de preview especificada por preview_task_id não foi encontrada.

Você excedeu seu limite de taxa.

Identificador único da 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 é 100 itens.

Campo pelo qual ordenar.

Valores disponíveis:

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

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

Identificador único da tarefa. Embora usemos um UUID k-sortable para ids de tarefa como detalhe de implementação, você não deve fazer suposições sobre o formato do id.

Tipo da tarefa Text to 3D. Os valores possíveis são text-to-3d-preview para tarefas do estágio preview e text-to-3d-refine para tarefas do estágio refine.

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 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 preview. 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 o estágio refine.

Obsoleto; consulte geometry_resolution em vez disso.

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

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

URL para download da imagem de miniatura do arquivo do 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, esta propriedade será 0. Uma vez que a tarefa tenha sido concluída com sucesso, ela 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 finalizada, em milissegundos. Se a tarefa ainda não foi finalizada, esta propriedade será 0.

Status da tarefa. Os valores possíveis são um dos seguintes: PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

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

A contagem de tarefas precedentes.

Detalhes de erro para tarefas com falha. Consulte 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).