API Creative Lab Fidget Pixel

A fotografia a transformar em pixel art, como um URL público ou um data URI (data:image/jpeg;base64,<os seus dados de imagem codificados em base64>).

A imagem deve ser um ficheiro JPG, JPEG, PNG ou WebP com, no máximo, 20 MB. O Meshy deteta o formato a partir dos dados da imagem, não da extensão do ficheiro no URL. Um URL sem extensão funciona, e o Meshy segue redirecionamentos.

O que a fotografia mostra, o que define o estilo da pixel art. Os dois estilos são claramente diferentes. Qualquer outro valor devolve 400.

Valores disponíveis:

• person: uma pessoa, num retrato ou numa fotografia de corpo inteiro. O Meshy desenha um sprite em pixel art no estilo chibi.
• other: qualquer outro assunto, por exemplo um animal de estimação, um objeto, uma mascote, um logótipo ou uma paisagem. O Meshy desenha um ícone em pixel art no estilo bead-art.

Um nome para a tarefa, até 100 carateres. É devolvido no campo name da tarefa. Um nome mais longo devolve 400.

O pedido não pode ser executado. Por exemplo:

• image_url ou type está em falta.
• type não é person nem other.
• A imagem não é um ficheiro JPG, JPEG, PNG ou WebP.
• A imagem é demasiado pequena, excede 20 MB ou excede o número máximo de pixéis.
• O Meshy não consegue transferir a imagem, por exemplo porque o URL devolve 404 ou atinge o tempo limite.
• O data URI não é um base64 válido.
• A imagem foi assinalada como NSFW.

A mensagem de erro indica qual o problema encontrado. Corrija o pedido e envie-o novamente.

A chave de API está em falta ou é inválida. Verifique o cabeçalho Authorization.

Aplica-se uma destas situações:

• A conta não tem créditos suficientes.
• A chave de API, o espaço de trabalho ou o membro atingiu o seu limite de créditos.
• A conta está no plano gratuito.

Verifique os seus créditos e plano, depois tente novamente.

A sua equipa tem a Filtragem de IP ativada, e o Meshy assinalou a imagem por propriedade intelectual de terceiros. Envie uma imagem que tenha o direito de utilizar.

Um destes limites foi atingido:

• Enviou mais pedidos do que o seu limite de taxa permite. Aguarde alguns segundos e tente novamente. Consulte Limites de taxa.
• Tem demasiadas tarefas em fila de espera ou em execução. Aguarde que algumas terminem e tente novamente.
• Num plano ilimitado sem créditos restantes, atingiu o número de tarefas que podem ser executadas sem créditos. Aguarde que uma tarefa termine ou adicione créditos.

O Meshy encontrou um erro de servidor, por exemplo porque não conseguiu executar a verificação de propriedade intelectual na imagem. O Meshy não cria a tarefa e reembolsa quaisquer créditos cobrados. Tente novamente o pedido.

O ID da tarefa de protótipo a construir. Tem de ser uma tarefa criada pela sua conta com POST /openapi/creative-lab/fidget-pixel/v1/prototype, com o estado SUCCEEDED.

Um ID que não corresponda a uma das suas tarefas de protótipo Fidget Pixel da API devolve 404, incluindo um protótipo feito na aplicação web.

Um nome para a tarefa, com até 100 carateres. É devolvido no campo name da tarefa. Um nome mais longo devolve 400.

O contorno de cada peça. Qualquer outro valor devolve 400.

Valores disponíveis:

• square: peças quadradas numa grelha quadrada
• hex: peças hexagonais numa grelha hexagonal, com piece_size_mm definido como 6 ou 8

O número de células da grelha ao longo de cada lado do tabuleiro, 16 ou 32. Qualquer outro valor devolve 400. Uma grelha de 32 mantém mais detalhe. Uma grelha de 16 produz menos peças do mesmo tamanho, pelo que o tabuleiro fica cerca de metade da largura.

O comprimento da aresta de cada peça em milímetros, 6, 8 ou 10. Qualquer outro valor devolve 400. Em conjunto com grid_size, define o tamanho do tabuleiro impresso. Por exemplo, uma grelha de 32 com peças de 8 mm tem cerca de 26,5 cm por lado.

O valor 10 não funciona com hex e devolve 400, porque a face hexagonal inclinada faz saliência na maioria das impressoras FDM de consumo.

O número máximo de cores na paleta de pixel art, de 1 a 8. Um valor fora do intervalo devolve 400. Para imprimir, precisa de até color_count mais um filamentos, um por cor e um para os corpos cinzentos.

A altura de cada peça em milímetros, de 10 a 80. Um valor fora do intervalo devolve 400.

O formato de ficheiro do resultado. Qualquer outro valor devolve 400.

Valores disponíveis:

• 3mf: um único ficheiro multicor model.3mf, devolvido em model_urls.3mf

O pedido não pode ser executado. Por exemplo:

• input_task_id está em falta ou não é um ID de tarefa válido.
• O estado da tarefa de protótipo não é SUCCEEDED. Se ainda estiver em execução, aguarde e tente novamente. Se tiver falhado ou sido cancelada, crie uma nova tarefa de protótipo.
• A tarefa de protótipo foi bem-sucedida, mas não tem imagem. Crie uma nova tarefa de protótipo.
• Um campo de options está fora dos valores permitidos, por exemplo um grid_size diferente de 16 ou 32.
• piece_size_mm é 10 e shape é hex. As peças hexagonais só existem em 6 e 8 mm.
• output.format não é 3mf.

A mensagem de erro indica qual o problema encontrado.

A chave de API está em falta ou é inválida. Verifique o cabeçalho Authorization.

Aplica-se uma das seguintes situações:

• A conta não tem créditos suficientes.
• A chave de API, o espaço de trabalho ou o membro atingiu o seu limite de créditos.
• A conta está no plano gratuito.

Verifique os seus créditos e o plano, e tente novamente.

A sua equipa tem a Filtragem de IP ativada, e a Meshy sinalizou a imagem da tarefa de protótipo por propriedade intelectual de terceiros. Crie uma tarefa de protótipo a partir de uma imagem sobre a qual tenha direitos de utilização.

input_task_id não corresponde a nenhuma tarefa de protótipo Fidget Pixel criada pela sua conta através da API. Um protótipo feito na aplicação web também devolve 404. Envie o ID result de uma resposta de criação de protótipo.

Foi atingido um dos seguintes limites:

• Enviou mais pedidos do que o seu limite de taxa permite. Aguarde alguns segundos e tente novamente. Consulte Limites de taxa.
• Demasiadas das suas tarefas estão em fila de espera ou em execução. Aguarde que algumas terminem e tente novamente.
• Num plano ilimitado sem créditos restantes, atingiu o número de tarefas que podem ser executadas sem créditos. Aguarde que uma tarefa termine, ou adicione créditos.

A Meshy encontrou um erro de servidor, por exemplo por não ter conseguido executar a verificação de propriedade intelectual na imagem da tarefa de protótipo. A Meshy não cria a tarefa e reembolsa quaisquer créditos que tenha cobrado. Tente o pedido novamente.

O ID da tarefa da resposta de criação.

id não é um ID de tarefa válido. Envie o ID result da resposta de criação.

A sua equipa tem a opção IP Filtering ativada, e a Meshy sinalizou a imagem da tarefa de protótipo por direitos de propriedade intelectual de terceiros. As tarefas de construção e as equipas no plano Enterprise não recebem este erro. Crie uma tarefa de protótipo a partir de uma imagem para a qual tenha os direitos de utilização.

Nenhuma tarefa Fidget Pixel com este ID pertence à sua conta, ou a fase da tarefa não corresponde ao caminho. Verifique o ID e utilize /prototype ou /build para corresponder à tarefa.

A Meshy não conseguiu executar a verificação de propriedade intelectual. Repita o pedido.

O ID da tarefa a cancelar.

Aplica-se uma das seguintes situações:

• id não é um ID de tarefa válido. Envie o ID result da resposta de criação.
• A tarefa já tem um estado final (SUCCEEDED, FAILED ou CANCELED), pelo que não pode ser cancelada.

Nenhuma tarefa Fidget Pixel com este ID pertence à sua conta, ou a fase da tarefa não corresponde ao caminho. Verifique o ID e utilize /prototype ou /build para corresponder à tarefa.

O ID da tarefa proveniente da resposta de criação.

A fase a listar, prototype ou build.

A página a devolver, de 1 a 255. 0 devolve a primeira página. Um valor fora do intervalo 0 a 255 devolve 400.

Número de tarefas por página, até 100. Um valor entre 101 e 255 devolve 100 tarefas, e 0 utiliza o valor predefinido. Um valor fora do intervalo 0 a 255 devolve 400.

A ordem de ordenação.

Valores disponíveis:

• -created_at: mais recente primeiro
• +created_at: mais antigo primeiro

O ID da tarefa. Não dependa do seu formato.

O tipo da tarefa, sempre creative-lab-fidget-pixel-prototype.

O name que enviou quando criou a tarefa, ou "" se não tiver enviado nenhum.

O estado da tarefa.

Valores disponíveis:

• PENDING: a aguardar na fila
• IN_PROGRESS: a gerar o resultado
• SUCCEEDED: final, com o resultado
• FAILED: final, com o motivo em task_error
• CANCELED: final, sem resultado

Percentagem do trabalho concluído, de 0 a 100. É 0 até a tarefa começar e 100 quando é bem-sucedida.

Momento em que a tarefa foi criada, em milissegundos Unix.

Momento em que um worker iniciou a tarefa, em milissegundos Unix. null até isso acontecer.

Momento em que a tarefa atingiu um estado final, em milissegundos Unix. null até isso acontecer.

Momento em que o resultado da tarefa expira, em milissegundos Unix. São 3 dias após finished_at, ou 3 dias após created_at até a tarefa terminar. Para contas Enterprise, que mantêm os resultados da API indefinidamente, é cerca de 100 anos depois. Consulte Retenção de recursos.

A posição da tarefa na fila enquanto está PENDING. 1 significa que é a próxima a começar. 0 depois de a tarefa sair da fila, e sempre 0 em resultados de listagem.

Motivo pelo qual a tarefa falhou. null a menos que status seja FAILED. Consulte Erros.

Número de créditos cobrados pela tarefa, após qualquer reembolso. Um pedido que devolve um erro não é cobrado. Uma tarefa falhada tem o valor 0, porque a Meshy a reembolsa. Cancelar só reembolsa uma tarefa enquanto esta estiver PENDING. Se a Meshy não conseguir ler a cobrança, uma resposta de obtenção ou de stream omite o campo, e um pedido de listagem devolve 500. Nesse caso, repita o pedido.

URLs de transferência para a imagem em pixel art. A matriz tem um URL depois de a tarefa ser bem-sucedida, e está vazia até lá.

Os URLs são assinados, por isso obtenha-os sem um cabeçalho Authorization. Mantêm-se válidos até expires_at. Obter a tarefa novamente antes disso devolve os mesmos URLs, não novos assinados. Um URL expirado não pode ser renovado, por isso transfira e guarde os ficheiros antes disso.

O ID da tarefa. Não dependa do seu formato.

O tipo de tarefa, sempre creative-lab-fidget-pixel-build.

O name que enviou ao criar a tarefa, ou "" caso não tenha enviado nenhum.

O estado da tarefa.

Valores disponíveis:

• PENDING: em espera na fila
• IN_PROGRESS: a gerar o resultado
• SUCCEEDED: final, com o resultado
• FAILED: final, com o motivo em task_error
• CANCELED: final, sem resultado

Percentagem do trabalho concluído, de 0 a 100. É 0 até a tarefa começar e 100 quando é bem-sucedida.

Hora em que a tarefa foi criada, em milissegundos Unix.

Hora em que um worker iniciou a tarefa, em milissegundos Unix. null até isso acontecer.

Hora em que a tarefa atingiu um estado final, em milissegundos Unix. null até isso acontecer.

Hora em que o resultado da tarefa expira, em milissegundos Unix. É 3 dias após finished_at, ou 3 dias após created_at até a tarefa terminar. Para contas Enterprise, que mantêm os resultados da API indefinidamente, é cerca de 100 anos depois. Consulte Retenção de recursos.

A posição da tarefa na fila enquanto está PENDING. 1 significa que é a próxima a começar. 0 depois de a tarefa sair da fila, e sempre 0 em resultados de listagem.

Motivo pelo qual a tarefa falhou. null a menos que status seja FAILED. Consulte Erros.

Número de créditos cobrados pela tarefa, após qualquer reembolso. Um pedido que devolva um erro não é cobrado. Uma tarefa falhada é 0, porque a Meshy reembolsa-a. Cancelar só reembolsa uma tarefa enquanto esta estiver PENDING. Se a Meshy não conseguir ler a cobrança, uma resposta de obtenção ou de stream omite o campo, e um pedido de listagem devolve 500. Nesse caso, repita o pedido.

URLs de transferência para o resultado, indexados por formato de ficheiro. O objeto tem uma entrada, para o output.format que enviou, e está vazio até a tarefa ser bem-sucedida.

As URLs são assinadas, por isso obtenha-as sem um cabeçalho Authorization. Permanecem válidas até expires_at. Obter a tarefa novamente antes disso devolve as mesmas URLs, não umas recém-assinadas. Uma URL expirada não pode ser renovada, por isso transfira e guarde os ficheiros antes disso.