Creative Lab — API Fidget Pixel

Foto de origem para o Meshy pixelizar. Atualmente suportamos os formatos .jpg, .jpeg, .png e .webp.

O formato é detetado através da descodificação dos dados da imagem, não a partir da extensão do ficheiro no URL — um URL sem extensão, ou que redirecione, funciona desde que os bytes sejam descodificados para um formato suportado. Os redirecionamentos HTTP são seguidos.

Existem duas formas de fornecer a imagem:

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

O que a foto mostra. Seleciona o estilo de pixelização, por isso escolha com atenção — os dois produzem resultados visivelmente diferentes. Valores disponíveis:

• person — o sujeito é uma pessoa (retrato ou corpo inteiro). Produz um sprite em pixel de estilo chibi do sujeito.
• other — qualquer outra coisa: animais de estimação, objetos, mascotes, logótipos, paisagens. Produz um ícone em pixel de estilo bead-art do sujeito.

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

O pedido era inaceitável. Causas comuns:

• Parâmetro em falta: image_url e type são ambos obrigatórios.
• Type inválido: type deve ser person ou other.
• Formato de imagem inválido: O image_url fornecido não corresponde a um formato suportado (.jpg, .jpeg, .png, .webp).
• Dimensões da imagem fora do intervalo: A imagem é demasiado pequena, excede o tamanho máximo de ficheiro, ou excede o número máximo de pixels.
• URL inacessível: Não foi possível transferir o image_url (404 ou timeout).
• Data URI inválido: A string base64 está mal formada.
• Conteúdo sinalizado: A imagem de entrada foi sinalizada pela moderation de NSFW.

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

Créditos insuficientes para realizar esta tarefa, ou a chave de API pertence a uma conta de plano gratuito.

A imagem de entrada foi sinalizada pela moderation de propriedade intelectual (Content flagged for intellectual property violation). Apenas as contas Enterprise com filtragem de propriedade intelectual ativada são bloqueadas; nada é cobrado.

Excedeu o seu limite de taxa.

A verificação de propriedade intelectual em si não pôde ser concluída (Unable to perform intellectual property check, please try again). As contas Enterprise com filtragem de propriedade intelectual ativada falham de forma fechada nesta verificação; nada é cobrado — repita o pedido.

O ID da tarefa de um protótipo criado através deste mesmo endpoint OpenAPI. O protótipo deve ter sido criado pela mesma conta Meshy e deve ter atingido SUCCEEDED.

Tarefas de protótipo criadas através da webapp não são aceites — o endpoint de build aceita apenas tarefas de protótipo produzidas por POST /openapi/creative-lab/fidget-pixel/v1/prototype e recusa qualquer outra origem com 404.

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

Forma de base de cada peça. Valores disponíveis:

• square (predefinição) — peças quadradas numa grelha quadrada.
• hex — peças hexagonais numa grelha hexagonal. As peças hex estão disponíveis apenas em 6 e 8 mm.

Número de peças ao longo de cada lado do tabuleiro. Valores disponíveis: 16 ou 32. Uma grelha 32 mantém mais detalhe; uma grelha 16 significa peças menos numerosas e maiores para o mesmo assunto.

Comprimento da aresta de cada peça, em milímetros. Valores disponíveis: 6, 8, ou 10. Em conjunto com grid_size, isto define o tamanho do tabuleiro impresso — por exemplo, 32 × 8 mm ≈ 26 cm por lado. O valor 10 não está disponível para shape: "hex" (a face hexagonal inclinada causa saliências na maioria das impressoras FDM de consumo).

Número máximo de cores na paleta para a qual a imagem é quantizada. Intervalo: [1, 8]. Cada cor torna-se um filamento no seu software de corte.

Altura de cada peça, em milímetros. Intervalo: [10, 80].

Artefacto devolvido pelo build. Valores disponíveis:

• 3mf (predefinição) — devolve um único model.3mf em model_urls.3mf, com um objeto por peça e a cor da peça associada a cada objeto.

O pedido foi inaceitável. Causas comuns:

• Parâmetro em falta: input_task_id é obrigatório.
• UUID inválido: input_task_id não é um UUID válido.
• Parente não bem-sucedido: 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 de pixel art; crie um novo protótipo.
• Opções fora do intervalo: Um dos campos de options está fora do conjunto ou intervalo permitido — por exemplo options.grid_size must be 16 or 32, ou options.piece_size_mm=10 is not supported for shape=hex; hex pieces are available in 6 and 8 mm.
• Formato não suportado: output.format deve ser 3mf.

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

Créditos insuficientes para realizar esta tarefa, ou a chave de API pertence a uma conta de plano gratuito.

A imagem do protótipo referenciado foi sinalizada pela moderation de propriedade intelectual. Apenas contas Enterprise com filtragem de propriedade intelectual ativada são bloqueadas; nada é cobrado.

A tarefa de protótipo referenciada não existe, pertence a outro utilizador, ou foi criada através da webapp (apenas tarefas de protótipo em modo API se encadeiam com o build).

Excedeu o seu limite de taxa.

Não foi possível estabelecer o veredito de propriedade intelectual do protótipo referenciado (Unable to perform intellectual property check, please try again). Contas Enterprise com filtragem de propriedade intelectual ativada falham de forma fechada nesta verificação; nada é cobrado — tente novamente o pedido.

Identificador único da tarefa fidget pixel a obter.

id não é um UUID válido (Invalid ID).

A imagem da tarefa foi sinalizada pela moderação de propriedade intelectual. Apenas as contas Enterprise com a filtragem de propriedade intelectual ativada são bloqueadas.

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

Não foi possível concluir a verificação de propriedade intelectual (Unable to perform intellectual property check, please try again); as contas Enterprise com a filtragem de propriedade intelectual ativada falham de forma bloqueante. Tente novamente o pedido.

Identificador único da tarefa fidget pixel a cancelar.

O pedido foi considerado inaceitável. Causas comuns:

• ID inválido: id não é um UUID válido.
• Estado terminal: A tarefa já está SUCCEEDED, FAILED ou CANCELED 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 fidget pixel a transmitir.

prototype ou build. A coleção devolve apenas as tarefas cuja fase corresponde ao URL — pedir /prototype nunca devolve tarefas de build e vice-versa.

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. Embora usemos um UUID 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. O valor é creative-lab-fidget-pixel-prototype.

O nome da tarefa fornecido no momento da criação da tarefa. Cadeia vazia caso não tenha sido fornecido nenhum nome.

Estado da tarefa. Os valores possíveis são 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, este valor passará a ser 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 começado, 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 — 3 dias após a conclusão da tarefa. As contas empresariais mantêm os resultados da API indefinidamente (ver Retenção de recursos); para essas contas, este carimbo de data/hora é definido para cerca de 100 anos no futuro.

A contagem de tarefas precedentes.

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. Uma tarefa que atinge SUCCEEDED é cobrada com o valor total correspondente à sua etapa. Uma tarefa que nunca chega a ser criada (um 4xx no momento do pedido, incluindo uma rejeição por moderation) não é cobrada de todo. Uma tarefa que atinge FAILED retorna 0 — o valor cobrado é reembolsado. Cancelar através de DELETE só reembolsa enquanto a tarefa ainda estiver PENDING; uma tarefa já IN_PROGRESS mantém-se cobrada, pois o trabalho já foi realizado.

URLs transferíveis para a imagem em pixel art gerada por esta tarefa de protótipo. Atualmente, a API devolve sempre exatamente uma imagem; o campo é um array para que revisões futuras possam apresentar múltiplos candidatos sem uma alteração disruptiva. Vazio até a tarefa atingir SUCCEEDED.

Estes são URLs assinados: obtenha-os sem um cabeçalho Authorization. Mantêm-se válidos até expires_at, que corresponde a 3 dias após finished_at, e voltar a ler a tarefa dentro desse período devolve o URL idêntico em vez de um novo URL assinado. Transfira e guarde os ficheiros por conta própria antes disso — não há forma de renovar uma ligação expirada.

Identificador único da tarefa.

Tipo da tarefa. O valor é creative-lab-fidget-pixel-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, este valor passará a ser 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. null até a tarefa começar.

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

Carimbo de data/hora de quando o resultado da tarefa expira, em milissegundos — 3 dias após a conclusão da tarefa. As contas Enterprise mantêm os resultados da API indefinidamente (ver Retenção de Recursos); para essas contas, este carimbo de data/hora é definido para cerca de 100 anos no futuro.

A contagem de tarefas precedentes. Significativo apenas quando o estado é PENDING.

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. Uma tarefa que atinge SUCCEEDED é cobrada com o valor total correspondente à sua fase. Uma tarefa que nunca chega a ser criada (um 4xx no momento do pedido, incluindo uma rejeição por moderation) não é cobrada de todo. Uma tarefa que atinge FAILED devolve 0 — o valor cobrado é reembolsado. Cancelar através de DELETE só reembolsa enquanto a tarefa ainda estiver PENDING; uma tarefa já IN_PROGRESS mantém-se cobrada, porque o trabalho já foi despendido.

URLs para transferência do artefacto gerado, indexados por formato. Contém exatamente uma entrada — o formato solicitado através de output.format no pedido de build. Vazio até a tarefa atingir SUCCEEDED.

Estes são URLs assinados: obtenha-os sem um cabeçalho Authorization. Permanecem válidos até expires_at, que corresponde a 3 dias após finished_at, e voltar a ler a tarefa dentro desse período devolve o mesmo URL em vez de um novo assinado. Transfira e guarde os ficheiros por conta própria antes disso — não há forma de renovar uma ligação expirada.