API Creative Lab íman de frigorífico

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

A imagem tem de ser um ficheiro JPG, JPEG, PNG ou WebP de, no máximo, 20 MB.

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

Se deve remover o fundo da imagem de prototype. true devolve um PNG RGBA transparente que mantém o íman inteiro, para que o possa colocar sobre qualquer fundo. O build também parte da imagem sem o fundo. Se a Meshy não conseguir remover o fundo, devolve a imagem com o fundo, e a tarefa continua a ser bem-sucedida.

A opção remove_background do build é independente.

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

• image_url está em falta.
• 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 píxeis.
• A Meshy não consegue transferir a imagem, por exemplo porque o URL devolve 404 ou expira o tempo limite.
• O data URI não é um base64 válido.
• A imagem foi assinalada como NSFW.

A mensagem de erro indica qual foi 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 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 respetivo limite de créditos.
• A conta está no plano gratuito.

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

A sua equipa tem a opção IP Filtering ativada, e a 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 permitido pelo seu limite de taxa. 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 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 novamente o pedido.

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

Um ID que não corresponda a uma das suas tarefas de protótipo de Íman de Frigorífico da API devolve 404, incluindo um protótipo criado na aplicação web.

Um nome para a tarefa, com um máximo de 100 carateres. É devolvido no campo name da tarefa. Um nome mais longo devolve 400.

O contorno do íman quando a Meshy não o traça a partir do sujeito. A Meshy usa-o quando remove_background é false, ou quando não consegue encontrar o contorno do sujeito.

Valores disponíveis:

• circle
• rounded-rect
• hexagon
• shield
• star

O comprimento da aresta do quadrado delimitador do íman, em milímetros, até 400. 0 usa o valor predefinido.

A altura máxima do relevo acima da base, em milímetros, de 0 a 20.

Quanto baixar o relevo, em milímetros, de 0 a 20. A Meshy subtrai este valor à altura do relevo em todos os pontos, até à base.

A espessura da placa de base plana por trás do relevo, em milímetros, de 0 a 20. A base predefinida de 2 mm dá ao íman corpo suficiente para aderir ao frigorífico, para que o relevo não pareça frágil.

Se deve fechar a parte de trás do íman, o lado onde se cola o íman. false deixa a parte de trás aberta, como uma casca.

A curva que mapeia os valores do mapa de profundidade para a altura do relevo.

Valores disponíveis:

• linear
• gamma
• s-curve

A intensidade da curva, até 10. As curvas gamma e s-curve usam-na, e linear ignora-a. 0 usa o valor predefinido.

Se deve inverter o mapa de profundidade, para que as áreas mais escuras se tornem relevo mais elevado.

Quanto suavizar o mapa de profundidade antes de a Meshy criar o relevo, de 0 a 10.

Quanto ampliar o relevo e a sua textura dentro do contorno, em torno do centro, até 10. Um valor superior a 1 amplia o sujeito, e um valor inferior a 1 reduz-o. Não altera a altura do relevo. 0 usa o valor predefinido.

O valor do mapa de profundidade abaixo do qual a Meshy define a profundidade como zero, de 0 a 1.

Se deve traçar o contorno do íman a partir do sujeito, para que o íman siga a forma do sujeito. false usa antes o contorno badge_shape. A Meshy também usa badge_shape quando não consegue encontrar o contorno do sujeito.

Isto é independente do parâmetro remove_background do protótipo, que define se a imagem do protótipo tem um fundo transparente.

A resolução de malha do modelo exportado, de 64 a 512. A Meshy constrói a geometria a partir de um mapa de profundidade de 512 píxeis, pelo que uma malha mais fina acrescentaria faces sem acrescentar detalhe. 0 usa o valor predefinido.

O formato de ficheiro devolvido pela criação.

Valores disponíveis:

• glb: um ficheiro model.glb, em model_urls.glb
• obj: um ficheiro zip com model.obj, model.mtl e texture.png, em model_urls.obj
• zip: um ficheiro zip com todos os ficheiros gerados pela Meshy, em model_urls.bundle_zip

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 do seu intervalo ou não é um valor disponível.

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 plano, depois tente novamente.

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

Um dos seguintes limites foi atingido:

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

O ID da tarefa proveniente 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 prototype por propriedade intelectual de terceiros. As tarefas de build e as equipas no plano Enterprise não recebem este erro. Crie uma tarefa de prototype a partir de uma imagem sobre a qual tenha direitos de utilização.

Nenhuma tarefa de íman de frigorífico 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 destas 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 de íman de frigorífico com este ID pertence à sua conta, ou a etapa 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.

O estágio a listar, prototype ou build.

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

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

A ordem de ordenaçã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 de tarefa, sempre creative-lab-fridge-magnet-prototype.

O name que enviou ao criar 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. É 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.

O 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 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 de conceito. O array tem um URL depois de a tarefa ser bem-sucedida, e está vazio até lá.

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

O tipo da tarefa, sempre creative-lab-fridge-magnet-build.

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. É 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 começa a seguir. 0 depois de a tarefa sair da fila, e sempre 0 em resultados de listagem.

Porque 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 é 0, porque a Meshy reembolsa-a. O cancelamento só reembolsa uma tarefa enquanto esta está PENDING. Se a Meshy não conseguir ler a cobrança, uma resposta de get ou stream omite o campo, e um pedido de listagem devolve 500. Nesse caso, tente novamente o pedido.

URLs de transferência para o ficheiro de modelo, com uma entrada para o output.format que pediu. {} até a tarefa ser bem-sucedida.