Creative Lab — API Brick Figure

Foto de origem para a Meshy estilizar como uma minifigura de blocos. Atualmente suportamos os formatos .jpg, .jpeg, .png e .webp.

Existem duas formas de fornecer a imagem:

• URL publicamente acessível: Um URL que é 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>.

Nome de tarefa opcional para fins de exibição. Máximo de 100 carateres.

Quando definido como true, a imagem de protótipo é devolvida como um PNG RGBA transparente com o fundo removido, permitindo-lhe compor o sujeito sobre qualquer fundo.

O pedido foi inaceitável. Causas comuns:

• Parâmetro em falta: image_url é obrigatório.
• Formato de imagem inválido: O image_url fornecido não está num formato suportado (.jpg, .jpeg, .png, .webp).
• Dimensões da imagem fora do intervalo: A imagem é demasiado pequena, excede o tamanho máximo do ficheiro ou excede o número máximo de píxeis.
• URL inacessível: Não foi possível transferir o image_url (404 ou timeout).
• Data URI inválido: A string em base64 está malformada.
• Conteúdo assinalado: A imagem de entrada foi assinalada pela moderation de conteúdo NSFW.

A autenticação falhou. Por favor, verifique a sua chave de API.

Créditos insuficientes para realizar esta tarefa.

A imagem de entrada foi assinalada por violação de propriedade intelectual.

Excedeu o seu limite de taxa.

O ID da tarefa de um protótipo criado através deste mesmo endpoint OpenAPI. O protótipo tem de ter sido criado com a mesma chave de API, tem de ter atingido SUCCEEDED e tem de ter produzido exatamente uma imagem candidata.

Tarefas de protótipo criadas através da aplicação web não são aceites — o endpoint de construção aceita apenas tarefas de protótipo produzidas por POST /openapi/creative-lab/brick-figure/v1/prototype e recusa qualquer outra origem com 404.

Nome de tarefa opcional para fins de exibição. Máximo de 100 caracteres.

O pedido não foi aceite. Causas comuns:

• Parâmetro em falta: input_task_id é obrigatório.
• UUID inválido: O input_task_id não é um UUID válido.
• Parente não concluído com sucesso: A tarefa de protótipo referenciada ainda não atingiu SUCCEEDED.
• Sem candidato: A tarefa de protótipo foi bem-sucedida mas não produziu nenhuma imagem candidata.

A autenticação falhou. Verifique a sua chave de API.

Créditos insuficientes para realizar esta tarefa.

A tarefa de protótipo referenciada não existe, pertence a um utilizador diferente, ou foi criada através da aplicação web (apenas tarefas de protótipo em modo API se encadeiam na construção).

Excedeu o seu limite de taxa.

Identificador único da tarefa de figura de peças a obter.

Identificador único da tarefa de brick figure a cancelar.

A tarefa já se encontra num estado terminal e não pode ser cancelada.

A tarefa não existe, pertence a um utilizador diferente, ou a sua fase não corresponde ao caminho do URL.

Identificador único da tarefa de brick figure a transmitir em stream.

prototype ou build. A coleção devolve apenas tarefas cujo estágio corresponda ao URL — obter /prototype nunca devolve tarefas de build e vice-versa.

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 por hora de criação em ordem ascendente.
• -created_at: Ordenar por hora de criação em ordem descendente.

Identificador único para a tarefa. Embora utilizemos um UUID ordenável por k como detalhe de implementação para os ids das tarefas, não deve fazer quaisquer suposições sobre o formato do id.

Tipo da tarefa. O valor é creative-lab-brick-figure-prototype.

O nome da tarefa fornecido quando a tarefa foi criada. String vazia se não tiver sido fornecido nenhum nome.

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

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

Carimbo de data/hora de quando a tarefa foi criada, em milissegundos.

Carimbo de data/hora de quando a tarefa foi iniciada, em milissegundos. Se a tarefa ainda não tiver sido iniciada, esta propriedade será null.

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á null.

Carimbo de data/hora de quando o resultado da tarefa expira, em milissegundos.

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

URLs transferíveis para os candidatos a imagem de conceito gerados por esta tarefa de protótipo. Atualmente a API devolve sempre exatamente um candidato; o campo é um array para que revisões futuras possam apresentar vários candidatos sem uma alteração disruptiva.

Identificador único da tarefa.

Tipo da tarefa. O valor é creative-lab-brick-figure-build.

O nome da tarefa fornecido quando a tarefa foi criada. Cadeia vazia se não tiver sido fornecido nenhum nome.

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

Progresso da tarefa. Se a tarefa ainda não tiver começado, esta propriedade será 0. Assim que a tarefa for bem-sucedida, passará a 100.

Carimbo de data/hora de quando a tarefa foi criada, em milissegundos.

Carimbo de data/hora de quando a tarefa foi iniciada, em milissegundos.

Carimbo de data/hora de quando a tarefa foi concluída, em milissegundos.

Carimbo de data/hora de quando o resultado da tarefa expira, em milissegundos.

A contagem de tarefas precedentes. Apenas relevante quando o estado é PENDING.

Detalhes do 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. Devolve 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).

Sempre vazio para brick figure build. Presente para compatibilidade entre endpoints com a estrutura partilhada V2ImageTo3DTaskResponse utilizada por Imagem para 3D.

Sempre vazio para brick figure build. Presente para compatibilidade entre endpoints.

Sempre vazio para brick figure build. Presente para compatibilidade entre endpoints.

Sempre vazio para brick figure build. Presente para compatibilidade entre endpoints.

URLs descarregáveis para o modelo 3D gerado. O brick figure build produz um GLB texturizado, além do par OBJ + MTL para pipelines que preferem o Wavefront OBJ. A estrutura do campo corresponde ao objeto model_urls do Imagem para 3D, pelo que futuras adições de formatos se integram sem alterações disruptivas.

URL descarregável para a imagem em miniatura do ficheiro do modelo.

Uma matriz de objetos de URL de textura gerados por esta tarefa. Atualmente contém um único objeto com o mapa de cor base.