API de Vinyl Figure do Creative Lab

A foto a ser transformada em uma vinyl figure de cabeça grande, como uma URL pública ou uma 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.

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

Se o plano de fundo deve ser removido da imagem do protótipo. true retorna um PNG RGBA transparente, para que você possa colocar o sujeito em qualquer plano de fundo. O build também começa a partir da imagem sem seu plano de fundo. Se o Meshy não conseguir remover o plano de fundo, ele retorna a imagem com seu plano de fundo, e a tarefa ainda é bem-sucedida.

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

• image_url está ausente.
• 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.
• O Meshy não consegue baixar a imagem, por exemplo porque a URL retorna 404 ou expira o tempo limite.
• A data URI não é um base64 válido.
• A imagem foi sinalizada como NSFW.

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

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

Um dos seguintes casos se aplica:

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

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

Sua equipe tem a opção IP Filtering ativada, e o Meshy sinalizou a imagem por propriedade intelectual de terceiros. Envie uma imagem que você tenha o direito de usar.

Um destes limites foi atingido:

• Você enviou mais requisições do que seu limite de taxa permite. Aguarde alguns segundos e tente novamente. Consulte Limites de taxa.
• Muitas das suas tarefas estão 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.

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 a requisição.

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

Um ID que não seja de uma das suas tarefas de protótipo de Vinyl Figure feitas pela API retorna 404, incluindo um protótipo criado 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 requisiçã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 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.

A mensagem de erro informa qual problema foi encontrado.

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

Um dos seguintes casos 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.

input_task_id não corresponde a nenhuma tarefa de protótipo de Vinyl Figure criada pela sua conta com a API. Um protótipo criado 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 requisições do que seu limite de taxa permite. Aguarde alguns segundos e tente novamente. Veja Limites de taxa.
• Muitas das suas tarefas estão 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.

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

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

Sua equipe está com a Filtragem de IP ativada, e a Meshy sinalizou a imagem da tarefa por propriedade intelectual de terceiros. Equipes no plano Enterprise não recebem esse erro. Crie uma tarefa de prototype a partir de uma imagem sobre a qual você tenha os direitos de uso.

Nenhuma tarefa de Vinyl Figure 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 para corresponder à 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.

Um dos seguintes 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 de Vinyl Figure 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 para corresponder à tarefa.

O ID da tarefa da 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-vinyl-figure-prototype.

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

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 que falha é 0, porque 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 lista retorna 500. Nesse caso, repita a requisição.

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

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

O tipo da tarefa, sempre creative-lab-vinyl-figure-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. 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. Veja Retenção de recursos.

A posição da tarefa na fila enquanto 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.

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 que falha é 0, porque 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.

Sempre "" para uma tarefa de build de Vinyl Figure.

Sempre "" para uma tarefa de build de Vinyl Figure, assim como prompt.

Sempre "" para uma tarefa de build de Vinyl Figure, assim como prompt.

Sempre "" para uma tarefa de build de Vinyl Figure, assim como prompt.

URLs de download para o modelo 3D, como um GLB texturizado e como um arquivo OBJ com seu arquivo MTL.

URL de download para uma imagem de pré-visualização do modelo.

Os mapas de textura, como um array com um objeto que contém o mapa de cor base.