Retexture API

O ID da tarefa Imagem para 3D ou Texto para 3D concluída que deseja retexturizar. Esta tarefa deve ser uma das seguintes: Texto para 3D Preview, Texto para 3D Refine, Imagem para 3D ou Remesh. Além disso, deve ter o estado SUCCEEDED.

Forneça um modelo 3D para a Meshy texturizar. Formatos suportados: .glb, .gltf, .obj, .fbx, .stl.

Tamanho máximo do ficheiro: 400 MB para um URL http ou https, 100 MB para um URI data:.

Um ficheiro GLB, glTF, FBX ou OBJ com mais de 100 MB pode ter no máximo 10.000.000 de faces. As faces são contadas como triângulos: um quadrilátero conta como 2, e uma malha desenhada mais de uma vez conta uma vez por cópia. Acima de 100 MB, um ficheiro FBX deve ser binário FBX 7.1 ou mais recente, e um ficheiro GLB ou glTF não pode usar compressão Draco.

Existem duas formas de fornecer o modelo:

• URL publicamente acessível: Um URL acessível a partir da internet pública.
• Data URI: Um URI de dados codificado em base64 do modelo. Use o MIME type application/octet-stream. Exemplo: data:application/octet-stream;base64,<os seus dados do modelo codificados em base64>.

Descreva o estilo de textura desejado para o objeto usando texto. Máximo de 800 caracteres.

Forneça uma imagem 2D para orientar o processo de texturização. Atualmente suportamos os formatos .jpg, .jpeg, .png e .webp.

Tamanho máximo do ficheiro: 20 MB.

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,<os seus dados da imagem codificados em base64>

Forneça entre 1 e 4 imagens que mostrem o mesmo objeto a partir de diferentes vistas para orientar a texturização. A primeira imagem é a vista principal (frontal); a ordem das restantes vistas (esquerda, trás, direita) não importa.

Cada elemento aceita os mesmos formatos que image_style_url (um URL publicamente acessível ou um data URI em base64, .jpg/.jpeg/.png/.webp).

Tamanho máximo do ficheiro: 20 MB por imagem.

ID do modelo de IA a utilizar para retexturizar. Valores disponíveis: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).

Mantém a disposição UV existente do modelo em vez de gerar uma nova.

• Se estiver a retexturizar um modelo gerado pela Meshy (através de input_task_id, ou de um model_url que aponte para um resultado da Meshy), defina como true para reutilizar a sua disposição UV otimizada.
• Se estiver a retexturizar um modelo de terceiros que carregou, defina como true quando já possuir boas UVs que deseje manter, ou deixe como false para que a Meshy faça o unwrap de novas UVs (melhor para modelos sem um mapeamento UV adequado).

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. meshy-6-lite, meshy-7 e latest não produzem um mapa de emissão.

Resolução da textura de cor base. Um de 2k (2048×2048), 4k (4096×4096), ou 8k (8192×8192). Resoluções mais altas capturam mais detalhe de superfície.

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

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

O pedido foi inaceitável. Causas comuns:

• Parâmetro em falta: Deve ser fornecido model_url ou input_task_id.
• Estilo em falta: Deve ser fornecido um de text_style_prompt, image_style_url ou multiview_image_urls.
• Inputs de estilo em conflito: multiview_image_urls não pode ser combinado com text_style_prompt ou image_style_url.
• Modelo não suportado para multivista: multiview_image_urls requer um ai_model: "meshy-7" explícito.
• Modelo não disponível: ai_model: "meshy-7" e ai_model: "meshy-6-lite" estão a ser disponibilizados progressivamente e podem ainda não estar ativados para a sua conta.
• Tarefa de input inválida: input_task_id deve referir-se a uma tarefa bem-sucedida de um modelo suportado.
• Formato de modelo inválido: model_url aponta para um ficheiro com uma extensão não suportada.
• URL inacessível: Não foi possível transferir model_url, image_style_url ou um elemento de multiview_image_urls.
• Ficheiro de modelo demasiado grande: O ficheiro de model_url excede 400 MB (URL http ou https) ou 100 MB (URI data:).
• Demasiadas faces: O ficheiro de model_url tem mais de 100 MB e mais de 10.000.000 de faces. Reduza o número de faces e envie o ficheiro novamente.
• FBX ASCII acima de 100 MB: O ficheiro de model_url é um FBX ASCII acima de 100 MB. Envie-o como FBX binário ou GLB.
• Ficheiro de modelo ilegível: O ficheiro de model_url tem mais de 100 MB e o seu cabeçalho não pode ser lido, por exemplo um GLB ou glTF comprimido com Draco, ou um FBX binário anterior à versão 7.1.
• Cabeçalho do modelo demasiado complexo: O ficheiro de model_url tem mais de 100 MB e o seu cabeçalho tem demasiadas malhas, nós ou registos para verificar. Reduza o número de objetos no ficheiro e envie-o novamente.
• Imagem demasiado grande: A imagem de image_style_url ou um elemento de multiview_image_urls excede 20 MB.

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

Créditos insuficientes para realizar esta tarefa.

Excedeu o seu limite de taxa.

Identificador único da tarefa de Retexturizar a obter.

O ID da tarefa de retexturização 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 pela hora de criação por ordem crescente.
• -created_at: Ordenar pela hora de criação por ordem decrescente.

Identificador único da tarefa de Retexturização a transmitir.

Identificador único da tarefa. Embora utilizemos um UUID k-sortable para os ids de tarefas como pormenor de implementação, não deve fazer quaisquer suposições sobre o formato do id.

Tipo da tarefa Retexture. O valor é retexture.

URL transferível para o ficheiro do modelo 3D texturizado gerado pela Meshy.

Este é o prompt de texto que foi utilizado para criar a tarefa de texturização.

Esta é a imagem de entrada que foi utilizada para criar a tarefa de texturização.

URLs transferíveis para as imagens de referência em Multivista que foram utilizadas para criar a tarefa de texturização. Apenas presente quando a tarefa foi criada com multiview_image_urls.

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 gerada com sucesso; caso contrário, este campo é omitido.

Progress da tarefa. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0. Assim que a tarefa for bem-sucedida, 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 o resultado da tarefa expira, em milissegundos.

Carimbo de data/hora de quando a tarefa foi concluída, em milissegundos. Se a tarefa ainda não tiver sido 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).