API Creative Lab Fidget Pixel

A foto a ser transformada em pixel art, como uma URL pública ou um Data URI (data:image/jpeg;base64,<seus dados de imagem codificados em base64>).

A imagem deve ser um arquivo JPG, JPEG, PNG ou WebP de no máximo 20 MB. A Meshy detecta o formato a partir dos dados da imagem, não da extensão do arquivo na URL. Uma URL sem extensão funciona, e a Meshy segue redirecionamentos.

O que a foto mostra, o que define o estilo da pixel art. Os dois estilos têm uma aparência claramente diferente. Qualquer outro valor retorna 400.

Valores disponíveis:

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

Um nome para a tarefa, com até 100 caracteres. Ele é retornado no campo name da tarefa. Um nome mais longo retorna 400.

A solicitação não pode ser executada. Por exemplo:

• image_url ou type está ausente.
• type não é person nem other.
• A imagem não é um arquivo JPG, JPEG, PNG ou WebP.
• A imagem é muito pequena, excede 20 MB ou excede a contagem máxima de pixels.
• A Meshy não consegue baixar a imagem, por exemplo porque a URL retorna 404 ou expira por tempo limite.
• O Data URI não é um base64 válido.
• A imagem foi sinalizada como NSFW.

A mensagem de erro indica qual problema foi encontrado. Corrija a solicitação e envie-a novamente.

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

Uma destas situações se aplica:

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

Verifique seus créditos e seu plano e tente novamente.

Sua equipe está com a Filtragem de IP ativada, e a Meshy sinalizou a imagem por propriedade intelectual de terceiros. Envie uma imagem que você tenha os direitos de uso.

Um destes limites foi atingido:

• Você enviou mais solicitações do que o seu limite de taxa permite. Aguarde alguns segundos e tente novamente. Consulte Limites de taxa.
• Há muitas tarefas suas na fila ou em execução. Aguarde algumas terminarem e tente novamente.
• Em um plano ilimitado sem créditos restantes, você atingiu o número de tarefas que podem ser executadas sem créditos. Aguarde uma tarefa terminar ou adicione créditos.

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

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

Um ID que não corresponde a uma de suas tarefas de protótipo do Fidget Pixel criadas pela API retorna 404, incluindo um protótipo feito no aplicativo web.

Um nome para a tarefa, com até 100 caracteres. Ele retorna no campo name da tarefa. Um nome mais longo retorna 400.

A pegada (footprint) de cada peça. Qualquer outro valor retorna 400.

Valores disponíveis:

• square: peças quadradas em uma grade quadrada
• hex: peças hexagonais em uma grade hexagonal, com piece_size_mm definido como 6 ou 8

O número de células da grade ao longo de cada lado do tabuleiro, 16 ou 32. Qualquer outro valor retorna 400. Uma grade 32 mantém mais detalhes. Uma grade 16 gera menos peças do mesmo tamanho, então o tabuleiro fica com cerca de metade da largura.

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

10 não funciona com hex e retorna 400, porque a face inclinada do hexágono gera saliências (overhang) na maioria das impressoras FDM para consumidor.

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

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

O formato do arquivo do resultado. Qualquer outro valor retorna 400.

Valores disponíveis:

• 3mf: um único arquivo model.3mf multicolorido, retornado em model_urls.3mf

A solicitação não pode ser executada. Por exemplo:

• input_task_id está ausente ou não é um ID de tarefa válido.
• O status da tarefa de protótipo não é SUCCEEDED. Se ainda estiver em execução, aguarde e tente novamente. Se falhou ou foi 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. Peças hexagonais vêm apenas em 6 e 8 mm.
• output.format não é 3mf.

A mensagem de erro informa qual problema foi encontrado.

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

Uma destas situações se aplica:

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

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

Sua equipe 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 você tem os direitos de uso.

input_task_id não corresponde a nenhuma tarefa de protótipo do Fidget Pixel criada pela sua conta por meio da API. Um protótipo feito no aplicativo web também retorna 404. Envie o ID result de uma resposta de criação de protótipo.

Um destes limites foi atingido:

• Você enviou mais solicitações do que seu limite de taxa permite. Aguarde alguns segundos e tente novamente. Veja Limites de taxa.
• Há muitas tarefas suas na fila ou em execução. Aguarde algumas terminarem e tente novamente.
• Em um plano ilimitado sem créditos restantes, você atingiu o número de tarefas que podem ser executadas sem créditos. Aguarde uma tarefa terminar ou adicione créditos.

A Meshy encontrou um erro de servidor, por exemplo, porque não conseguiu 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 cobrados. Tente novamente a solicitação.

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

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

Sua equipe está com a Filtragem de IP ativada, e a Meshy sinalizou a imagem da tarefa de protótipo por propriedade intelectual de terceiros. Tarefas de build e equipes no plano Enterprise não recebem esse erro. Crie uma tarefa de protótipo a partir de uma imagem que você tem o direito de usar.

Nenhuma tarefa do Fidget Pixel com esse ID pertence à sua conta, ou o estágio da tarefa não corresponde ao caminho. Verifique o ID e use /prototype ou /build de acordo com a tarefa.

A Meshy não conseguiu executar a verificação de propriedade intelectual. Tente a solicitação novamente.

O ID da tarefa a ser cancelada.

Uma destas situações se aplica:

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

Nenhuma tarefa do Fidget Pixel com este ID pertence à sua conta, ou o estágio da tarefa não corresponde ao caminho. Verifique o ID e use /prototype ou /build para corresponder à tarefa.

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

O estágio a ser listado, prototype ou build.

A página a ser retornada, de 1 a 255. 0 retorna a primeira página. Um valor fora de 0 a 255 retorna 400.

Número de tarefas por página, até 100. Um valor de 101 a 255 retorna 100 tarefas, e 0 usa o padrão. Um valor fora de 0 a 255 retorna 400.

A ordem de classificação.

Valores disponíveis:

• -created_at: mais recentes primeiro
• +created_at: mais antigos primeiro

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

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

O name que você enviou ao criar a tarefa, ou "" se não enviou um.

O status da tarefa.

Valores disponíveis:

• PENDING: aguardando na fila
• IN_PROGRESS: gerando o resultado
• SUCCEEDED: finalizado, com o resultado
• FAILED: finalizado, com o motivo em task_error
• CANCELED: finalizado, sem resultado

Porcentagem do trabalho concluído, de 0 a 100. É 0 até a tarefa começar e 100 quando ela é 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é então.

Momento em que a tarefa atingiu um status final, em milissegundos Unix. null até então.

Momento 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 ela está PENDING. 1 significa que ela começa em seguida. 0 depois que a tarefa sai 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. Uma requisição que retorna um erro não é cobrada. Uma tarefa que falha é 0, pois a Meshy a reembolsa. Cancelar reembolsa uma tarefa apenas enquanto ela está PENDING. Se a Meshy não conseguir ler a cobrança, uma resposta de get ou stream deixa o campo de fora, e uma requisição de listagem retorna 500. Nesse caso, tente a requisição novamente.

URLs de download para a imagem em pixel art. O array tem uma URL depois que a tarefa é bem-sucedida, e fica vazio até então.

As URLs são assinadas, então busque-as sem um cabeçalho Authorization. Elas permanecem válidas até expires_at. Buscar a tarefa novamente antes disso retorna as mesmas URLs, não URLs recém-assinadas. Uma URL expirada não pode ser renovada, então baixe e armazene os arquivos antes disso.

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

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

O name que você enviou ao criar a tarefa, ou "" se você não enviou um.

O status da tarefa.

Valores disponíveis:

• PENDING: aguardando na fila
• IN_PROGRESS: gerando o resultado
• SUCCEEDED: final, com o resultado
• FAILED: final, com o motivo em task_error
• CANCELED: final, sem resultado

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

Horário em que a tarefa foi criada, em milissegundos Unix.

Horário em que um worker iniciou a tarefa, em milissegundos Unix. null até então.

Horário em que a tarefa atingiu um status final, em milissegundos Unix. null até então.

Horário 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. Veja Retenção de recursos.

A posição da tarefa na fila enquanto ela está PENDING. 1 significa que ela começa em seguida. 0 depois que a tarefa sai da fila, e sempre 0 em resultados de lista.

Por que a tarefa falhou. null a menos que status seja FAILED. Veja Erros.

Número de créditos cobrados pela tarefa, após qualquer reembolso. Uma requisição que retorna um erro não é cobrada. Uma tarefa com falha é 0, pois a Meshy a reembolsa. Cancelar só reembolsa uma tarefa enquanto ela está PENDING. Se a Meshy não conseguir ler a cobrança, uma resposta de get ou stream omite o campo, e uma requisição de lista retorna 500. Nesse caso, tente a requisição novamente.

URLs de download para o resultado, indexadas pelo formato de arquivo. O objeto tem uma entrada, para o output.format que você enviou, e fica vazio até a tarefa ser bem-sucedida.

As URLs são assinadas, então busque-as sem um cabeçalho Authorization. Elas permanecem válidas até expires_at. Obter a tarefa novamente antes disso retorna as mesmas URLs, não URLs recém-assinadas. Uma URL expirada não pode ser renovada, então baixe e armazene os arquivos antes disso.